Service Equality Templates
Service equality templates let you define which services can substitute for one another when a member redeems service credits, along with the credit conversion ratio for each substitution. You create and manage these templates centrally in master data, then attach them to individual membership definitions as needed.
Note: For conceptual background on how service credits work within memberships, see Memberships Overview.
On this page
Before you begin
Your organization must have at least one active membership with service credits configured.
You need the following permissions:
Permission: Edit (under Memberships) β Required to create, edit, and manage service equality templates and to attach them to membership definitions. Admin path: Configuration > Security > Security roles > [your role] > Marketing Manager > Memberships > Edit
Note: The Memberships row in the Marketing Manager section has no separate view check box. Viewing membership definitions and their service equality template assignments is not gated by a check box; the Edit check box above controls changes.
Service equality templates have no effect until they are attached to a membership definition. An unattached template does not influence any redemption behavior.
To attach a template to a membership, the membership must be set up to award service credits (that is, the service credits top-level tab must be configured on that membership).
Steps
Navigate to Service Equality Templates
- In the main navigation, go to Configuration > Memberships > Service equality templates.
- The Service equality templates page lists all templates defined for your organization.
Create a service equality template
On the Service equality templates page, select Add new.
Enter a descriptive name for the template.
Add one or more service substitution mappings. For each mapping, specify:
- Source service β The service that the member originally holds credits for.
- Substitute service β The service that can be redeemed in place of the source service.
- Credit conversion ratio β The number of source-service credits required to redeem one unit of the substitute service.
Note: You can add multiple substitution mappings to a single template. For example, a template might allow two haircut credits to be used for one haircut-and-wash, and separately allow three haircut credits to be used for one color treatment.
Select Save.
The template is now available to attach to any membership definition in your organization.
Worked example: You create a template named "Haircut Upgrades". You add two mappings:
- 2 Γ Haircut credits β 1 Γ Haircut and Wash
- 3 Γ Haircut credits β 1 Γ Color Treatment
Any membership that has this template attached will allow members to redeem their haircut credits for either of these substitute services at the defined ratios.
Edit an existing template
On the Service equality templates page, select the name of the template you want to edit.
The template opens directly in edit mode.
Update the name, add new mappings, or modify the credit conversion ratios for existing mappings.
Select Save.
Important: Editing a template affects all memberships that currently have that template attached. Review which memberships use the template before making changes to conversion ratios, as the updated ratios apply immediately to future redemptions.
Attach a template to a membership
Service equality templates only take effect once they are attached to a membership definition. You attach a template from within the membership itself, not from the Service equality templates page.
Go to Master data > Memberships and select the membership you want to configure.
The membership opens directly in edit mode.
In the membership wizard, navigate to the service credits top-level tab.
Enable the Allow Service Replacement? toggle.
In the Service Equality Template selector that appears, choose the template you want to attach.
Select Save (or proceed through the remaining tabs and select Finish).
Note: The Allow Service Replacement? toggle and the Service Equality Template selector are located in the service credits top-level tab of the membership wizard. These settings are per-membership β each membership can have a different template, or none at all.
Tips
- Reuse templates across memberships. A single service equality template can be attached to multiple memberships. If several memberships share the same substitution rules, create one template and attach it to all of them rather than duplicating the configuration.
- Name templates descriptively. Use names that reflect the substitution logic (for example, "Haircut Upgrade Options" or "Facial Credit Exchanges") so that administrators can quickly identify the right template when configuring a membership.
- Unattached templates are inert. If you create a template but do not attach it to any membership, it has no effect on redemption behavior. You can safely create and refine templates before attaching them.
- Review memberships before editing a shared template. Because one template can be attached to multiple memberships, changes to conversion ratios affect all memberships using that template. Identify all affected memberships before saving edits.
- Verify service availability. Ensure that both the source service and the substitute service are active and available at the centers where the membership is sold. A substitution mapping that references an inactive service will not be usable at redemption.
Troubleshooting
| Problem | Likely cause | Resolution |
|---|---|---|
| The Allow Service Replacement? toggle does not appear on the membership | The membership is not configured for service credits | Confirm that the service credits top-level tab is available on this membership. The toggle only appears when service credits are enabled for the membership. |
| A template is not listed in the Service Equality Template selector | The template may not have been saved, or the page needs to be refreshed | Return to Configuration > Memberships > Service equality templates and confirm the template exists and is saved. Then reload the membership edit page and check the selector again. |
| Members cannot redeem a substitute service at checkout | The template is not attached to the membership, or the Allow Service Replacement? toggle is off | Open the membership definition, navigate to the service credits top-level tab, and confirm that Allow Service Replacement? is enabled and the correct template is selected. |
| A substitution mapping is not available to a member at a specific center | The substitute service may be inactive or unavailable at that center | Verify that the substitute service is active and assigned to the relevant center in the service master data. |
| Editing a template's conversion ratio did not update redemption behavior | The membership may be caching the previous template state | Ask the member to attempt redemption again after a short wait. If the issue persists, confirm that the template is still attached to the membership and that the correct template version is saved. |