ZenotiHelp

Webstore initialization and configuration

ZTZenoti Docs Team Updated October 25, 2026 13 min readGuide

Configure how the Zenoti Webstore loads and resolves your organization and center settings so that guests see the correct catalog, pricing, and branding from the moment they arrive.

Audience: Organization administrators who are setting up or maintaining the Webstore for their centers.


On this page


Before you begin

  • You need configuration access in the Zenoti admin portal.
  • Ensure that at least one center has online booking enabled.
  • Verify that each center has its locale, currency, and operating hours configured.

Permission: Configuration access in the Zenoti admin portal is required to modify Webstore template settings, center-level overrides, and feature toggles.

Key terms

The Webstore configuration has a three-layer hierarchy. Always identify which layer a setting lives in when configuring or troubleshooting.

Term Definition
CX V3 template The customer-experience template hosting cross-channel settings (announcement banner, button colors, dark mode, and other customer-experience controls). Configured at Configuration > Online booking > Online booking settings > CX V3. This is the first layer. See Configure the CX V3 template.
Webstore V2 template The customer-facing Webstore branding, layout, feature toggles, and labels. Configured at Configuration > Online booking > Online booking settings > Webstore V2. This is the second layer, applied on top of the CX V3 template.
Center-Level Configuration Per-center overrides applied on top of the organization-level template. Multi-location businesses use center-level overrides to apply per-location branding, deposit policies, announcement banners, or feature toggles. This is the third layer.
Guest Profile The guest's account on the Webstore, including card on file references, loyalty balance, membership status, and family members.
Webstore V1 The older storefront variant. When navigating to Configuration > Online booking > Online booking settings, the variant chooser presents three thumbnail cards: Webstore V1, Webstore V2, and CX V3. Select the card that matches the storefront your organization uses.

Webstore capabilities (overview)

The Webstore supports the following guest-facing capabilities, each toggleable in the Webstore V2 template:

  • Service booking with provider selection, time slot selection, and add-ons
  • Membership browsing, purchase, and self-service management (freeze, cancel, upgrade, downgrade)
  • Series package and day package purchase
  • Gift card purchase (digital eGift, text, and physical card fulfillment) and balance check
  • Fitness class and workshop enrollment
  • Amenity booking (facility resources without a service provider)
  • Waitlist and queue
  • Coupons, referral codes, and time-based deals
  • Custom intake forms and patch test result tracking
  • Quotes (consultation requests with sign-and-convert flow)
  • Multi-language support per center
  • Marketing attribution via UTM tracking, GA4, Google Tag Manager, and Reserve with Google

Prerequisites before enabling the Webstore

Before guests can browse and book on the Webstore, the following six tenant-side configurations must be in place at the center level. Missing any of these results in an empty storefront, "no provider available" errors, or "no time slots available" errors at runtime.

# Prerequisite Where to configure
1 Employee Schedule β€” providers have schedules configured in their employee profiles Front desk β†’ Employee profile β†’ Schedule
2 Employee Catalog β€” providers are marked Available Online and assigned to the services they provide Employees β†’ Provider profile β†’ Online availability
3 Service Catalog β€” services are marked for online booking and assigned to displayable categories Services β†’ Service settings β†’ Online booking
4 Center Hours β€” center operating hours are defined Configuration β†’ Centers β†’ Center hours
5 Room Selection β€” rooms configured if room assignment is mandatory for any service Configuration β†’ Centers β†’ Rooms
6 Block Out Time β€” exception blocks (holidays, training time) are recorded Front desk β†’ Block out time

