ZenotiHelp

Manage guest forms tab

ZTZenoti Docs Team Updated October 23, 2026 9 min readGuide

The Forms tab in the guest profile displays all forms assigned to or completed by a guest, including intake forms, consent forms, medical forms, and custom forms. From this tab, you can view form status, open forms for completion, and track submission history across all form types associated with the guest.

Audience: Front desk staff who manage guest intake forms and track form completion.


On this page


Before you begin

  • The Forms tab must be enabled in your organization's guest profile tab configuration (Configuration > Guests > Profile > Show tabs for guest profile).

  • Forms must be configured and assigned to your center. For form design and setup, see form creation and management.

  • To view guest form data in the Forms tab, you need the following permissions:

    Permission: View under GuestCustomData (section: Guest Manager) β€” required to see guest forms in the tab. Admin path: Configuration > Security > Security roles > [your role] > PERMISSIONS > Guest Manager > GuestCustomData > View

    Permission: View under ServiceCustomData (section: Appointment Book) β€” required to see service and tag forms in the tab. Admin path: Configuration > Security > Security roles > [your role] > PERMISSIONS > Appointment Book > ServiceCustomData > View

    A staff member who lacks View under the applicable object will not see the relevant form data in the tab.

  • To open or manage forms in the tab, you also need:

    Permission: Edit under GuestCustomData (section: Guest Manager) β€” required to open or manage guest forms.

    Permission: Edit under ServiceCustomData (section: Appointment Book) β€” required to open or manage service and tag forms.

  • To use the View Chart action on service form rows, you need:

    Permission: View Treatment Hub β€” required to see the View Chart action on any form row. Users without this permission will not see the action.

Note: There is no per-tab View permission for the Forms tab, and no security object named "Guest Forms". Whether the tab appears is controlled by the guest profile tab configuration; what you can do inside it is controlled by the two objects above (GuestCustomData and ServiceCustomData).

Note: A job-level per-form permission can override the role-level setting for an individual form. For details on restricting form access by job role, see Restrict form access by job role.

Note: The Guest Forms Report action β€” found under Guest Engagement in the Reports(V2) section of the security role β€” controls access to the Guest Forms report only. It does not affect the Forms tab, and granting it does not grant access to the tab.


Steps

View form status

  1. From the Appointment Book, select the guest and open the Guest profile panel.

  2. Select the Forms tab.

  3. The tab displays all forms associated with the guest. Each row shows the form name, form status, and last updated date.

    The Form Status column shows one of these values:

    Status Meaning
    Filled The guest has submitted this form.
    Not Filled The form has not been submitted.
  4. Review the list of forms. By default, the tab shows forms attached to appointments in Open or Closed status. Forms attached to appointments in any other status β€” such as Deleted, No Show, Cancelled, or Void β€” are hidden from the default view. The form data for those appointments is stored and intact; it is not shown until you adjust the Appointment Status filter.

Note: When an appointment is deleted, its associated form data is not deleted. The forms are hidden by the Appointment Status filter default, not removed. To recover visibility, see View forms for deleted, no-show, cancelled, or voided appointments below.

Filter forms by appointment or form status

The Forms tab includes two distinct filter controls. Use them independently or together to narrow the form list.

Appointment Status filter

The Appointment Status filter controls which appointments' forms appear in the tab. By default, only Open and Closed are selected.

Available options:

  • Open
  • Closed
  • Deleted
  • No Show
  • Cancelled
  • Void

To change which appointment statuses are shown:

  1. Select the Appointment Status filter on the Forms tab.
  2. Add or remove the statuses you want to include.
  3. Apply the filter. The tab refreshes to show forms attached to appointments matching the selected statuses.

Important: The Appointment Status filter is the only control that shows or hides forms based on appointment status. Do not use the Form Status filter to recover forms that are hidden because their appointment is in a non-default status such as Deleted or No Show β€” the Form Status filter has no Deleted option and cannot restore those forms.

Form Status filter

The Form Status filter narrows the list by whether a form has been completed. Available options:

  • All
  • Filled
  • Not Filled

To apply the form status filter:

  1. Select the Form Status filter on the Forms tab.
  2. Choose Filled, Not Filled, or All.
  3. Apply the filter.

Open a form for completion

  1. From the Appointment Book, select the guest and open the Guest profile panel.
  2. Select the Forms tab.
  3. Locate the form you want to open.
  4. Select the form to open it.
  5. The system opens the form in a popup window. The form version that opens is determined by how the form is configured β€” you do not choose which version opens. Zenoti supports three form versions, and the system routes to the correct one automatically:
    • V2 forms β€” the current form editor
    • V3 Unified Forms β€” the unified form experience
    • Legacy guest forms β€” the earlier form format, used when the form has not been migrated
  6. Complete the form on behalf of the guest, or have the guest complete it.
  7. Submit the form.

When you close the form popup, the Forms tab automatically refreshes to reflect the updated submission status.

Note: Form design, builder configuration, and form template management are handled in the Forms module. For form creation and management, see form creation and management.

