> For the complete documentation index, see [llms.txt](https://docs.yaycommerce.com/bookster/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yaycommerce.com/bookster/booking-pages/booking-calendar.md).

# Booking Calendar

Put a live calendar of open times on any page. Visitors see which times are free, by week or by month, and click one to book it.

{% hint style="info" %}
Needs **Bookster Pro**, included in [All Access](https://wpbookster.com/downloads/all-access/).
{% endhint %}

## Before you start

* Bookster Pro is active.
* The schedule you want to show has working hours: the site schedule in **Settings › Schedule**, or the agent's **Schedule** tab.
* To show full days instead of times, at least one active, public service is set to **Book by** **Full day**.

## Add the block

1. Open a page in the WordPress editor, or create a new one.
2. Click **+**, search for "Booking Calendar" and insert **Bookster Booking Calendar**.
3. Set it up in the block sidebar (see below).
4. Click **Publish** or **Update**, then view the page.

<figure><img src="https://3654694329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOokiT38oKvyMtYds88Kp%2Fuploads%2Fgit-blob-d9029a54eccddef75cd0614d6f991f5e5d472b42%2Fbooking-calendar-block-settings.webp?alt=media" alt="Block sidebar with the Schedule and Views panels of the Booking Calendar"><figcaption><p>The block's Schedule and Views settings.</p></figcaption></figure>

## Choose what the calendar shows

### Schedule

* **Availability source**: **Site schedule** shows your business hours. **Agent schedule** shows one agent's working hours and bookings; pick the agent in **Agent**. Only public agents are listed.
* **Book by**: shows when your services are booked both ways. **Time slots** lists time-based services; **Full days** lists services booked by the full day. When only one kind exists, the sidebar shows which one is used.

### Views

* **Week view**: one column per day, one row per time slot. Rows follow the earliest and latest working time in the schedule. Turn on **Set business hours manually** to set your own **Start time (HH:mm)** and **End time (HH:mm)**.
* **Month view**: one cell per day. In **Months to show**, pick **1 month** or **2 months**.

Keep at least one view on. With both on, visitors get a **Week** / **Month** switch.

### Colors and captions

* **Calendar colors**: **Available slot**, **Accent (hover / Book button)** and **Text**. Leave them empty to use your theme's colors.
* **Captions** (time slots only): **Time slot caption** uses `{time}`. **Day caption (Month view)** uses `{count}` and `{total}`, for example `{count} slots`.

The time step of the rows comes from **Settings › General**, the same as the booking form.

## What visitors see

The calendar opens on the current week or month. Arrows move to the next or previous period.

* Free times show their caption and a **Book** button on hover.
* Busy times are shaded. Times outside working hours, days off and times outside your booking window can't be clicked.
* In **Full days** mode, each free day shows **Full day**.
* Times are in the site's time zone. When the visitor's time zone is different, a note such as "Times in London time" shows.

<figure><img src="https://3654694329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOokiT38oKvyMtYds88Kp%2Fuploads%2Fgit-blob-3ca828a88e63e4eead0686599ccda88c1850f4d4%2Fbooking-calendar-week.webp?alt=media" alt="Booking Calendar on a page in Week view with free and busy times"><figcaption><p>Week view: free times can be booked, busy ones are shaded.</p></figcaption></figure>

## Click to book

1. The visitor clicks a free time, or a free day in Month view.
2. The booking form opens in a pop-up with that date and time already picked. With **Agent schedule**, the agent is picked too.
3. The visitor picks a service and completes the booking as usual.

With **Site schedule**, the calendar shows your business hours, not each agent's, and only the visitor's own bookings count as busy. The visitor picks an agent in the booking form.

## If something goes wrong

| Symptom                                               | What to do                                                                                                                                                                |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| The block isn't in the inserter                       | Check that Bookster Pro is active and its license is valid.                                                                                                               |
| The calendar shows the site schedule, not the agent's | The agent is deactivated, private or deleted. Make the agent public, or pick another one.                                                                                 |
| **Book by** doesn't offer **Full days**               | No active, public service is booked by **Full day**, or the chosen agent doesn't offer one.                                                                               |
| Every time looks busy or unavailable                  | Check the working hours and days off of the schedule, and the booking window in **Settings › General**.                                                                   |
| A visitor clicks a time and booking fails             | Someone booked it first; the visitor picks another time. For other messages, see [Troubleshooting](https://docs.yaycommerce.com/bookster/other-links/troubleshooting.md). |
