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

# Set up appointments

> Offer customers bookable time slots—online or at one of your physical locations—and manage attendees once bookings come in.

Appointments let customers reserve a dedicated time slot instead of joining a queue or draw—ideal for in-store pickups, private viewings, or 1-on-1 consultations. You choose the date range, slot length, buffer between slots, and capacity per slot. Fanfare automatically generates bookable slots inside your location's opening hours (or Fanfare's default 9 AM–5 PM hours for online appointments).

> [!NOTE]
>
> Available on Growth and above. On Starter, **Appointment** displays an upgrade prompt in both the experience wizard and **Add Distribution**.

## Before you start

* **Create physical locations first:** If you're hosting in-person appointments, add the location—including its opening hours and time zone—before starting. You can't create a new location from the appointment picker. See [Locations and opening hours](https://docs.fanfare.io/guide/create/locations.md).
* **Finalize your slot setup before announcing:** The very first booking locks your slot duration, buffer, capacity, location, window, and time zone.

## Create an experience with appointments

Shared wizard steps and defaults are covered in [Create an experience](https://docs.fanfare.io/guide/create/experiences.md). Here's what's specific to appointments:

**1. Choose Appointment**

Open **Experiences**, select **Create Experience**, and choose **Appointment**.

**2. Set dates, optional products, and location**

On **Configure Experience**, attaching products is optional—if you add any, make sure they were created in Fanfare (appointments can't use products synced from Shopify). Enter an **Experience Name**, then set:

* **First bookable slot:** The earliest time a slot can start. Customers can start booking as soon as your page goes live—not at this time.
* **Closes At:** No slot can end after this time.
* **Time Zone:** Controls the window (and slot times for online appointments).

Under **Location**, keep **Physical Location** and pick a store from **Select Location**, or switch to **Online**.

**3. Configure slot length, buffer, and capacity**

Appointments skip the Stock step. On **Appointment Configuration**, set:

* **Slot duration:** 15 minutes to 2 hours (defaults to 30 minutes).
* **Buffer:** Gap between slots, from **No buffer** to 30 minutes (defaults to 15 minutes).
* **Max capacity per slot:** How many people can book each slot (defaults to `1`).

Review the **Daily Schedule Preview** below to verify the first day's generated slots and confirm whether they're following your location's hours, Fanfare's default 9 AM–5 PM hours, or a closed day.

**4. Finish and create**

Complete the remaining steps and select **Create experience** on **Review & launch**.

![The Configure Experience step for an appointment, with Physical Location chosen and a location picked in the Select Location combobox, which is outlined.](https://mintcdn.com/fanfare/1LIsN6sNCEZdXydH/images/guide/guide-create-appointment-location.webp?fit=max\&auto=format\&n=1LIsN6sNCEZdXydH\&q=85\&s=64ef5657534c44e9287959e45c5e9f83)

Choose a physical location to generate slots from its opening hours, or select Online.

![The Appointment Configuration step with Slot duration, Buffer and Max capacity per slot in the Slot Configuration card, and a Daily Schedule Preview listing the day's slots below.](https://mintcdn.com/fanfare/1LIsN6sNCEZdXydH/images/guide/guide-create-appointment-config.webp?fit=max\&auto=format\&n=1LIsN6sNCEZdXydH\&q=85\&s=c43f2501c1b542c8e11e5e01972f3420)

Check the Daily Schedule Preview to verify how slots fill the opening hours.

## Add appointments to an existing sequence

You can add an appointment to any existing sequence whose experience doesn't include Shopify-synced products:

1. Open your experience, then open the sequence you want to add to.
2. On the **Distributions** card, select **Add distribution**.
3. Enter a **Name**, choose **Appointment**, and select **Next**.
4. Set **First bookable slot**, **Closes**, and **Time zone** (windows in the same sequence can't overlap), and leave **Location** blank—you'll attach a physical location in **Edit** afterward.
5. Enter **Slot duration**, **Buffer**, and **Max capacity per slot**, then select **Create Distribution** on **Review**. Duration and buffer limits are validated when you create the distribution.
6. New appointments added this way default to **Online**. To tie it to a physical store, select **Edit** on the appointment card, open **Configuration**, switch to **Physical Location**, choose your store, and save.

> [!NOTE]
>
> In **Add distribution**, **Slot duration** and **Buffer** start blank (defaulting to **60-minute** slots and **no buffer** if left empty), while **Max capacity per slot** starts at `1`.

## Settings

To update an appointment later, select **Edit** on its card—**Schedule** holds the date window and time zone, and **Configuration** holds slot settings and location.

| Setting | What it does | Default | Editable once live? |
| - | - | - | - |
| **First bookable slot** | Earliest time a slot can start (customers can book as soon as the page is live). | Wizard: next whole minute | Locked while any booking stands; once open, can only move earlier. |
| **Closes** (**Closes At** in wizard) | Latest time a slot can end. | Wizard: 7 days after first bookable slot | Locked while any booking stands; final once closed. |
| **Time Zone** (**Time zone** in **Add distribution**) | Zone for the booking window and online slot times. Physical locations use the location's own time zone. | Wizard: your organization's time zone | Locked while any booking stands. |
| **Slot duration** | Length of each slot (5–480 minutes in **Add distribution** and **Edit**). | Wizard: 30 min; **Add distribution**: blank (60 min) | Locked while any booking stands. |
| **Buffer** | Gap between consecutive slots (0–240 minutes in **Add distribution** and **Edit**). | Wizard: 15 min; **Add distribution**: blank (none) | Locked while any booking stands. |
| **Max capacity per slot** | Bookings allowed per slot (1–1,000; required). | `1` | Locked while any booking stands. |
| **Location** | **Online** or a specific **Physical Location**. | Wizard: **Physical Location** (unselected); **Add distribution**: **Online** | Locked while any booking stands. |

> [!WARNING]
>
> **A single booking locks the entire appointment.** While any active booking stands, you can't edit the slot duration, buffer, capacity, location, window, or time zone. The lock lifts only once no booking is still waiting for its slot (every booking has ended, been checked in, or been canceled). Because customers can book as soon as the page is live, this can happen well before your first slot—finalize your schedule before announcing.

Deactivated appointments become read-only (**View** replaces **Edit**).

## Where slot hours come from

In-person appointment slots run inside the chosen location's weekly opening hours, in that location's time zone. Online appointments—and locations with no opening hours saved—use Fanfare's default hours of **9 AM to 5 PM** daily.

Location hours and time zone also lock while bookings stand at that location. See [Locations and opening hours](https://docs.fanfare.io/guide/create/locations.md). Note that changing an experience's time zone doesn't move an appointment's window, time zone, or existing bookings—see [Create an experience](https://docs.fanfare.io/guide/create/experiences.md).

## Manage bookings

On the sequence's **Overview** tab, below the **Distributions** card, an appointment schedule card displays each day and its bookable slots. It stays visible while the appointment is Scheduled, Live, or deactivated, and clears automatically once the window ends normally. (Because **Overview** shows one schedule card per sequence—prioritizing a Live distribution first, then the next Scheduled one—another active distribution in the same sequence can appear in its place.)

Closed days and dates outside your window are marked clearly. Select any slot to view its **Slot Attendees** and each attendee's status (**Confirmed**, **Checked In**, **Cancelled**, or **Completed**).

To cancel a customer's booking:

1. Select the slot, then select **Cancel booking** beside the attendee.
2. Confirm the cancellation. This can't be undone, and Fanfare notifies the attendee automatically.

You can only cancel bookings before their slot ends, and not after the appointment has been deactivated. Deactivating an appointment automatically cancels all upcoming bookings—see [Stop a drop](https://docs.fanfare.io/guide/drop/deactivate.md).

For the customer booking experience, see [Appointment](https://docs.fanfare.io/concepts/distributions/appointment.md) and [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md).

## Payment and waitlists

Appointments never take payment, so there's no payment step and they carry no Fanfare fee. Sequences containing only appointments don't have a waitlist, so the **Waitlist** tab isn't shown. See [Waitlists](https://docs.fanfare.io/concepts/waitlists.md).

## On Shopify

Appointments aren't available in the Shopify app on any plan. Shopify checkout protection requires an experience to grant purchase access, and because appointments don't gate checkout, pairing one with a Shopify product would make that product unbuyable.

In the Shopify app, **Appointment** is hidden from the wizard and **Add distribution**, links targeting an appointment open with no type selected, and saved drafts using **Appointment** can't continue.

## Troubleshooting

> [accordion] Prompted to 'Choose a location, or switch to Online'
>
> **Physical Location** is selected without a store chosen. Pick a store from **Select Location**, or switch to **Online**. If your store isn't listed yet, create it under [Locations and opening hours](https://docs.fanfare.io/guide/create/locations.md).

> [accordion] Blocked with 'Appointments can't use Shopify products'
>
> An experience with an appointment can't include products synced from Shopify. Remove the Shopify product or use a product created directly in Fanfare instead.

> [accordion] No slots appear on certain days
>
> Your chosen location is marked closed on those days. Update its opening hours under **Locations** before customers start booking.

> [accordion] Appointment settings are grayed out
>
> At least one active booking is standing on this appointment—the banner at the top of the settings dialog shows how many. Wait until those slots finish, or cancel the bookings from the appointment card on the sequence's **Overview** tab (canceling notifies each attendee and can't be undone).

## Related

> [card] [Appointment](https://docs.fanfare.io/concepts/distributions/appointment.md)
>
> How appointments work and how customers book slots.

> [card] [Locations and opening hours](https://docs.fanfare.io/guide/create/locations.md)
>
> Create stores and set the opening hours your slots follow.

> [card] [Create an experience](https://docs.fanfare.io/guide/create/experiences.md)
>
> Shared wizard steps and experience-level settings.

> [card] [Stop a drop](https://docs.fanfare.io/guide/drop/deactivate.md)
>
> Deactivate an appointment and see what happens to upcoming bookings.


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