ZenotiHelp

Concerns Field on Guest, Service, and Tag Forms

ZTZenoti Docs Team Updated November 2, 2026 8 min readGuide

The Concerns field lets you capture a guest's health concerns directly within a form. When added to a guest form, service form, or tag form, it presents concerns from your organization's master concerns list in one or both of two display formats β€” radio buttons or select boxes β€” and can allow guests to search for additional concerns or enter custom ones during form filling.

Audience: Form administrators who design forms in the form builder.


On this page


Before you begin

  • Your organization must have the guest medical record feature enabled. If this feature is off, the Medical Record component group does not appear in the form builder palette, and the Concerns field is not available.

  • The Concerns entity must be enabled in your EMR Configuration. If Concerns are disabled there, the Concerns field is hidden from the palette even when the guest medical record feature is on.

  • The Concerns field is available only on guest forms, service forms, and tag forms. It cannot be added to membership, loyalty, or other form types.

  • You must be editing a form in the form builder (V3). The Concerns field is not available in the legacy form builder.

  • You need the following permission:

    Permission: View under Medical Record in the Administrator section of the security role β€” required to open and edit forms that contain medical record components.

Note: For conceptual background on how EMR data and the guest medical record feature interact with forms, see Forms Overview.


Add a Concerns field to a form

Open the form for editing

  1. Navigate to Configuration > Forms.
  2. Locate the guest form, service form, or tag form you want to edit.
  3. Select Edit next to the form name. The form opens in the form builder.

Add the field from the Medical Record component group

  1. In the component palette on the left, scroll to the Medical Record component group.

    Note: If Medical Record does not appear in the palette, either the guest medical record feature is off for your organization or the Concerns entity is disabled in EMR Configuration. Contact your administrator to enable these before proceeding.

  2. Drag the Concerns component onto the form canvas and drop it into the desired position.

  3. The Concerns component settings panel opens automatically. Proceed to configure the display modes.


Configure display modes

The Concerns field supports two independent display modes. You may enable one or both simultaneously.

Display mode How it appears to the guest Enabled by default
Show as radio buttons (options are displayed with Yes/No buttons) Each concern is listed with a Yes and No button. The guest selects one button per concern. No
Show as select boxes (options are displayed with checkboxes) Concerns are displayed with checkboxes. The guest selects all that apply. Yes

To configure display modes:

  1. In the component settings panel, locate the display mode options.
  2. Enable or disable Show as radio buttons (options are displayed with Yes/No buttons) and Show as select boxes (options are displayed with checkboxes) as needed. You may enable both at the same time.

Important: If you disable both display modes, the Concerns field renders nothing to the guest. Ensure at least one mode is enabled before saving the form.


Configure concern options for each display mode

Each display mode has its own independently configured question text and its own list of concerns drawn from your organization's master concerns list. Changes to one mode's settings do not affect the other.

Set the question text

Each display mode shows a question above the concerns. The default text is:

  • Radio-button mode: Do you have any of the following concerns?
  • Select-box mode: Select all applicable concerns

To change the question text for either mode, select the text field for that mode in the settings panel and enter your preferred wording.

Select concerns from the master list

Each display mode has its own list of concerns. To add concerns to a mode:

  1. Within the settings for the relevant display mode, open the concerns picker.
  2. Select the concerns you want to include from your organization's active master concerns list.
  3. Repeat for the other display mode if both are enabled. The two modes may have different concern lists.

Tip: Keep the per-mode concern lists focused. If radio-button mode is for screening critical concerns, add only high-priority items there. Select-box mode can carry a broader list.


Enable master list search and custom concerns

Two options control whether guests can find concerns beyond the pre-configured list while filling the form.

Allow adding from the master list

When this option is enabled, an + Add button appears on the form. Guests can tap it to open a search panel over your organization's active master concerns list.

Note: Search results begin returning after the guest types at least three characters.

To enable this option:

  1. In the Concerns component settings, select Allow adding from master list.

Allow adding custom concerns

When this option is enabled, the search results panel includes an Add as custom concern: <text> row. This lets guests enter a concern that does not exist in the master list.

Validation rules for custom concern names:

  • Minimum length: 3 characters
  • Maximum length: 500 characters
  • The Add as custom concern: <text> row is hidden when the typed text exactly matches an existing concern in the master list.

To enable this option:

  1. In the Concerns component settings, select Allow adding custom concerns.

