ZenotiHelp

Custom tags & forms

ZTZenoti Docs Team Updated October 5, 2026 6 min readGuide

Custom tags help you organize and filter classes in the class listing. Custom forms let you capture additional data about a class beyond the standard fields. Both are optional features you can use to extend the class catalog.

Audience: Fitness administrators who manage class metadata and data capture.


On this page


Before you begin

  • Ensure your user role has permission to create and edit classes and tags in Zenoti.
  • Tags and tag groups are managed at the organization level. You must have organization-level access to create or edit them.

Note: The Fitness Tags and Fitness Tag Groups pages are Configuration-area settings. Navigate to Configuration > Fitness > Tags (labeled Fitness Tags) or Configuration > Fitness > Tag Groups (labeled Fitness Tag Groups) to access them. These settings are not accessible from the Fitness icon's Setup accordion. These pages were previously labeled Class Tags and Class Tag Groups — if you see references to those older names in other materials, they refer to the same pages.

Custom tags

How tags work

Tags are labels you assign to classes. They appear as filter options on the class listing page, allowing you to quickly find all classes that share a tag. Tags are organized into tag groups for hierarchical filtering.

Tags are class-specific (tag type 11). When assigned to a class, they become available as filterable facets in the class listing, so administrators can quickly locate classes by tag.

Manage tags

Use the Fitness Tags page to create, edit, or delete class-specific tags.

  1. Navigate to Configuration > Fitness > Tags.
  2. The Fitness Tags page loads, showing all existing class tags.
  3. To add a tag, enter a tag name and optionally select a color or assign it to a tag group.
  4. Select Save to create the tag.
  5. To edit an existing tag, select it from the list, update the name, color, or group, and select Save.
  6. To delete a tag, select the tag and use the delete option.

Manage tag groups

Tag groups let you organize related tags into a hierarchy, making it easier to filter classes across broad categories.

  1. Navigate to Configuration > Fitness > Tag Groups.
  2. The Fitness Tag Groups page loads, showing all existing tag groups.
  3. To add a group, enter a group name and select Save.
  4. To edit or delete an existing group, select it from the list and apply your changes.

Add a tag to a class

  1. Open the class detail page.
  2. Navigate to the Tags field on the class record.
  3. Select one or more tags from the available list.
  4. Select Save.

Filter the class listing by tag

  1. Open the class listing page.
  2. Use the Filter by control to select one or more tags.
  3. The listing displays only classes that have the selected tags assigned.

Tip: Use tag groups to create a logical hierarchy — for example, group tags like "Morning," "Afternoon," and "Evening" under a "Time of Day" tag group to make filtering faster.

Custom forms

How custom forms work

Custom forms allow you to capture additional data specific to a class. Forms are defined using an HTML form editor and associated with the class definition. Form data is stored with the class record and can be referenced in notifications using the configured macros.

You can associate a form directly with a class and optionally configure per-center form associations using the Tag Form Center Association settings.

When a class has a custom form associated, students or administrators can fill out the form during the registration flow in the CMA or Webstore. The Fill out form during booking in CMA/Webstore option controls whether the form is presented at that point.

Add a custom form to a class

  1. Open the class detail page.
  2. Navigate to the Custom Forms tab.
  3. In the Select a form field, choose the form you want to associate with this class.
  4. To require the form to be completed during registration in the CMA or Webstore, enable Fill out form during booking in CMA/Webstore.
  5. To associate a different form for specific centers, use Tag Form Center Association and select the center and form combination.
  6. Select Save.

Note: If no forms are available to select, the page displays No tag forms to display. Ensure that HTML forms have been created in your organization before attempting to associate them with a class.

Preview a form

To verify the form looks correct before assigning it to students:

  1. On the Custom Forms tab of the class detail page, locate the associated form.
  2. Select Preview to open a read-only view of the form.
  3. Select Close to return to the class detail page.

If your organization supports sending form links to students by email:

  1. On the class detail page, navigate to the Custom Forms tab.
  2. Select Allow emailing of form link.
  3. Use the Email Form Link option to send the form link to registered students.

Note: The form link email uses your organization's transactional email settings. If the email is not delivered, verify that transactional email is enabled and that the student has a valid email address on file.

Select a different form for specific centers

You can override the default class-level form for individual centers using the Tag Form Center Association feature.

  1. On the Custom Forms tab, select Select a different form for the specific center.
  2. In the Tag Form Center Association area, choose the center and the form to associate.
  3. Select Save.

Best practices

  • Create tag groups before creating individual tags so you can assign each tag to the appropriate group from the start.
  • Use consistent naming conventions for tags across your organization (for example, "Level: Beginner," "Level: Intermediate") so the filter facets are intuitive for administrators.
  • Preview every custom form before enabling Fill out form during booking in CMA/Webstore to confirm the form renders correctly and collects the intended data.
  • Use Tag Form Center Association to serve center-specific intake forms when your centers have different data collection requirements, rather than creating separate class definitions.
  • Review form associations when duplicating a class. Cloned classes do not automatically inherit center-level form overrides — verify the Custom Forms tab after copying.

Troubleshooting

Problem Resolution
The Fitness Tags or Fitness Tag Groups page is not visible These pages are at Configuration > Fitness > Tags and Configuration > Fitness > Tag Groups. They do not appear under the Fitness icon's Setup accordion. Confirm your user role has the required permissions for Configuration-area settings.
No tag forms to display appears on the Custom Forms tab No HTML forms have been created for your organization yet. Create a form first, then return to the class to associate it.
A form link email fails to send Confirm that transactional email is enabled for your organization, that the student has a valid email address, and that your organization has sufficient email credits. The system displays a specific error message indicating which condition was not met.
Tags assigned to a class do not appear as filter options in the class listing Tags appear as filterable facets in the class listing after they are saved on the class record. Refresh the class listing page and confirm the tag was saved correctly on the class detail page.
A center-level form association does not appear Verify the Tag Form Center Association was saved for the correct center. Open the class detail page, select the Custom Forms tab, and confirm the center-specific form is listed.
Links to "Class Tags" or "Class Tag Groups" no longer work These pages were renamed to Fitness Tags and Fitness Tag Groups. Navigate to Configuration > Fitness > Tags or Configuration > Fitness > Tag Groups to reach them.
Was this article helpful?
Your feedback helps us improve our documentation.