Accessibility β Alt Text for Webstore Images
Zenoti's Webstore renders descriptive alt text on images so that screen readers can convey the purpose of each image to visually impaired guests. This article explains how to add and manage alt text for banners, background images, and promotional content in the Webstore admin interface.
Audience: Webstore administrators who configure images and promotional content in the Zenoti admin portal.
On this page
Before you begin
- You must have access to the Zenoti admin portal with permission to configure Webstore template settings.
- Confirm that the images you want to update are already uploaded and in use in the Webstore template (banners, background images, or promotional content).
- After saving changes, allow up to 30 minutes for the cache to clear before the updated alt text appears on the guest-facing Webstore.
Steps
Add alt text to a Webstore banner or promotional image
- In the Zenoti admin portal, navigate to Configuration > Online booking > Online booking settings > Webstore V2.
- Locate the section for the image you want to update β for example, a banner, background image, or promotional content block.
- Select the image entry to open its configuration.
- In the alt text field associated with the image, enter a description that conveys the purpose or content of the image:
- For a promotional banner, describe the offer shown β for example: "Refer a Friend promotion: Give $50, Get $50 on your next service."
- For a background image, describe the scene or context β for example: "Relaxing spa treatment room with soft lighting."
- For a general decorative image where no meaningful content is conveyed, you may leave the field empty; the Webstore will omit the
altattribute in that case, which is the correct accessibility pattern for purely decorative images.
- Select Save to apply the change.
Note: Changes may take up to 30 minutes to appear on the guest-facing Webstore due to cache invalidation.
Verify alt text renders on the guest-facing Webstore
After saving, confirm that the alt text is rendering correctly in the guest-facing HTML:
- Open the Webstore in a browser.
- Navigate to the page that displays the image you updated.
- Right-click the image and select Inspect (or use your browser's developer tools).
- Confirm that the
<img>element includes analtattribute whose value matches the text you entered in the admin portal.
Important: The Webstore renders the configured alt text as the
altattribute on the corresponding<img>element, consistent with WCAG 2.1 Level AA requirements. If thealtattribute is missing or empty for a non-decorative image, screen readers cannot convey the image's purpose to visually impaired guests.
Worked example
Example: Your center is running a referral promotion. You upload a banner image showing the promotion details. In the alt text field for that banner, you enter:
"Refer a Friend promotion: Give $50, Get $50 on your next service."
After saving and waiting for the cache to clear, a guest using a screen reader who visits the Webstore will hear this description read aloud when their screen reader encounters the banner image.
Tips
- Write alt text for the offer, not the image. For promotional banners, describe what the promotion is β not the visual design. "20% off all facials this weekend" is more useful to a screen reader user than "colorful banner with text."
- Keep alt text concise but complete. Aim for one to two sentences. Include the key information a sighted guest would get from glancing at the image.
- Review alt text whenever you update an image. If you replace a banner image with a new promotion, update the alt text at the same time so it stays accurate.
- Test with a screen reader periodically. Browser developer tools confirm the
altattribute is present, but testing with an actual screen reader (such as NVDA, JAWS, or VoiceOver) confirms the experience for visually impaired guests. - Decorative images do not need alt text. If an image is purely decorative and conveys no information, leaving the alt text field empty is correct. The Webstore will render the image without an
altattribute, which tells screen readers to skip it.
Troubleshooting
| Problem | Resolution |
|---|---|
| Alt text saved in the admin portal is not appearing on the Webstore | Wait up to 30 minutes for the cache to clear. Changes are not applied immediately after saving. |
The alt attribute is present in the HTML but contains the wrong text |
Return to Configuration > Online booking > Online booking settings > Webstore V2, locate the image entry, and verify the alt text field contains the correct description. Save again if needed. |
The alt attribute is missing entirely from a non-decorative image |
Confirm that the alt text field was not left blank for a content image. Open the image configuration in the Webstore V2 template and enter a description, then save. |