Important: All six prerequisites must be satisfied before the Webstore can serve bookings. A center that is missing even one of these will present guests with an empty or non-functional storefront.

  1. Verify all six prerequisites above are configured at each center that will accept Webstore bookings.
  2. Enable Webstore on the centers β€” in the center configuration, set the online booking status to enabled.
  3. Select your storefront variant β€” navigate to Configuration > Online booking > Online booking settings and select the appropriate card from the variant chooser (Webstore V1, Webstore V2, or CX V3). Most new implementations use Webstore V2.
  4. Configure the CX V3 template at Configuration > Online booking > Online booking settings > CX V3 for cross-channel settings (announcement banner, button colors). See Configure the CX V3 template.
  5. Configure the Webstore V2 template at Configuration > Online booking > Online booking settings > Webstore V2 β€” branding, labels, feature toggles, group booking, loyalty, referral, and payments. See Template and branding settings.
  6. Configure center-level overrides for any per-location customization (different branding, deposit policies, banners). Center-level settings take precedence over organization-level template settings for that location.

Tip: Work through the setup sequence in order. Configuring the Webstore V2 template before the center prerequisites are in place will result in a storefront that loads correctly but shows no bookable services.

Worked example: A spa organization with three centers β€” Downtown, Uptown, and Airport β€” completes the six prerequisites for all three centers, then configures a shared Webstore V2 template with the organization logo and brand colors. The Airport center uses a center-level override to display a different announcement banner and a shorter online booking window to reflect its airport-hours schedule.

How initialization works

When a guest opens your Webstore URL, the system performs these steps automatically:

  1. Organization configuration β€” The system loads your organization-wide settings, including template branding, feature toggles, and display labels.

  2. Center resolution β€” The system determines which center to display based on the URL path or domain mapping.

  3. Center-specific settings β€” Once the center is resolved, the system loads that center's locale, currency, operating hours, service catalog, available providers, and pricing.

  4. Feature modules β€” The system loads only the feature modules needed for the current page, optimizing initial page load time.

  5. Error handling β€” If initialization fails or required configuration is unavailable, the system displays an error page with the heading Our page is down and instructs guests to contact the center directly.

Note: Changes to center configuration or template settings may take up to 30 minutes to propagate to the live Webstore due to cache invalidation. The admin portal displays a confirmation message with the expected propagation time after you save changes.

Configure center context

Each center has its own Webstore context. When a guest switches centers, the entire catalog refreshes β€” services, providers, time slots, memberships, packages, and pricing all update to reflect the newly selected center.

Key center-level settings

Setting Description
Locale The language and regional formatting for the center.
Currency The currency symbol and ISO code used for pricing display.
Operating hours The hours during which the center accepts online bookings.
Online booking status Whether the center is open for online booking.

Note: Webstore booking hours operate independently of the center's general business hours. A center may have different hours for walk-in guests and for online bookings. Always verify the online booking hours separately when troubleshooting availability issues.

Steps

  1. Navigate to Configuration > Online booking > Online booking settings > Webstore V2.
  2. Select the center you want to configure.
  3. Update the locale, currency, operating hours, and online booking status as needed.
  4. Select Save.

Configure feature toggles

Feature toggles control which capabilities appear in the Webstore for your guests. All toggles are configured in the Webstore V2 template at Configuration > Online booking > Online booking settings > Webstore V2.

The following toggles are available in the Display Settings and related sections:

Toggle What it controls
Enable Membership Sales Shows or hides the memberships section for guests.
Enable Series Package Sales Shows or hides series package purchase options.
Gift cards visibility Shows or hides gift card purchase and balance check.
Classes and workshops visibility Shows or hides fitness class and workshop enrollment.
Amenity booking visibility Shows or hides amenity booking (facility resources).
Deals Shows or hides time-based deals and promotional offers.
Family booking enabled Allows guests to book services for family members in a single flow.
Enable Group Booking Allows guests to book services for a group in a single flow.
Continue as guest (guest checkout) enabled Allows guests to purchase gift cards without signing in or signing up.
Provider selection enabled When enabled, guests choose their preferred provider. When disabled, the booking flow auto-assigns a provider and skips the selection step.
Allow Guest To Select Gender Specific Therapist Shows or hides the Any Female Provider and Any Male Provider filter options during provider selection. A dependent Force Gender Selection toggle appears beneath it when this option is enabled.

