Slotstack Docs

OpenAPI Spec

Quickstart

Add a single script tag to any website. No build step required.

<script type="module" src="https://slotstack.io/widget/v1/slotstack-widget.mjs"></script>
<slotstack-booking tenant="your-slug"></slotstack-booking>

Available Widgets

ElementDescription
<slotstack-booking>Full booking schedule and checkout flow
<slotstack-calendar>Weekly calendar grid with booking
<slotstack-classes>Class catalog with images, categories, pricing
<slotstack-my-bookings>Customer's upcoming and past bookings (OTP login)
<slotstack-class-passes>Class pass purchase
<slotstack-gift-cards>Gift card purchase and balance check
<slotstack-shop>Unified storefront (passes, gift cards, subscriptions)
<slotstack-private-lessons>Private lesson booking with instructor selection

Platform Guides

  1. 1. Add the script tag to your HTML <head> or before the closing </body>
  2. 2. Place the widget element where you want it to render
  3. 3. Replace your-slug with your tenant slug

Troubleshooting

Widget not loading

Make sure both the <script> tag and the custom element are present. Some platforms strip script tags from certain block types.

CORS or security errors

The widget loads from your Slotstack domain. Allow scripts from slotstack.io in your site's security settings. Wix and Squarespace handle this automatically.

Widget shows "No classes found"

Create at least one class with upcoming schedule slots in your Slotstack studio dashboard.

Styling looks broken

The widget uses Shadow DOM for style isolation. If it appears too narrow, give the parent container more width.