Tip: The tab refresh after form popup closure is automatic β€” no manual page reload is needed.

View forms for deleted, no-show, cancelled, or voided appointments

When an appointment is deleted, cancelled, marked as a no-show, or voided, its associated forms are hidden from the Forms tab by default. The form data remains stored β€” only the display is filtered out. To view those forms:

  1. From the Appointment Book, select the guest and open the Guest profile panel.
  2. Select the Forms tab.
  3. Select the Appointment Status filter.
  4. Add the relevant status values β€” for example, Deleted, No Show, Cancelled, or Void β€” to the filter selection.
  5. Apply the filter. Forms attached to appointments in those statuses now appear in the tab.

Important: Deleting an appointment does not delete its associated form data. The forms stay attached to the deleted appointment and are therefore visible only while Deleted is included in the Appointment Status filter selection.

Note: The Retain blank (not filled) forms for setting (at Configuration > Forms) controls whether blank forms are kept for appointments in selected statuses. This is a separate mechanism from the Appointment Status filter. Enabling that setting does not change which appointments the Forms tab displays β€” it only determines whether unfilled forms associated with those appointments are retained in the system.

View a Treatment Hub chart from a service form

For service forms whose appointment uses Treatment Hub and already has an existing chart, a View Chart action appears on the form row. Selecting View Chart opens the appointment's chart in Treatment Hub.

Permission: View Treatment Hub β€” required to see the View Chart action. Users without this permission will not see the action on any form row.

  1. From the Appointment Book, select the guest and open the Guest profile panel.
  2. Select the Forms tab.
  3. Locate the service form row for the appointment that uses Treatment Hub.
  4. Select View Chart on the form row.
  5. The appointment's chart opens in Treatment Hub.
  6. Review or update the chart as needed.
  7. When you return to the Forms tab, the forms list refreshes automatically.

For full Treatment Hub chart workflows, see Open Treatment Hub from an appointment.


Tips

  • Use the Appointment Status filter to recover hidden forms. If a guest's form appears to be missing, check whether its appointment was deleted, cancelled, marked as no-show, or voided. Add those statuses to the Appointment Status filter to make the forms visible again.
  • The Forms tab refreshes automatically after form submission. When you close a form popup, the tab updates immediately to show the latest submission status β€” no manual refresh is needed.
  • Form version is determined by configuration, not by staff selection. If a guest's form opens in an unexpected format, the form template may be using a different version. Contact your administrator or refer to your organization's form configuration in the Forms module.
  • The Form Status filter and Appointment Status filter are independent. Changing one does not affect the other. Use both together for the most precise results β€” for example, filter by Cancelled appointment status and Not Filled form status to find unsigned consent forms from cancelled appointments.
  • Deleting an appointment does not erase form data. If you need to access forms from a deleted appointment, add Deleted to the Appointment Status filter. The original form data remains stored and attached to the deleted appointment record.
  • View Chart appears only for eligible service forms. The View Chart action is shown only when the service form's appointment uses Treatment Hub and a chart already exists. If the action is not visible, either the appointment does not use Treatment Hub, no chart has been created yet, or you do not have the View Treatment Hub permission.

Troubleshooting

A guest's form is not visible on the Forms tab.

The form's appointment may be in a status that is excluded from the default filter. By default, only Open and Closed appointment statuses are selected. If the appointment was deleted, cancelled, marked as no-show, or voided, its forms are hidden. To resolve this, select the Appointment Status filter, add the relevant status (such as Deleted or Cancelled), and apply the filter.

I changed the Form Status filter to "Not Filled" but the form I'm looking for still doesn't appear.

The Form Status filter does not control visibility based on appointment status. If the form's appointment is in a non-default status such as Deleted or Cancelled, it remains hidden regardless of the Form Status selection. Use the Appointment Status filter instead to include those appointment types.

After deleting an appointment and creating a new one, the guest's previously submitted form is gone.

The submitted form is still stored and attached to the original (now deleted) appointment. It is not visible in the default view because the Appointment Status filter excludes Deleted appointments. Select the Appointment Status filter, add Deleted, and apply to locate the original form.

The form opens in an unexpected version or format.

The form version β€” V2, V3 Unified, or Legacy β€” is determined by how the form is configured, not by staff action. If a form is opening in an unexpected version, contact your administrator. Form template configuration is managed in Configuration > Forms.

The Forms tab is not visible in the guest profile.

The Forms tab may not be enabled for your organization. An administrator can enable it at Configuration > Guests > Profile > Show tabs for guest profile. If the tab is already listed but not visible to you, confirm with your administrator that the tab is set to display by default.

The View Chart action does not appear on a service form row.

The View Chart action appears only when three conditions are met: the service form's appointment uses Treatment Hub, a chart already exists for that appointment, and you have the View Treatment Hub permission. If any condition is not met, the action is not shown. Contact your administrator to confirm your permissions and whether Treatment Hub is configured for the relevant service.


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