Configure authentication settings

Sign-in and sign-up settings control how guests sign in or sign up on the Webstore. They are configured in the Guest Login & Sign up accordion of the Webstore V2 template at Configuration > Online booking > Online booking settings > Webstore V2 (for example Mandate OTP for sign-up, Register without password); social-login credentials are entered under Social Login Settings on the combined Online booking settings form (see Configure social logins for the Webstore).

Setting Description
Mandate OTP for sign-up When enabled, guests verify their identity with a one-time code sent by SMS during sign-up.
Register without password When enabled, guests can create an account without setting a password, using OTP verification instead.
Google OAuth client ID The client ID from your Google API Console project, used for Google sign-in.
SSO redirect URL The redirect URL for organizations using an external identity provider for single sign-on.

Note: Apple Sign-In is not supported. Do not configure or communicate Apple Sign-In availability to guests.

For step-by-step instructions on configuring Google OAuth and Facebook social login credentials, see Configure social logins for the Webstore.

Configure payment processor settings

Payment processor settings are configured at the center level. Different centers may use different processors depending on their region.

Setting Description
Configured processor The payment processor active for this center: Stripe, Adyen, EGHL, CloudPayments, Freedompay, or BBVA.
CAPTCHA provider The CAPTCHA service used to protect payment actions: Google reCAPTCHA v2 (invisible) or Cloudflare Turnstile.

Important: CAPTCHA runs on every payment attempt when enabled β€” it is not triggered only by suspicious behavior. This applies to new card entry, card on file, and all payment actions. If CAPTCHA verification fails, the guest can retry immediately with no lockout or cooldown period. Payment processing is secure and PCI-compliant; no raw card data is stored in Zenoti.

For organization and center-level payment processor configuration, see organization and center settings.

Configure the announcement banner

The announcement banner is an optional message displayed at the top of the Webstore. It is configured in the Announcement banner section of the CX V3 template at Configuration > Online booking > Online booking settings > CX V3.

Field Description
Banner message The text displayed in the banner.
Schedule The date and time range during which the banner is shown.
Styling The visual appearance of the banner (colors, font).

Configure the cancellation policy

The cancellation policy that applies to Webstore bookings is set at the center level, not in the Webstore template. The same policy applies across the Webstore, the Zenoti Mobile App (ZMA), and the Point of Sale for that center.

To configure the cancellation policy for a center:

  1. Navigate to Configuration > Business details > Zones and centers > Centers.
  2. Select the center.
  3. Select the Booking Policy tab.
  4. Update the Cancellation Policy fields (cancellation window, fees, and policy text).
  5. Select Save.

To customize how the cancellation policy text appears on the Webstore, update the relevant fields in the Labels & Text Configuration section of the Webstore V2 template at Configuration > Online booking > Online booking settings > Webstore V2.

Configure the card on file requirement

The card on file requirement controls whether guests must have a saved payment method to complete a booking. This setting is configured on the combined Online booking settings form, reached from Configuration > Online booking > Online booking settings > CX V3.

The control offers three options:

Option Behavior
Not required Guests can book without a card on file. No warning is shown.
Warn if not on file Guests without a card on file see a warning during booking but can still proceed.
Block if not on file Only guests with a card on file can complete a booking. Guests without one cannot proceed.

Configure the Global Privacy Control setting

The Read and Honour Global privacy control toggle is located under the PRIVACY CONTROL heading on the combined Online booking settings form at Configuration > Online booking > Online booking settings > CX V3.

Important: This toggle is off by default. Organizations serving guests in California or other jurisdictions where the Global Privacy Control signal carries legal weight under applicable privacy regulations should evaluate whether to enable this setting. When the toggle is off, the Webstore does not honor the browser's Global Privacy Control signal.

This setting is organization-level. It applies to the Webstore only (not to other channels).

Multi-center support

