Skip to main content

Publish (Widgets)

The Publish screen manages widgets — embeddable components that let you display Zooza booking forms, calendars, profiles, and more on your website. Use it to create widgets, configure embed codes, and customize each widget type.

Navigation: Go to Team & Settings → Publish.

Publish widgets

Publish Zooza to Your Website​

Introductory guidance:

  • Your programmes are automatically available through booking and profile links generated by Zooza — at zooza.site/your-account-name/register and /calendar, with no setup. Use them as a bridge until the widget is on your own site: see One link with everything you offer.
  • Embed programmes directly on your website for better tracking, SEO, and brand visibility.
  • Adding forms is as simple as embedding a Google Map — copy the script and paste it.
  • Using WordPress? Install the Zooza plugin for easier setup.

Links: Step-by-step guide and Advanced customization for developers.

Widgets​

Lists all created widgets. Each shows:

FieldDescription
NameWidget name with ID (e.g. "www.playfulmotion.co.uk (beefa84de7)"). Clickable link to detail.

Button: Create — create a new widget.

Widget Detail​

Navigation: Publish → click a widget name.

Integration Type​

OptionDescription
WixUse the Zooza app for Wix.
WordpressUse the Zooza WordPress plugin.
EmbedManual embed using a script tag.

Wix Integration​

Widget detail — Wix

Installation steps:

  1. Install the Zooza app on Wix (link provided).
  2. Get your API key from Zooza.
  3. Connect the widget in Wix — paste the API key in the Wix Editor settings panel.
FieldDescription
API keyYour widget's unique API key.

Embed Integration​

For the Embed option, the detail shows:

Embed Code​

First pick how you are putting the widget on your site, under Choose your integration: Wix, Wordpress, NPM package (React, Vue, Svelte, Web Component) or Embed.

Embed then offers tabs for each widget type: Booking form, Calendar / Class, Profile, View videos, Sales form, Map, Contact form, each with its own code and a Copy button.

FieldDescription
Embed methodBody only — one snippet, paste it where the widget should appear. Head + body (loads faster) — a second snippet goes in the page <head> so the widget starts loading sooner.
Deployment URL of the widgetThe page the widget is deployed on. You can embed as many copies as you like, as long as at least one lives on this URL. To change it, use the widget's own settings.
Installation instructionsHow to place the embed code on your website.
Customize embed codeOpens the three fields below.
Choose programmesChoose picks which programmes appear in this copy of the form. Selected programmes: 0 means all of them.
Select venuesSame for venues. Selected venues: 0 means all of them.
Multi step bookingCheck Yes to split the booking form into separate steps — programme selection, personal details and so on — instead of one long page.

Filters for visitors are a Calendar widget setting, not an embed one. Show programme filtering, Show filter by programme, Show filter by programme type, View filtering by venue and View filtering by instructor all live in the Calendar widget's own configuration, and only affect the calendar.

JavaScript apps: picking NPM package generates npm install snippets for React, Vue, Svelte and Web Components. If your site is built as a JavaScript app, use these instead of the raw script — see Deploying widgets in a JavaScript app.

Customize Section​

FieldDescription
URL to widgetDomain where the widget will be published.

Available widget types:

WidgetDescription
Booking formUsed to enrol clients to your programmes.
Calendar / ScheduleShows all programmes/classes in a coherent calendar view.
ProfileUsed for clients to review and manage their programmes, sessions, and products.
View videosDisplays videos attached in programmes for enrolled clients.
Sales formUsed to sell products and services (t-shirts, videos, e-books, accommodation, insurance) to clients. Can be linked to the booking form and client profile.
MapDisplays all locations on a map and offers available timetables for online booking.
Contact formA contact form for your website. Every enquiry becomes a contact under Clients → Contacts. See Put the contact form on your website.

Each widget type has a Configure button to open its settings.

Two switches worth knowing about​

Both are per widget, behind that Configure button, and both were added in November 2026.

Profile widget — Show QR code in payments tab. A payment QR code appears beside each unpaid payment in the client's profile. Turn it off if you do not collect by bank transfer; for a company on card or direct debit it is a code nobody can use, which prompts the question rather than the payment.

Map widget — Show class list. The map lists the classes underneath it. Turn it off to use the map purely as a "where to find us" locator.

If you hide the list, the age filter goes with it in practice. The filter narrows the class list and nothing else, so with the list hidden it has nothing left to do. Zooza says so on the screen rather than letting you configure something that cannot take effect.

How free places are shown to clients​

Each widget decides for itself whether a remaining place is described in words ("a few places left") or as a number. If you have not chosen either, Zooza falls back to a rule that changes with how full the class is:

Places leftWhat the client sees
1last place
2 – 4a description in words
5 or morethe number

