ZenotiHelp

Restrict form access by job role

ZTZenoti Docs Team Updated September 21, 2026 4 min readGuide

You can restrict which employees can view or fill a specific form based on their job role. This is useful when a form contains sensitive clinical information that only certain roles should access (for example, a physician-only consent), or when a form's completion is reserved for specific providers.

Permissions are configured per form definition and evaluated at the moment a provider opens a form during an appointment.

Note: For conceptual background on forms infrastructure, see Forms overview.

Before you begin

  • The form must already exist in your organization.
  • Employee jobs must be defined in the Employee module (Employee > Jobs).
  • Your account must have Edit under CustomFields β€” the same permission used for custom-field administration also gates form-level role permissions.
  • In franchise organizations, form definitions and the job-based permissions configured on them are held at headquarters. If the permission controls described here are unavailable at your center, route the change request to the franchisor rather than making it locally.

Permission: Edit under CustomFields in the Administrator section of the security role β€” Required to manage job-based form permissions.

Assign form access by job role

  1. Navigate to Configuration > Forms > Form creation > Custom forms.
  2. Open the form you want to configure permissions for.
  3. Select the PERMISSIONS tab of the form.
  4. Select Add permission.
  5. Configure the permission:
  • Job role β€” Select the employee job type from the dropdown.
  • Action type β€” Choose the access level:
  • View β€” The employee can see the form but cannot fill it.
  • Fill β€” The employee can view and complete the form.
  1. Save. Repeat for every additional job role that should have access.

How the system enforces job-role permissions at appointment time

When a provider opens a form during an appointment, Zenoti compares the provider's assigned job role against the form's permission list and applies the following rules:

  • If the role has a Fill permission, the form opens in edit mode.
  • If the role has a View permission, the form opens in read-only mode.
  • If the role has no permission on the form, the form does not appear in the provider's form list.

Note: A provider must have the correct job role assigned on their employee profile for the permission to apply.

Tips

  • Start with a narrow permission set and expand it as needed. A form that no one can open is immediately apparent; a form that everyone can edit is harder to spot.
  • Test the permission by logging in as a test employee with the target job role. If the form does not appear or is locked unexpectedly, confirm that the employee's job role matches the configured role exactly.
  • Audit permissions periodically. Job roles sometimes get renamed; a permission bound to an old role name silently stops applying.

Security-role-level form permissions

In addition to per-form job-level permissions, Zenoti has a security-role-level configuration that controls form access more broadly across all forms. This configuration is set through the Security module and governs which capabilities a staff role has for forms system-wide.

ServiceCustomData permissions (service and tag forms)

Navigate to Configuration > Security > Security roles, open the role you want to configure, go to the PERMISSIONS tab, expand the Appointment Book section, and locate the ServiceCustomData row. The available check boxes are:

Permission What it grants
View The role can open and read service and tag forms in appointments, but cannot edit or submit them.
Edit The role can fill, edit, and submit service and tag forms.
Forms Review The role can review submitted forms and mark them as reviewed. Required for the review workflow. See Manage form reviews.
Unlock Forms The role can unlock a submitted (locked) form to allow re-editing. Typically restricted to supervisors or managers.
Bulk forms update The role can perform bulk operations on forms from the Service forms report (bulk review, bulk status update).
Restrict to own forms in report When selected, restricts the Service forms report to show only forms for the role's own appointments. Hides the Provider and Job filters for that role. This check box appears only when the signed-in administrator's own role holds Service Forms Report under Guest Engagement in the Reports(V2) section.
Add form dynamically The role can add tag forms to appointments on the fly (dynamic forms).

GuestCustomData permissions (guest custom forms)

In the same PERMISSIONS tab, expand the Guest Manager section and locate the GuestCustomData row:

Permission What it grants
View The role can view guest custom form data in the guest profile.
Edit The role can fill and edit guest custom forms.

Precedence: security-role level vs. job level

These two permission levels work together with a clear precedence rule:

  • Security-role-level permissions are broad β€” they control whether a role can interact with service forms and guest forms at all, across every form in the organization.
  • Job-level permissions (configured per form definition in the form builder, as described above) are narrow β€” they restrict which specific forms a job role can access.
  • Job-level permissions override security-role-level permissions for that specific form. A provider who has Edit at the security-role level but only View on a specific form's job-level permissions will see that form in read-only mode.

Tip: Set baseline access at the security-role level (for example, grant Edit to all providers), then use job-level permissions to restrict access to specific sensitive forms (for example, restrict a physician-only consent to the physician job role).

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