<!-- https://unlockos.io/manual/timeslot-booking-admin -->

# Time Slot Booking Plan Configuration Help

## Overview

The Time Slot Booking plan lets you define fixed time slots in advance — such as "Morning session (09:00–12:00)" and "Afternoon session (13:00–18:00)" — that guests can select when booking. Members with an active membership can book slots for free.

This guide covers:

- Creating a new time slot plan
- Adding, editing, and removing time slots (tiers)
- Configuring slots per day type (Weekday / Weekend / Holiday) — **the Holiday tab applies only when its slots are enabled**, see below
- Managing quota (capacity)
- FAQ and troubleshooting

---

## Step 1: Create a Price Plan

1. Open **Plan Management** from the main navigation
2. Click **Create New Plan**
3. Enter a **Plan Name** (e.g., "Studio Booking Plan", "Meeting Room A")
4. Select **Time Slot Booking Plan** as the plan type
5. Configure currency, tax rate, and other basic settings
6. Click **Save Plan**

> Important: The plan type cannot be changed after saving. Make sure to select "Time Slot Booking Plan".

---

## Step 2: Configure Time Slots

### Switching Day Type Tabs

The time slot configuration area has three tabs: **Weekday**, **Weekend**, and **Holiday**. Each can be configured independently.

| Tab | Applies to |
|-----|-----------|
| Weekday | Monday through Friday (determined automatically by the system) |
| Weekend | Saturday and Sunday |
| Holiday | **Currently unused** (see the note below) |

> **Important: the Holiday tab applies only when at least one of its slots is enabled** (#2471).
> While every slot on it is disabled, a public holiday is classified by **its ordinary day of the week**: the Weekend tab if the holiday falls on a Saturday or Sunday, the Weekday tab otherwise. The shipped template leaves every Holiday slot disabled, so facilities that never touched this setting see no change. To offer different slots or rates on public holidays, add slots to the Holiday tab and enable them.
>
> Other plan types (Accommodation / Hourly / Daily Flat / Fixed + Overtime / One-Time) do detect holidays automatically and apply holiday rates, but **Time Slot Booking plans are excluded**. Offering a different slot structure or price on public holidays is not currently supported. For the full picture of day classification, see [Price Plan Settings — How Day-of-Week and Holiday Rates Are Chosen](plan-form.md).

### Adding a Time Slot

1. Select the target day type tab
2. Click **Add Time Slot**
3. Fill in the following fields on the new card

| Field | Description | Required |
|-------|-------------|----------|
| Slot Name | Name shown to guests (e.g., "Morning Session", "Night Session") | Yes |
| Start Time | Start time of the slot (e.g., 09:00) | Yes |
| End Time | End time of the slot (e.g., 12:00) | Yes |
| Fee | Fixed price for this slot (currency follows the plan's basic settings) | Yes |
| Enabled | Check to make this slot available for booking | - |

4. Repeat to add multiple slots
5. Configure the other day type tabs in the same way

### Editing a Time Slot

Click on any field in an existing slot card to edit it directly. Changes take effect when the entire form is saved.

### Removing a Time Slot

Click the trash can icon in the top-right of the slot card. Deletion cannot be undone.

---

## Step 3: Link to a Booking Configuration

To display the time slot plan on the guest booking page, you need to associate it with a booking configuration.

1. Go to **Booking Management** → **Plan Settings** tab
2. Edit the target configuration (or create a new one)
3. In the **Room Type × Plan** section, select the time slot plan you created
4. Save the configuration

For more details, see [Booking Management Dashboard](booking.md).

---

## Detailed Features

## Feature 1: Independent Settings Per Day Type

You can define different slot structures and pricing for weekdays and weekends independently.

For example:

| Day Type | Slot | Fee |
|----------|------|-----|
| Weekday | 09:00–12:00 "Morning Session" | ¥2,000 |
| Weekday | 13:00–17:00 "Afternoon Session" | ¥3,000 |
| Weekend | 10:00–14:00 "First Half" | ¥4,000 |
| Weekend | 15:00–19:00 "Second Half" | ¥4,000 |

> Slots on the Holiday tab apply as soon as at least one of them is enabled (see the note under "Switching Day Type Tabs"). While all of them are disabled, public holidays are served by the Weekend slots when they fall on a Saturday/Sunday, and by the Weekday slots otherwise.

## Feature 2: Enabling and Disabling Individual Slots

The **Enabled** checkbox on each slot card lets you publish or unpublish individual slots without deleting them. Disabled slots will not appear on the guest booking page. Use this to temporarily pause bookings for a specific slot.

## Feature 3: Free Booking for Members

Members with an active membership can book any time slot for **free (¥0)** regardless of the fee configured. Guests without membership pay the normal fee and are directed to Stripe for payment.

Member booking is available through the Member App (`/member`). See [Member Time Slot Booking](timeslot-booking-member.md) for details.

---

## Frequently Asked Questions

### Q: Can I set a quota (capacity) per slot?

Yes. The quota is set through the **Room Type × Plan** mapping in your booking configuration. The number of units assigned to the room type determines the maximum available slots. The guest booking page shows "N slots remaining" accordingly.

### Q: What happens if I configure overlapping time slots?

The system allows overlapping slots to be saved, and both will appear to guests. It is recommended to configure non-overlapping time ranges.

### Q: Can I set the fee to zero?

Yes. Setting the fee to 0 allows guests to book without payment, just like members. Use this when you want to offer free access to non-member guests as well.

### Q: When is payment collected?

Payment is collected when the guest completes the Stripe checkout on the booking confirmation page. The reservation is not confirmed until payment succeeds.

### Q: Slots I added to the Holiday tab don't show up on the booking page
A: Check that "Enable this slot" is ON. The Holiday tab is used **only when at least one of its slots is enabled**; while all of them are disabled, a public holiday is served by its ordinary day of the week (Weekend on Saturday/Sunday, Weekday otherwise). For how other plan types handle holidays, see [Price Plan Settings](plan-form.md).

### Q: Can I configure a cancellation policy?

There is no built-in cancellation policy setting for the Time Slot Booking plan. Cancellations should be handled manually by facility administrators according to your facility's policy.

---

## Troubleshooting

### Time slots are not appearing on the guest booking page

Check the following:

1. Confirm the plan type is set to **Time Slot Booking Plan**
2. Confirm that slots have been added under the correct day type tab
3. Confirm the **Enabled** checkbox is checked on each slot
4. Confirm this plan is registered under **Room Type × Plan** in the booking configuration
5. Confirm the booking configuration is set to **Enabled**

### Slots show "Full" and guests cannot select them

The available count has reached 0 for those slots. Increase the unit count in the room type configuration, or check for existing bookings.

### "Failed to load slot information" error

This may indicate a network issue or a temporary server problem. Reload the page and try again. If the issue persists, contact your system administrator.

---

## Related Pages

- [Price Plan Settings](plan-form.md)
- [Plan List](plan-list.md)
- [Booking Management Dashboard](booking.md)
- [Time Slot Booking (Guest)](timeslot-booking-guest.md)
- [Time Slot Booking (Member)](timeslot-booking-member.md)
- [Membership Usage Quotas](membership-plans.md)