That fallback is why the same class can read "3 free places" in one widget and "5/11" in another — nothing is broken, the widgets simply have no instruction and each is reporting the current state in the form the rule picked.

To make it consistent, choose words or numbers explicitly in every widget, including the Profile widget under Team & Settings → Publish. Providers usually have more widgets than they remember: one per location or landing page, each with its own settings.

In a network, do it across the whole network. Otherwise clients comparing two branches are shown the same availability in two different styles, which reads as one branch being fuller than the other.

Contact form settings​

Open via Contact form → Configure.

FieldDescription
URLThe page where the contact form is placed. Its domain is allowed automatically.
Contact form configurationWhich configuration from Settings → General → Contact forms this widget shows. Company default shows your default configuration. A configuration named in the embed code takes precedence.
Additional domainsOther websites where the form may load, entered as bare domains such as example.com. Subdomains are covered automatically.
Use CSSLoads Zooza's minimal default styling, which your website's CSS overrides.

The Contact form embed tab offers Body only and Head + body placements. There is no legacy script snippet and no WordPress shortcode for this widget; on WordPress, paste the code into a Custom HTML block. One contact form per page.

Registration Form Settings​

Settings specific to the Booking Form widget type. Open via Booking form → Configure.

Course list display​

Controls how the list of Programmes is presented to the visitor before they choose one.

OptionDescription
Dropdown (default)Classic <select> menu — compact, works everywhere.
GridVisual card grid with programme names. Better for sites with many programmes or a visual layout.

When Grid is selected, an additional Columns setting appears (1–4). Choose how many cards appear per row.

Existing widgets keep the dropdown behaviour until you explicitly change this setting. New widgets default to Grid.

Place grouping (Merge rooms)​

When enabled, the widget shows one entry per location instead of listing individual rooms within a location. Clients see the place name; the room is determined automatically by the schedule they pick.

OptionDefault
Merge rooms checkboxOn for new widgets; Off for existing widgets (opt in to change)

To reset a registration widget to its defaults, use the Reset button. This will set Merge rooms to On.

Hide dates on block-based classes​

For classes that use Blocks (where sessions are split into separately purchasable blocks), the widget normally shows the parent class start date on the registration tile. This can be confusing when a client is choosing a specific Block — the date shown is for the whole class, not their selected Block.

Enable Hide dates on block-based classes to suppress that date from the tile for any class that has Blocks configured.

OptionDefault
Hide dates on block-based classes checkboxOff

Actions​

ButtonDescription
DeleteDelete this widget.
ResetReset widget settings to defaults.

Troubleshooting​

Why is a programme not showing in the widget?​

Work through this checklist in order:

  1. Online registration is off. Go to the programme → Settings → the Booking tile → Online booking and confirm that online registration is enabled. If it is off, the programme will not appear in the booking form widget.
  2. No active classes. A programme only appears in the widget if it has at least one class with active, upcoming sessions. If all classes have ended or are inactive, the programme is hidden.
  3. Programme is not selected in the widget. Open the widget in Publish → widget detail → Choose programmes. Confirm the programme is included in the widget's programme list.
  4. Billing period has ended. If the billing period for all classes has passed, the programme will not show as bookable.
  5. Widget is cached. After making changes, wait a few minutes and do a hard refresh (Ctrl+Shift+R or Cmd+Shift+R) before checking again.

Why is the Register button inactive or missing?​

SymptomLikely causeFix
Button shows "Register" but is greyed outClass is at full capacityIncrease class capacity or add a waiting list
Button shows "Express interest" instead of "Register"Online registration is closed but interest collection is onOpen online registration in programme settings
No button at allOnline registration is offEnable online registration in programme settings
Button works but shows errorClient is already registeredSystem prevents duplicate bookings

How to change the order of programmes in the widget​

Each programme has a Priority field that controls where it sits on the booking form. Go to Programmes → open the programme → Online Booking → Edit and set it. The range is 0–1000, and the default is 0, which sorts alphabetically.

A higher number is shown first. This is the part that catches people out: 1 does not mean "first in the list". To pull a programme to the top, give it the biggest number, not the smallest. The hint under the field says so, but it is easy to read past and assume the list is numbered 1, 2, 3.

Two other things affect what the visitor sees:

  • Choose programmes in the widget hides anything you do not select, whatever its priority.
  • Leaving everything at 0 keeps the list alphabetical, so renaming still works if you would rather not use priorities at all.

Priority orders programmes, not the classes inside them. There is no setting that reorders the class list within a programme. Put the day and time in the class names instead — see Booking form settings.

The Priority stepper in Online booking settings, set to 0, with the hint that a higher priority moves the programme up