Guides

Widget & styling

Customize the hosted booking experience with widget configs in the dashboard-colors, copy, flow, and allowed resources.

Widget configurations

In the dashboard, create one or more widget configs per tenant. Each stores theme JSON (light/dark palettes, typography, radii), flow steps, field definitions, verification mode, and optional resource allow-lists. Set a default config for embeds.

The embed page loads config via GET /api/widget/config using your publishable key and widget id.

Hosted embed URL

Pattern

https://YOUR_APP_URL/embed/TENANT_UUID?key=zentier_publishable_xxx&widget=WIDGET_CONFIG_UUID

Additional query parameters may apply depending on your implementation (e.g. pre-selected resource). See the embed page source for supported options.

Headless / full custom UI

Skip the iframe entirely: call /api/widget/availability and /api/widget/booking from your design system. You own every pixel; Zentier enforces business rules and payments on the server.

No theme query shortcut

Styling is driven by stored widget config JSON, not a single ?theme=dark toggle. Use the dashboard editor or PATCH the config via the API.