> ## Documentation Index
> Fetch the complete documentation index at: https://bookingspotapp.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the Booking selector in Shopify

> Create a dedicated product template, add the Booking selector, choose Button or Embed, and assign it to products.

Use **Booking selector** on appointment product pages. It finds the Booking Spot service linked to the current product automatically. Customers choose an available time before continuing.

You need a connected Booking Spot workspace, at least one active service and professional, **Accept appointments** enabled, and a theme that supports app blocks. Set up the service and product with the [Shopify getting-started guide](https://bookingspotapp.com/docs/getting-started/shopify.md).

## Create a booking product template

**1. Choose the theme**

Open **Set up Booking Spot → Shopify**, or **Settings → Shopify storefront** after onboarding. Choose **Theme to set up**. **Live** is the published theme; **Draft** affects preview only. Click **Open theme editor**. The refresh button reloads the theme choices.

**2. Create a separate product template**

At the top of Shopify's theme editor, open the page selector, choose **Products → Create template**, name it `booking-spot`, and base it on **Default product**. Save. Return to Booking Spot, click **Refresh templates** and select it under **Booking product template**.

**3. Add Booking selector**

Click **Add Booking selector**. Shopify opens the selected product template with the block ready to preview. Choose **Display → Embed** to show the calendar on the page, or **Button** to open a booking dialog. In Button mode, optionally enter **Button label**. Click **Save** in Shopify.

To add it manually, use **Add block → Apps → Booking selector** in a supported product section. If the product section cannot accept app blocks, use **Add section → Apps**. Drag the block where you want it and save.

**4. Replace the usual purchase controls**

On the booking template, hide or remove **Price**, **Quantity selector** and **Buy buttons**, including Add to cart and Buy it now. Turn off sticky purchase controls for this template if your theme has them. You can hide the variant picker when the booking widget handles your appointment options. Keep the title, description and images.

Keep the actual Shopify variant prices. Hiding a theme Price block does not remove or change the price charged at checkout.

**5. Confirm, design and publish**

Back in onboarding, confirm **I saved the Booking selector in this product template**, then continue to Design. Click **Publish** there and select the same **Product template** in the product options. Review and publish the service product.

After onboarding, open **Services → \[service] → Shopify settings** to select the template and **Review update → Update product**. For a manually linked product, set **Theme template** on the product in Shopify Admin, then save.

![Shopify storefront installation guide with the theme selection circled.](https://mintcdn.com/booking-spot/2EJbXjxHT-JWnMMf/assets/screenshots/shopify-selector-setup.png?fit=max\&auto=format\&n=2EJbXjxHT-JWnMMf\&q=85\&s=5b3f05d062f86c66d2380cf8ab18d1fa)

Choose the theme, create its product template, then add the selector. The highlighted theme controls choose where the changes are made.

> [!WARNING]
>
> A template change affects every product assigned to it. Keep appointment products on `booking-spot` and ordinary merchandise on its existing template. A template made only in a draft theme will not appear in the live theme's product-template choices until that theme/template is available there.

## Booking selector options

| Shopify block setting | Choices and effect |
| - | - |
| **Display** | **Embed** (default): calendar appears inline. **Button**: opens the same calendar in a dialog. |
| **Button label** | Only appears for Button mode. Enter the action text, or leave blank for the translated calendar label. The built-in English label is Book an appointment. |

The selector has no title, calendar URL or Booking page ID fields. The current product ID and store connection find the service; widget branding and language come from **Booking Spot → Widget**. With one service and professional, [booking-flow shortcuts](https://bookingspotapp.com/docs/booking-pages/widget.md#choose-your-booking-flow) can start at the date/time picker.

## Preview the right product

In the Shopify theme editor, use **Preview → Change** to choose a product linked to a Booking Spot service. Previewing a template does not assign it to that product. Save the template and product assignment separately.

On the storefront, check:

* The selector appears on the intended appointment product.
* It shows only services/options linked to that product.
* Choosing a time reaches the expected review and checkout/cart flow.
* Required waivers and policy consent remain visible.
* Desktop and mobile both work, and ordinary merchandise retains its normal purchase controls.

In collection grids or featured-product sections, disable **Quick add** for appointment products where your theme permits it, so customers open the product page to select a time. A direct product or POS sale without the selector does not reserve an appointment.

The setup checkmarks record your confirmation, not an automatic inspection of Shopify theme changes. Onboarding saves choices with the workspace; the separate Settings guide saves checkmarks in that browser for the chosen theme, template and product.

## Add an appointment calendar to a page

Use **Appointment calendar** for a general calendar on your homepage or a dedicated booking page. Open that page in the theme editor, choose **Add block → Apps → Appointment calendar** or an Apps section, then save. This block shows your business calendar rather than restricting it to the current product.

| Appointment calendar setting | What to enter |
| - | - |
| **Calendar title** | The accessible iframe title. Default: Book an appointment. It is not a separate visible page heading. |
| **Booking page ID override** (Advanced) | Leave blank for automatic discovery. Only enter a Booking Spot public page ID if support asks you to target a specific calendar. |
| **Calendar URL override** (Advanced) | Leave blank to use the Booking Spot widget. Use only with guidance from support; ordinary setup needs no URL. |

**Embed** in Booking selector is a display choice, not Shopify's separate App embeds panel. Both Booking Spot tools here are **app blocks**. [Shopify explains how to add and move app blocks](https://help.shopify.com/en/manual/online-store/themes/customizing-themes/apps).

## Change themes or remove a block

When changing the live theme, add the booking template and block to the new theme and verify the product assignment again. To remove the selector, select it in the theme editor, choose **Remove block** and save. Do not leave a bookable product with a normal purchase button that bypasses time selection.

## Troubleshoot the selector

| Problem | What to check |
| - | - |
| The install shortcut is missing | Create and select a separate JSON product template first. Use a compatible theme. |
| The selector is blank | Enable Accept appointments, make the service active, assign a working professional, and link the service to the current product. |
| The widget appears only in preview | Save the block; use the template in the live theme and assign it to the product. |
| The template is missing | Refresh templates for the selected theme. Product assignment uses templates from the live theme. |
| No service matches this product | Check **Services → Shopify settings** for the product/variant link. Test a linked product, rather than a random preview product. |
| Add to cart does not use the store cart | Load the actual storefront app block and choose Add to cart in **Settings → Payments**. Hosted pages and private waitlist offers go directly to checkout. |

[Shopify's template guide](https://help.shopify.com/en/manual/online-store/themes/theme-structure/templates) covers creating, previewing and assigning templates. See [Shopify payment setup](https://bookingspotapp.com/docs/payments/shopify.md) for product options and paid tests.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.