Configure allergy test for services
Set up allergy testing for services that require confirmation of guest suitability before they can be performed. When enabled, the system prompts providers to confirm allergy-test results during the appointment workflow.
Previously documented as "contraindications". The settings in Zenoti are labelled Allergy Test; earlier versions of this article used "contraindications" for the same feature.
Note: For conceptual background on the services catalog, see Services overview.
Before you begin
You need the following permissions:
Permission: Edit (under Services in the Administrator section) — required to configure allergy-test settings and associate them with services.
Enable Allergy Test Confirmation must be on at organization scope (Configuration > Services). For center-specific enablement, Enable Allergy Test must also be on at the center level.
Identify which services in your catalog require an allergy test before they can be performed (for example, chemical peels, hair color treatments, lash extensions).
On this page
- How allergy tests work
- Enable Allergy Test Confirmation
- Configure allergy-test parameters
- Associate allergy tests with services
- Provider workflow during appointments
- Tips
- Troubleshooting
- Related articles
How allergy tests work
When allergy tests are enabled and a service is associated with an allergy-test requirement:
- A guest books the service.
- During the appointment workflow, the system checks the guest's records for a valid (non-expired) allergy-test result.
- If no valid result exists, the system presents an allergy-test confirmation popup to the provider.
- The provider records the result: Yes (check passed), Failed (check did not pass), or Pending (results not yet available).
- The provider can optionally add comments with the result.
- The result is stored in the guest's records and linked to the related service.
If the guest already has a non-expired allergy-test result on file, the system skips the confirmation popup and the appointment proceeds normally.
Steps
Enable Allergy Test Confirmation
At the organization level
- Navigate to Configuration > Services with the scope selector set to your organization.
- Locate the Enable Allergy Test Confirmation toggle.
- Turn the toggle On.
- Click Save.
This enables allergy tests across all centers in your organization.
At the center level
Individual centers can enable or disable allergy tests independently, allowing different centers to opt in or out based on their service offerings:
- Navigate to Configuration > Services with the scope selector set to the center. The Enable Allergy Test row appears only after Enable Allergy Test Confirmation is turned on at organization scope.
- Locate the Enable Allergy Test toggle.
- Turn the toggle On or Off as needed.
- Click Save.
The center-level toggle can override the organization-level setting, giving you flexibility to enable allergy tests only at centers that offer applicable services.
Configure allergy-test parameters
Navigate to Configuration > Services > Allergy Test Configuration (organization scope). The row appears only after Enable Allergy Test Confirmation is turned on.
Configure the following settings:
Field Description Result expiry days The number of days after which a previous allergy-test result is no longer considered valid. After this period, the guest must complete a new test. Question label The customizable prompt text displayed to providers in the allergy-test confirmation popup. Response labels Customize the labels for each result option (Yes, Failed, Pending) to match your organization's terminology. Click Save.
Tip: A worked example — set Result expiry days to 60, set Question label to "Has the guest completed an allergy test for this service within the last 60 days?", and leave the response labels as Yes, Failed, and Pending. This configuration is appropriate for most chemical or dye-based treatments.
Associate allergy tests with services
- Navigate to Master data > Services.
- Open the service details page for the service that requires an allergy test.
- Locate the Allergy Test section.
- Enable the allergy-test requirement for this service.
- Click Save.
Repeat for each service that requires an allergy test before it can be performed.
Provider workflow during appointments
When a provider starts an appointment for a service with an allergy-test requirement:
The system checks the guest's records for a valid allergy-test result.
If a valid (non-expired) result exists, the appointment proceeds without interruption.
If no valid result exists, the allergy-test confirmation popup appears with the following options:
Option Description Yes The test was performed and the guest passed (no reaction found). Failed The test was performed and a reaction was identified. Pending The test was performed but results are not yet available. The provider selects the appropriate result and optionally adds comments.
The result is saved to the guest's records.
Tips
- Set the Result expiry days based on your industry standards and local regulations. Common expiry periods range from 30 to 365 days depending on the type of treatment.
- Customize the Question label to be clear and specific. For example, "Has the guest completed an allergy test for this treatment within the last 6 months?" is more helpful than a generic prompt.
- Train providers to understand why the allergy-test confirmation popup appears and what each result option means. The system checks for existing valid results automatically, but providers should be prepared to record a result when prompted.
- For services that require specific test types (for example, a 48-hour skin sensitivity test for hair color versus an immediate reaction test for a chemical peel), consider creating separate Allergy Test Configurations with appropriate expiry periods.
- Review your allergy-test associations when adding new services to the catalog. Any new service involving chemicals, dyes, or potential allergens should be evaluated for allergy-test requirements.
- Use the center-level toggle to manage allergy tests at locations that specialize in treatments requiring them, without affecting centers that do not offer those services.
Troubleshooting
The allergy-test confirmation popup does not appear during an appointment.
- Confirm that the Enable Allergy Test Confirmation toggle is turned on at the organization level.
- Confirm that the Enable Allergy Test toggle is turned on at the center level for the center where the appointment is taking place.
- Verify that the service is associated with an allergy-test requirement. Open the service in Master data > Services and check that the Allergy Test section has the requirement enabled.
- Check whether the guest already has a valid (non-expired) allergy-test result on file. If the result has not yet passed the configured Result expiry days, the system skips the popup and proceeds normally.
The allergy-test result is not being saved to the guest's records.
- Ensure the provider selected one of the three result options (Yes, Failed, or Pending) before dismissing the popup. The result is only saved when a selection is made.
- Confirm that the provider has the necessary permissions to update guest records. Contact your administrator if the provider is unable to record results.
The allergy test popup appears even though the guest completed a check recently.
- Check the Result expiry days setting in the Allergy Test Configuration. If the configured expiry period is shorter than the time since the guest's last check, the previous result is treated as expired and a new check is required.
- Verify that the previous result was recorded against the same service. Results are linked to the related service; a result recorded for a different service does not satisfy the requirement for the current service.