Service tags and tag groups
Use tags and tag groups to classify services with custom labels that guests can use to filter and browse your service catalog in the Webstore and booking interfaces.
Audience: Administrators and managers who configure the service catalog.
On this page
- Before you begin
- How tags and tag groups work
- Steps
- How tags appear in the Webstore
- When a tag cannot be deleted
- Tips
- Troubleshooting
- Related articles
Before you begin
You need the following permissions:
Permission: Add (under Tags in the Administrator section) — required to create tag groups and tag items.
Permission: Edit (under Tags in the Administrator section) — required to modify existing tag groups and tag items.
Permission: Delete (under Tags in the Administrator section) — required to remove tag groups and tag items.
The Enable Tags organization setting must be active for tag features to be available. If you do not see the tag group management page, contact your administrator to enable this setting.
Tag groups are created at the organization level and associated with services at the center level.
How tags and tag groups work
Tag groups are organizational containers that hold individual tag items. Each tag group represents a classification dimension (for example, "Treatment type" or "Skin concern"), and the tag items within it represent the specific values (for example, "Anti-aging," "Hydrating," "Brightening").
When you associate tags with a service at a specific center, guests can browse and filter services by those tags in the Webstore and online booking interfaces.
Tags are independent metadata — they are separate from service categories. A tag can apply to services across multiple categories, and a service can carry tags from multiple tag groups simultaneously.
A custom form can also be attached to a tag, so that the form appears automatically during appointments for any service carrying that tag. Forms attach to tags, not to tag groups, and the tag is selected on the service's Custom tab under Additional Forms. See Service-level forms.
Steps
Create a tag group
Navigate to Configuration > Services > Service tag groups.
Click Add.
Configure the following settings:
Field Description Tag group name A descriptive name for the tag group (for example, "Treatment type" or "Body area") Description An optional description explaining the purpose of this tag group Active Whether the tag group is currently available for use Click Save.
Tip: Tag groups are created at the organization level and are available for association with services at any center.
Add tag items to a tag group
Open the tag group you want to add items to.
Click Add Tag Item.
Configure the following settings for each tag item:
Field Description Tag name The label displayed to guests and staff (for example, "Anti-aging" or "Deep tissue") Sort order A number that controls the display position of this tag within the group Active Whether this tag item is currently available Click Save.
Repeat to add additional tag items as needed.
Worked example: A spa creates a tag group named "Skin concern" with tag items "Anti-aging" (sort order 1), "Hydrating" (sort order 2), and "Brightening" (sort order 3). Guests browsing the Webstore can then filter services by skin concern.
Edit a tag group or tag item
- Navigate to Configuration > Services > Service tag groups.
- Click the tag group name to open it.
- Update the tag group settings or individual tag item settings.
- Click Save.
Delete a tag group or tag item
Important: A tag item that is currently associated with a package or discount cannot be deleted. The interface does not identify which package or discount is holding the association. To find the holder, search packages first, then discounts. Remove the tag association from the package or discount before attempting to delete the tag item.
- Navigate to Configuration > Services > Service tag groups.
- Locate the tag group or tag item you want to remove.
- Click the Delete icon.
- Confirm the deletion when prompted.
Associate tags with services
Tag groups classify tags; they are not used to attach forms. A form is attached to a tag, and the tag is then selected on the service's Custom tab under Additional Forms. See Service-level forms.
Tag selections are made per center, so the same service can carry different tags at different centers.
Note: The maximum number of tag forms that can be associated with a service is controlled by the Maximum number of tag forms required for a service organization setting.
Add translations for tag groups and tag items
For organizations operating in multiple languages, you can provide translated names for tag groups and tag items:
- Open the tag group you want to translate.
- Navigate to the localization section.
- Enter translated names for each supported language.
- Click Save.
Translated tag names appear in the Webstore and booking interfaces based on the guest's language preference.
Import tags in bulk
Tag bulk import uses two types of sheets: a Tags Master sheet to create or update tag records, and separate entity association sheets to link those tags to services, packages, products, or guests. Each type targets a different import type on the Import bulk data page.
Tags Master sheet
The Tags Master sheet creates or updates the tag records themselves — the tag groups and tag items — before you associate them with any entity.
| Column | Description |
|---|---|
| TagType | The entity type the tag is intended for (for example, service, package, product, guest). |
| Action | The operation to perform: create, update, or remove the tag record. |
| Other required columns | Tag group name, tag item name, and any additional required fields shown in the import template. |
- Navigate to Configuration > Business details > Business setup > Import bulk data (center scope).
- Select Tags Master as the import type.
- Upload your prepared Tags Master sheet and follow the on-screen steps.
- Review validation results before importing entity associations.
Entity association sheets
After creating tags via the Tags Master sheet, associate them with each entity type using a separate import:
| Entity | Import type to select |
|---|---|
| Services | Service Tag Associations |
| Packages | Package Tag Associations |
| Products | Product Tag Associations |
| Guests | Guest Tag Associations |
For each entity type:
- Prepare the association sheet with the required columns: entity identifier, center, tag group, and tag items.
- Navigate to Configuration > Business details > Business setup > Import bulk data (center scope).
- Select the import type for the entity you are associating (for example, Service Tag Associations for services).
- Upload your prepared file and follow the on-screen steps.
- Review validation results and confirm the import.
Important: The Tags Master sheet and the entity association sheets are separate imports. Always import the Tags Master sheet first to create the tag records before importing entity associations. Each entity type uses a different import type — the Service Tag Associations sheet format does not apply to packages, products, or guests.
Note: Invalid rows in the import file are skipped; valid rows are imported. Review the validation results carefully to identify any rows that were not processed.
How tags appear in the Webstore
After you associate tag groups with services at specific centers, guests see the tags as filter categories when browsing your service catalog:
- Tag groups appear as filter headings (for example, "Treatment type").
- Tag items appear as selectable filter options (for example, "Anti-aging," "Hydrating").
- Guests can select one or more tags to narrow the service list.
- Only services at the selected center that have matching tags are displayed.
When a tag cannot be deleted
If a tag item is associated with a package or discount, Zenoti blocks deletion. The error message does not name the specific package or discount holding the association.
To resolve this, search in the following order:
- Packages first — open each package that includes services with this tag and remove the tag association from the package benefit configuration.
- Discounts second — open each discount that references this tag and remove the tag condition.
Once all associations are cleared, return to the tag item and delete it.
Tips
- Design your tag groups around how guests think about your services. Common tag dimensions include treatment type, body area, skin concern, experience level, and duration range.
- Keep tag item names short and guest-friendly. Avoid internal jargon.
- Use consistent tag associations across centers to provide a uniform browsing experience in the Webstore.
- Review and update tag associations when adding new services or opening new centers.
- Use the bulk import feature when setting up tags for a large number of services to save time.
- When attaching a custom form to a tag, verify that the form is also active and published before saving the association.
Troubleshooting
Tag groups do not appear in the Webstore filter panel. Confirm that the Enable Tags organization setting is active. Also verify that the tag group is set to Active and that at least one tag item within the group is active and associated with a service at the center the guest is browsing.
A tag item cannot be deleted. The tag item is associated with a package or discount. The interface does not name the holder. Search packages first, then discounts, and remove the tag association from each before retrying the deletion. See When a tag cannot be deleted above.
Translated tag names are not appearing for guests. Confirm that translations have been saved for the correct language and that the guest's language preference in the Webstore matches the language for which translations were entered.
The bulk import completed but some services were not tagged. Rows with invalid service identifiers, unrecognized center codes, or inactive tag groups are skipped during import. Review the validation results file to identify which rows were skipped and correct the data before re-importing.
The custom form associated with a tag does not appear during appointments. Verify that the form is active, that the form is assigned to the tag, and that the tag is selected in one of the service's Additional Forms slots for the correct center. Forms that reach a service this way are not governed by the Allow adding forms to appointments dynamically organization setting.