If your organization operates multiple centers, guests can switch between centers while staying in the same Webstore session. When a guest changes the center:

  • The service catalog reloads with services available at the new center.
  • Provider lists update to show providers at the new center.
  • Time slot availability reflects the new center's schedule.
  • Membership, package, and gift card offerings update.
  • Pricing and currency may change based on the new center's configuration.

Note: Changes to center configuration or template settings may take up to 30 minutes to propagate to the Webstore due to cache invalidation.

Tips

  • Complete prerequisites before configuring templates. The six center-level prerequisites (employee schedule, employee catalog, service catalog, center hours, room selection, block out time) must be in place before the Webstore can serve bookings. Configuring branding and feature toggles first will not make the storefront functional if the underlying catalog data is missing.
  • Use center-level overrides for location-specific needs. If one center has different operating hours, a different announcement banner, or a different deposit policy, configure those differences as center-level overrides rather than changing the organization-level template. This keeps your shared branding consistent while allowing per-location flexibility.
  • Always identify which configuration layer a setting belongs to. The three-layer hierarchy β€” CX V3 template, Webstore V2 template, and center-level overrides β€” determines where a setting is configured and which layer takes precedence. Center-level overrides always win over organization-level template settings for that location.
  • Allow 30 minutes after saving changes. Template and center configuration changes are not instant. After saving, wait up to 30 minutes for the cache to clear before verifying the Webstore reflects your updates. Use a private or incognito browser window to avoid seeing a cached version.
  • Test with a guest account, not an admin account. After configuring feature toggles and branding, sign in to the Webstore as a guest to verify the experience. Admin portal access does not reflect the guest-facing view.
  • Disable provider selection only when auto-assignment is appropriate. When the provider selection toggle is off, the booking flow assigns a provider automatically and skips the selection step. Confirm that your scheduling rules support auto-assignment before disabling this toggle.
  • Verify online booking hours separately from business hours. The Webstore respects the online booking hours configured for each center, which may differ from the center's general walk-in hours. If guests report that the Webstore shows no availability during business hours, check the online booking hours in the center configuration.

Troubleshooting

Issue Resolution
Webstore displays Our page is down on load Verify that your organization configuration is complete and that at least one center has online booking enabled. Check that all six center-level prerequisites are satisfied.
Wrong center loads by default Check the URL path and domain mapping configuration for the center. Ensure the correct center is mapped to the Webstore URL or domain.
Settings changes are not visible on the Webstore Wait up to 30 minutes for cache invalidation, then refresh the Webstore in a private browser window to avoid seeing a cached version.
Guests see "no provider available" errors Verify that providers at the affected center are marked Available Online and are assigned to the services being booked. Check that provider schedules are configured for the relevant dates.
Guests see "no time slots available" errors Confirm that center operating hours are defined and that provider schedules cover the requested booking window. Check that block out time entries are not covering the entire schedule. Also confirm that the center's online booking hours are configured separately from general business hours, as these are independent settings.
Feature section (memberships, gift cards, classes) does not appear Confirm the corresponding feature toggle is enabled in the Webstore V2 template at Configuration > Online booking > Online booking settings > Webstore V2.
Cancellation policy text on the Webstore does not match expectations Verify the Cancellation Policy fields at Configuration > Business details > Zones and centers > Centers > [center] > Booking Policy. For Webstore-specific wording overrides, check the Labels & Text Configuration section of the Webstore V2 template at Configuration > Online booking > Online booking settings > Webstore V2.
Variant chooser shows the wrong storefront type selected Navigate to Configuration > Online booking > Online booking settings and confirm the correct variant card (Webstore V1, Webstore V2, or CX V3) is selected for your organization.
Card on file requirement is blocking guests unexpectedly Check the card on file requirement setting on the combined Online booking settings form at Configuration > Online booking > Online booking settings > CX V3. Confirm whether Block if not on file is selected and adjust to Warn if not on file or Not required as appropriate for your policy.
Was this article helpful?
Your feedback helps us improve our documentation.