Important: Custom concerns that guests add during form filling appear in a separate Additional concerns group on the rendered form. They are not added to your organization's master concerns list.


Enable per-concern notes

When this option is enabled, a notes input box appears next to each concern on the form, allowing guests to add detail about that specific concern.

The label on each notes box is drawn from EMR Configuration:

  • If a Notes label has been configured for a concern in EMR Configuration, that label is shown.
  • If no label has been configured, the input box defaults to the label Add more details.

To enable per-concern notes:

  1. In the Concerns component settings, select Allow adding note for each concern.

Worked example: Your organization treats concerns related to skin sensitivity. For the concern "Latex allergy", your EMR Configuration has a Notes label set to "Please describe your reaction". When a guest fills the form, the notes box next to "Latex allergy" shows "Please describe your reaction". For the concern "Rosacea", which has no Notes label configured, the notes box shows the default label "Add more details".


How concerns appear when the form is filled

Understanding the rendering behavior helps you design forms that are straightforward for guests to complete.

Category groupings

Concerns are grouped under their category headings when the form is rendered. If your master concerns list organizes concerns into categories such as "Skin conditions" and "Cardiovascular", those headings appear as section separators on the form.

The "None of the above" option (select-box mode only)

In select-box mode, a None of the above option is appended after all categorized concerns. This gives guests a clear way to indicate that none of the listed concerns apply without leaving all checkboxes blank.

Note: The None of the above option does not appear in radio-button mode.

Additional concerns group

Any concern that a guest adds during form filling β€” whether found via the master list search or entered as a custom concern β€” appears in a separate Additional concerns group, visually separated from the pre-configured concern categories.


Tips

  • Enable both display modes for different clinical purposes. Use radio-button mode for a short list of critical screening questions where a definitive Yes/No response is needed, and select-box mode for a broader checklist of optional concerns.
  • Keep custom concern names consistent. When Allow adding custom concerns is on, encourage staff to review submitted forms and periodically promote frequently entered custom concerns to the master concerns list in EMR Configuration. This keeps reporting clean.
  • Use per-concern notes selectively. Enabling notes for every concern can make long concern lists feel overwhelming. Consider enabling this option only for specific concerns where detail is clinically important, and configure custom Notes labels in EMR Configuration to make each prompt specific.
  • Preview the form after saving. The grouping and ordering of concern categories depends on how your master concerns list is organized in EMR Configuration. Open a test session of the form after saving to confirm the layout matches your expectations.
  • Coordinate with your EMR Configuration owner. The availability of the Concerns field, the master concerns list content, and per-concern Notes labels are all managed in EMR Configuration. Changes there affect every form that includes a Concerns field.

Troubleshooting

The Concerns field does not appear in the form builder palette.

The Medical Record component group β€” which contains the Concerns field β€” is hidden when either the guest medical record feature is off for your organization or the Concerns entity is disabled in EMR Configuration. Confirm with your administrator that both are enabled. If the feature is on but the palette entry is still missing, try refreshing the form builder page.

The form shows no concerns when rendered, even though the field is on the canvas.

Each display mode has its own separately configured concerns list. If neither list has any concerns selected from the master list, the field renders with no items. Open the Concerns component settings, select at least one concern for each enabled display mode, and save the form.

Guests cannot use the + Add button to search for concerns.

The + Add button only appears when Allow adding from master list is enabled on the Concerns field. Open the component settings and confirm this option is selected. Also confirm that the guest is typing at least three characters before expecting results β€” the search requires a minimum of three characters to begin.

The "Add as custom concern" row is not appearing in search results.

This row only appears when Allow adding custom concerns is enabled and the typed text does not exactly match an existing concern in the master list. If the guest types a name that matches an existing concern exactly, the row is suppressed. Check that the option is enabled in component settings and advise guests to try a slightly different phrasing if the exact text they want is already in the master list.

Per-concern notes labels are showing "Add more details" instead of the expected label.

The notes label is pulled from the Notes label field configured for each concern in EMR Configuration. If "Add more details" is showing, the Notes label for that concern has not been set in EMR Configuration. Ask your EMR Configuration owner to add the label for the relevant concern.

The Concerns field appears on a membership or loyalty form but the requirements say it should not.

The Concerns field is restricted to guest forms, service forms, and tag forms only. If it is appearing on another form type, the form definition may have been miscategorized. Review the form type setting and correct it, or contact your administrator.


Was this article helpful?
Your feedback helps us improve our documentation.