Field blocks

Use a Field block to ask one question and collect an answer while someone completes a Guide. The block holds the prompt and one or more answer methods. When several methods are available, the player chooses how to answer.

Add a Field block

1. Open the Guide in the editor and select Add block on the page.
2. Choose Field to start without an answer method, or choose a named Field preset to start with one configured method.
3. In Prompt, enter a Name that helps authors identify the block in the editor. The Name is not the default label in reports. Write the player-facing question under Field prompt; this is also the default report label.
4. Set Response requirement to Optional or Required. In a live Guide, a required Field must receive a valid answer through one of its active methods before the player can continue from that page.
5. Under Answer methods, select an active method to configure it, or use Add method to add an available method type.
6. Select Save block to apply the draft, then test the page in Guide preview. Clicking outside the dialog does not close it.

A raw Field starts with no answer methods. Add and configure one before preview or play.

Manage answer methods

Available methods include Type, Options, Order, Number, Photo, Completion, Audio Recording, Signature, and Whiteboard. Methods already listed in the editor are active. Add method only offers method types not currently present.

For numeric answers, add Number and choose Text field or Slider from its Input style dropdown. Existing Scale answers remain playable, but Scale is no longer offered as a separate method in the editor.

On desktop, select methods from the editor sidebar. On mobile, use the touch-friendly method tabs. Drag a method by its reorder handle to change its position. Open a method to duplicate it or remove it; removal requires confirmation.

Every answer-method tab ends with a Presentation section. Use it to set the method’s player-facing Display name, optional Supporting text, and optional image. These details identify the method in the answer chooser, so use short, distinct names and descriptions. If supporting text is blank, CareMap shows an automatic description of the method.

In the Field settings, set Answer method layout to Compact rows for a dense chooser or Large square tiles for an image-forward grid. Large tiles crop each method image to fill a square tile, similar to the Options answer layout. This layout only appears in the player when the Field has two or more active answer methods.

Each method has its own setup. Advanced settings appear only where supported and can include validation, reports, evidence, and after-submit behavior. For option setup, see Options answers. For an ordered drag answer, see Order answers.

To give feedback before continuing, choose Positive splash, Negative splash, or Neutral splash under After a successful submit, then choose one action under Then. Leave Then at None for splash only. With a follow-up, the splash starts when the answer is accepted and the action uses Outcome timing. An explicit zero can continue immediately without waiting for the animation. Disabled or reduced-motion effects never block continuation. Finish guide keeps its normal message reading time. Changing an answer or navigating away cancels a pending follow-up; failed saves do not trigger it.

Link the Field

Open Linking to connect compatible answers to a field in the Guide’s target Form. Form mapping requires a target Form in Guide Settings. Available Form fields depend on the active answer methods and the Form’s field types.

When an Options answer is linked to a Form choice field, use Option conversion to match the Field’s final options to that Form field’s options. Read any warning or confirmation before saving a mapping, especially when changing the Guide’s target Form would clear existing Field mappings.

Configure speech

Open Speech to control how CareMap reads the Field prompt aloud. Set a spoken-text override, audio, cloud voice, or accessibility labels and hints. See Guide speech and cloud voices.

Block Speech is different from the Audio Recording method. Speech plays the authored prompt; Audio Recording lets the player provide a saved audio answer.

Set report labels

For methods that support report settings, open Advanced settings to include the answer in reports or set a custom Report label. If that label is blank, CareMap uses the Field prompt, then the method Label, then the method type.

What players see

With one method, its answer control opens directly. With several, the player first chooses an answer method and can use Change to return to the chooser. Required Fields count as complete only after one method passes its configured validation and evidence rules.

Collect several responses to one prompt

In Content, enable Return to response methods to return to the chooser after explicitly finishing a response. It is off by default and has no effect when the Field has only one method. All methods keep their own saved answers; reopen any method to review or edit it without resetting the others.

Use the method’s Submit, Save, Confirm, or Continue control. Methods that normally save as you interact have a Done with response button. Autosave, browsing nested options, and uploading media do not close the input. Pending or failed media must become ready before finishing that response. Change switches methods; Reset or Remove deletes the chosen response.

Authored after-submit actions still run normally, including navigation. The chooser return does not cancel an accepted action, and accepting an unchanged response again in the same Field does not replay its action. Required still means one valid response, not every method. A Completion method named “Submit Report” only finishes the Guide if its action is configured to Finish guide; the normal finish flow saves pending answers and generates the report.

Fix common problems

• No answer controls appear: Edit the block, add and configure an answer method, then save it.
• The player cannot continue: Complete a valid answer for each required Field on the page, including any required evidence.
• A method is hard to identify: Give every method a short, unique Display name and optional supporting text or image.
• A chooser image looks cropped: Large square tiles intentionally use a cover crop. Use Compact rows or choose an image with the subject near the center.