Service entity types
Configure service entity types to support multi-entity services like couples massages or group classes.
Audience: Administrators and managers who configure the service catalog.
Availability: Requires the Enable Service Entity Types org setting to be active. When this setting is off, entity type menus and pages are hidden throughout Zenoti.
On this page
- Before you begin
- Create a service entity type
- Map services to the entity type
- Configure entity-specific custom fields
- Edit an existing entity type
- Delete an entity type
- Tips
- Troubleshooting
- Related articles
Before you begin
Your organization must have the Enable Service Entity Types setting active. Contact your Zenoti administrator if this setting is not enabled.
You need the following permissions:
Permission: Add (under ServiceEntities in the Administrator section) — Required to create new service entity types.
Permission: Edit (under ServiceEntities in the Administrator section) — Required to modify existing service entity types.
Permission: Edit (under ServiceCustomData in the Appointment Book section) — Required to configure entity-specific custom fields.
Decide which services will use the entity type before creating it. Each service can be mapped to an entity type after the entity type is saved.
Steps
Create a service entity type
Note: The label for the service entity types section may differ in your organization — it is customizable per your organization's settings. Look for the equivalent entry under your resources administration area.
- Navigate to the service entity types administration area.
- Select the option to add a new entity type.
- Configure the basic settings:
- Name — Enter a descriptive name for the entity type (for example, "Couples Services" or "Group Classes").
- Description — Add details about when to use this entity type.
- Maximum Entities — Set the maximum number of entities allowed for services using this type (for example, enter 2 for a couples massage that requires exactly two guests).
- Select Save to create the entity type.
Worked example: A spa offering couples massages creates an entity type named "Couples Services" with a description of "Two-guest services performed simultaneously" and a Maximum Entities value of 2. They then map their "Couples Swedish Massage" and "Couples Deep Tissue Massage" services to this entity type.
Map services to the entity type
- Open the entity type you created or want to edit.
- Navigate to the services mapping section.
- Select the services that should use this entity type configuration.
- Select Save to apply the mapping.
Note: Only services that are appropriate for multi-entity bookings should be mapped to an entity type. Mapping a standard single-guest service to an entity type may affect how that service appears during booking.
Configure entity-specific custom fields (optional)
Entity-specific custom fields let you capture additional data per entity (for example, per guest in a couples booking) rather than per service overall.
Permission: Edit (under ServiceCustomData in the Appointment Book section) — Required to configure entity-specific custom fields.
- Open the entity type you want to configure.
- Navigate to the custom fields section within the entity type.
- Select the option to add a custom field.
- Configure the field settings:
- Field Name — Enter the custom field name (for example, "Guest Preference Notes").
- Field Type — Select the data type appropriate for the field (for example, text, number, or date).
- Required — Select this option if the field must be completed before the service can proceed.
- Repeat for additional custom fields as needed.
- Select Save to apply the custom field configuration.
Important: Entity-specific custom fields are distinct from service-level custom fields. Entity-specific fields capture data for each individual entity (guest) within a multi-entity booking, while service custom fields apply to the service as a whole.
Edit an existing entity type
Permission: Edit (under ServiceEntities in the Administrator section) — Required to modify existing service entity types.
- Navigate to the service entity types administration area.
- Select the entity type name to open its details.
- Modify the name, description, maximum entities, service mappings, or custom fields as needed.
- Select Save to apply your changes.
Delete an entity type
Important: Before deleting an entity type, verify that no active services are currently mapped to it. Removing an entity type that services depend on may affect how those services behave during booking.
- Navigate to the service entity types administration area.
- Locate the entity type you want to remove.
- Select the delete option for that entity type.
- Confirm the deletion when prompted.
Tips
- Use descriptive names that clearly indicate the entity type's purpose (for example, "Family Packages" rather than "Type A").
- Set realistic maximum entity limits based on your center's capacity and typical booking patterns. For a couples service, set Maximum Entities to 2; for a small group class template, set it to match your room capacity.
- Test entity types with a small group of services before rolling out to your full service catalog.
- Review your service mappings periodically. If a service is no longer offered as a multi-entity booking, remove it from the entity type to keep your catalog accurate.
- Entity-specific custom fields are best used for information that differs between guests in the same booking — such as individual preferences or health notes — rather than information that applies to the booking as a whole.
Troubleshooting
The service entity types section is not visible.
The Enable Service Entity Types org setting is not active for your organization. Contact your Zenoti administrator to enable this setting. Until it is active, all entity type menus and pages remain hidden.
I cannot create a new entity type.
You may be missing the Add permission under ServiceEntities in the Administrator section. Ask your administrator to verify your security role includes this permission. Also confirm that the Enable Service Entity Types org setting is active.
A service I want to map does not appear in the services list.
The service may be inactive or not yet created. Navigate to Master data > Services to verify the service exists and is active. Once confirmed, return to the entity type and attempt the mapping again.
Custom fields I configured are not appearing during booking.
Entity-specific custom fields appear during the booking or check-in flow only when the service is booked through a workflow that supports multi-entity data capture. Verify that the service is correctly mapped to the entity type and that the Enable Service Entity Types setting remains active. If the fields still do not appear, contact your Zenoti administrator.
I saved changes to an entity type but the updates are not reflected.
Changes may take a few moments to appear across the system. Refresh the page and verify the save was successful. If the issue persists, check whether another administrator has overridden the settings, or contact Zenoti support.