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

# Bookings

> Learn how administrators book rooms, desks, offices, parking, equipment, and make free or paid recurring bookings; how users and administrators edit, move, and cancel bookings, how the system processes refunds and extra charges, and how to track created and canceled bookings, export them, and troubleshoot booking errors

Administrators can create, edit, and cancel bookings for customers or themselves in the admin portal. You create a booking from a resource page, such as **Rooms** or **Desks**. The **Bookings** page is where you track and manage all bookings.

## Create a booking

1. Open the relevant resource page — **Rooms**, **Desks**, **Offices**, **Parking**, or **Equipment** — and click **Create booking**.
2. Choose the date, time, and number of seats. Optionally, add a title, memo, or coupon.
   * To charge a custom price or give a discount on the booking, apply a [coupon](https://www.spacebring.com/docs/catalog/discounts/give-and-apply.md#apply-a-coupon-for-the-customer).
   * You can pick past dates to record a booking that already happened.
   * If the booker's [schedule](https://www.spacebring.com/docs/location/schedule.md#stay-open-past-midnight) stays open across midnight without a break, a booking can run into the next day, for example from 4:00 PM to 2:00 PM. It can last up to 24 hours.
3. Optionally, under **Add to this booking**, set the quantity of the [shop products](https://www.spacebring.com/docs/resource-management/resources/products-with-bookings.md#how-administrators-add-products-when-booking-for-a-customer) the resource offers with bookings, such as coffee. They're charged together with the booking.
4. Choose the customer in the **Booker** field. The list shows the location's members. To book for a [nonmember](https://www.spacebring.com/docs/customer-management/users/nonmembers.md) or a member of another location, search for them by name — Spacebring adds a member of another location to this location as a nonmember when you pick them.
5. For a room, optionally add people in **Invitees**. Pick members of the location, or select **New invitee** and enter a guest's name and email.
   * A guest can be added only while creating the booking, not when editing it.
6. Choose the [payment method](https://www.spacebring.com/docs/billing/payments/payment-methods.md#charge-a-customer-as-an-administrator) to charge the customer for the booking.
7. If you book for another customer or add invitees, choose whether to notify them about the booking.

![The New booking form with the Start, End, Repeat, and Booker fields on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/qGu7ipK5hoVvSuFA/images/resource-management-resources-manage-bookings-create-booking.png?fit=max\&auto=format\&n=qGu7ipK5hoVvSuFA\&q=85\&s=3a061473a5cffc97d7054e804ee2e3ef)

### Create a recurring booking

When a customer needs the same resource on a regular schedule, for example every Friday from 3:00 PM to 6:00 PM, create a recurring booking for them:

1. Start creating a booking.
2. Under **Repeat**, choose one of the suggested patterns, or **Custom** to set your own.
3. In **End repeat**, choose when the booking stops repeating:
   * **On date** — on a specific final date.
   * **Never** — it keeps repeating with no end date.
   * **After number of occurrences** — after a set number of bookings. Available for **Custom** patterns only.
4. Choose the customer in the **Booker** field.
5. Choose **Free**, or a payment method to [charge each booking](#recurring-booking-payments) with: credits, day passes, an invoice, or a [saved card](https://www.spacebring.com/docs/billing/payments/payment-gateway.md#pay-with-a-saved-payment-method). The **Payment** section shows how many bookings the series has and when each one is charged.
6. Create the booking. If some of its dates are already booked or outside the [schedule](https://www.spacebring.com/docs/location/schedule.md#what-the-schedule-affects), choose **Skip unavailable dates** to book the others, or **Back to editing** to change the booking.

> [!NOTE]
>
> Users can also create [recurring bookings](https://www.spacebring.com/docs/member/bookings.md) themselves and pay for them the same way.

### Recurring booking payments

Nothing is charged when a recurring booking is made. Each booking in the series is charged on its own, with the payment method chosen for the series:

* It's charged when the resource's [rescheduling policy](https://www.spacebring.com/docs/billing/payments/refunds.md#set-rescheduling-policy) stops allowing a refund. For example, with **1 day**, a booking on Friday at 3:00 PM is charged on Thursday at 3:00 PM. With **Before the start** or **No refund**, it's charged when it starts.
* If that time has already passed when the booking is made or moved, it's charged right away.
* It's priced at the [booking rates](https://www.spacebring.com/docs/resource-management/set-up-pricing.md) of its own day. When bookings on different days cost different amounts, the **Payment** section shows no total.
* It gets the coupon or promo code chosen for the series, and uses one of its redemptions. Once that discount expires or runs out of redemptions, the booking is charged at full price.
* Until it's charged, editing or canceling it brings no extra charge or refund.

The recurring booking's page shows its **Payment method** and **Next charge** date.

When a booking can't be charged, the customer gets a push notification and an email. Administrators get an email if their **Invoices** > **Payments failed** [notification](https://www.spacebring.com/docs/account/notifications.md) is on. What happens next depends on the payment method:

* **Card** — the card was declined or removed. The booking waits until the customer pays with **Complete payment** on the booking in the member portal.
* **Credits** or **day passes** — the balance doesn't cover the booking. It's canceled right away, and its slot is free again. The rest of the series stays booked.
* **Invoice** — the customer is asked to contact your team to keep the booking.

A booking still unpaid when it starts is canceled, and its slot is free again.

To keep these bookings and bill them instead, go to **Location settings** > **Resources** > **General** and, under **Failed scheduled charges for bookings**, set **Not enough credits**, **Not enough day passes**, or **Card payment failed** to **Add to invoice**. A booking its payment method can't cover is then added to the customer's invoice as a [pending invoice item](https://www.spacebring.com/docs/billing/payments/pay-with-invoice.md#pending-invoice-items) and stays booked, as long as the resource has a [money price](https://www.spacebring.com/docs/resource-management/set-up-pricing.md) for it. The customer gets a push notification and an email saying the booking was added to their invoice.

## Edit a booking

1. Open the booking from the **Resources**, **Bookings**, or customer profile page.
2. Click **(...)** in the top right corner > **Edit**, make your changes, and save.
3. If the booking was made for another customer or has invitees, choose whether to notify them about the change.

![A booking's details with the Edit and Cancel options in its menu on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/bBehq1JPxekYd-C_/images/resource-management-bookings-edit-a-booking-1.png?fit=max\&auto=format\&n=bBehq1JPxekYd-C_\&q=85\&s=bffc1c9217fe71cc9245492505cab1be)

> [!TIP]
>
> You can also drag a room booking in the **Resources** > **Rooms** calendar, on the web and in the mobile app: to another time, day, or room, or by its bottom edge to change when it ends. Bookings of rooms booked by the day can't be dragged.

### When users and administrators can edit bookings

> [tab] Users
>
> Users can edit their own bookings, but not a booking an administrator made for them.
>
> | Change | Credits, day passes, invoice, or free resource | Payment gateway |
> | - | - | - |
> | Reschedule | Within the resource's [rescheduling policy](https://www.spacebring.com/docs/billing/payments/refunds.md#set-rescheduling-policy) | Within the resource's rescheduling policy |
> | Extend | Before the booking ends, with an extra charge | Before the booking ends, with an [extra charge](#extra-charges) |
> | Shorten | Within the rescheduling policy, with a refund | Not allowed |
> | Change seats or items | Within the rescheduling policy, with an extra charge or refund | Add only, within the rescheduling policy, with an [extra charge](#extra-charges) |
> | Move to another resource | Before the booking ends, with an extra charge or refund | Before the booking ends, to a resource with the same or a higher price, with an [extra charge](#extra-charges) for the difference |

> [tab] Administrators
>
> Administrators can make any of these changes at any time — before, during, or after the booking. The rescheduling policy doesn't limit them.
>
> | Change | Credits, day passes, invoice, or free resource | Payment gateway or External |
> | - | - | - |
> | Reschedule | Anytime | Anytime |
> | Extend | With an extra charge | With an [extra charge](#extra-charges) |
> | Shorten | With a refund | Without a refund. [Refund the difference](https://www.spacebring.com/docs/billing/payments/refunds.md#issue-refunds-manually-via-spacebring) from the booking's **Payment** section if needed |
> | Change seats or items | With an extra charge or refund | With an extra charge for added ones, and no refund for removed ones |
> | Move to another resource | With an extra charge or refund | To a resource with the same or a higher price, with an [extra charge](#extra-charges) for the difference |

### General editing rules

A booking can move only to another resource of the same type, such as from one parking space to another, or to a similar room or desk subtype, such as from a hot desk to a dedicated desk. The target resource must be in the same location, accept the booking's payment method, and support any coupon applied to it.

Some bookings have more limits:

| Booking | Limit |
| - | - |
| Office or recurring | Can't move to another resource |
| Paid with invoice, after the invoice is issued | Can't move to another resource or be shortened. Can still be extended or get more seats |
| Free, on an [assigned resource](https://www.spacebring.com/docs/resource-management/rentals/assignments.md#entire-resource) | Can be edited only while the assignment covers its dates |
| Paid [in person](https://www.spacebring.com/docs/integrations/payments/stripe/in-person-payments.md) | Can't be extended, get more seats, or move to a pricier resource |
| Imported from [Google Calendar](https://www.spacebring.com/docs/integrations/bookings/google-calendar.md) or [Outlook Calendar](https://www.spacebring.com/docs/integrations/bookings/outlook-calendar.md) | Can't be edited, refunded, or canceled in Spacebring. Change it in the calendar it came from |

### Extra charges

When an edit makes a booking cost more, such as extending it, adding seats or items, or moving it to a pricier resource, the difference is charged with the booking's payment method.

The booking stays one booking. It counts once in **Analytics**, and the [bookings report](#export-a-bookings-report) shows it in one row with its latest start and end time and its total price, including extra charges.

The extra charge uses the booking's original [coupon](https://www.spacebring.com/docs/catalog/discounts.md), even if it has expired. A percentage coupon discounts the added part, and a fixed-amount coupon isn't deducted again. A new promo code can't be applied when editing.

**Credits or day passes**

* The difference is deducted from the balance the same way as the booking, as a new transaction separate from the original one.

**Invoice**

* Before the invoice is issued, the booking's [pending invoice item](https://www.spacebring.com/docs/billing/payments/pay-with-invoice.md#pending-invoice-items) is updated to the new price. No new item is added.
* After the invoice is issued, the difference becomes a new pending invoice item, billed on the customer's next invoice.

**Card or External**

* The difference is charged as a new transaction with its own invoice, separate from the original payment. The booking's **Transactions** section lists every charge.
* An **External** extra charge is recorded as paid right away.
* A card charge goes to the card used for the original payment.
* If that card is saved for the customer, it's charged right away. If the card is declined, the edit isn't saved.
* If the card isn't saved and a user extends the booking, they're taken to the payment page.
* If the card isn't saved and an administrator extends the booking, the payment shows as pending. The user pays it with the **Complete payment** button on their booking in the member portal.
* While a card charge waits on the payment page, the booking is **Tentative**. If the payment fails or isn't completed within 15 minutes, the booking returns to its previous time, number of seats, or resource, whoever made the edit. Until the charge is paid, the previous resource stays reserved for the booking, and the booking can't move to another resource.
* Refunding the booking [refunds](https://www.spacebring.com/docs/billing/payments/refunds.md#issue-refunds-manually-via-spacebring) its extra charges too, newest first. A partial refund comes out of the latest extra charge before the original payment.

> [!NOTE]
>
> With a card, **External**, or an issued invoice, you can't move a booking to another time and extend it in the same edit. Make two edits: one to move it, and one to extend it.

## Cancel a booking

1. Open the booking from the **Resources**, **Bookings**, or customer profile page.
2. Click **(...)** in the top right corner > **Cancel**.
3. For a recurring booking, choose **This occurrence**, or **This and future** to stop it from repeating.
4. If the booking was paid, choose whether to [refund it](https://www.spacebring.com/docs/billing/payments/refunds.md#issue-refunds-manually-via-spacebring). The rescheduling policy doesn't limit administrators, so you can refund a booking at any time.

Users can cancel their bookings at any time. Their refund depends on the resource's [rescheduling policy](https://www.spacebring.com/docs/billing/payments/refunds.md#set-rescheduling-policy):

| Canceled | Payment gateway | Credits |
| - | - | - |
| Within the rescheduling policy | Refunded automatically if the gateway has [automatic refunds](https://www.spacebring.com/docs/billing/payments/refunds.md#configure-automatic-refunds) on, such as Stripe. Otherwise, an administrator refunds it manually | Refunded automatically |
| Within a [partial refund](https://www.spacebring.com/docs/billing/payments/refunds.md#set-rescheduling-policy) | Its share refunded automatically if the gateway has automatic refunds on. Otherwise, an administrator refunds it manually | Its share refunded automatically |
| Outside the rescheduling policy and its partial refunds | Not refunded | Not refunded |

Canceling or refunding a booking doesn't cancel or refund the [products added to it](https://www.spacebring.com/docs/resource-management/resources/products-with-bookings.md#cancel-or-refund-products).

## Track bookings

* Go to **Resources** > **Bookings** to see all bookings in one list. It opens on today's bookings, and you can filter it by:
  * **Date** — a ready-made period, such as **Tomorrow** or **Next 7 days**, or a **Custom** date or range. It shows every booking that overlaps the period, including one that starts before it and ends after it.
  * **Status** — tentative, confirmed, or canceled bookings.
  * **Resource type** — one or more types of resource, such as hot desks or meeting rooms.
  * **Resource** — one specific resource.
  * **Company** — the bookings made by a company's members.
  * **Booker** — the bookings of a specific member or nonmember.
  * **Create date** — the bookings made on a date or in a period.
* Open a booking to see when it was made or canceled, and by whom.
* Enable [admin notifications](https://www.spacebring.com/docs/account/notifications.md) to get alerts about new and canceled bookings.

In the rooms calendar, every booking is blue, whoever it's for. A **Tentative** booking has a dashed blue outline instead of a fill. The hatched gray blocks before and after a booking are the room's **Buffer time**, and the desks timeline shows a desk's buffer time the same way.

![Blue room bookings, a tentative booking with a dashed outline, and an assigned room in the rooms calendar on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/qGu7ipK5hoVvSuFA/images/resource-management-rooms-3.png?fit=max\&auto=format\&n=qGu7ipK5hoVvSuFA\&q=85\&s=ca480a0d605221787c2c03b99baa4fd5)

> [!TIP]
>
> To ask customers for a review once their booking ends, [set up an agent](https://www.spacebring.com/docs/guides/automate-onboarding-and-follow-ups.md#follow-up-after-a-visit-an-event-or-a-support-ticket).

### Booking statuses

* **Tentative** — the booking waits for one of these:
  * An [external payment](https://www.spacebring.com/docs/billing/payments/external.md#manage-pending-external-payments).
  * A payment through a payment gateway that's still [processing](https://www.spacebring.com/docs/billing/payments/transactions.md#transaction-statuses) or isn't completed yet, including an [extra charge](#extra-charges) for an edit.
  * A [scheduled credit or day pass transaction](https://www.spacebring.com/docs/billing/credits-and-day-passes/scheduled-transactions.md), for a booking in a future subscription period.
  * A payment for a booking of a [recurring booking](#recurring-booking-payments) that couldn't be charged.
  * A [confirmation](https://www.spacebring.com/docs/resource-management/room-display.md#abandoned-booking-protection) on Room display when the user arrives, for a free booking.
* **Confirmed** — the booking is fully secured.
* **Canceled** — one of these happened:
  * The customer or an administrator canceled the booking.
  * An administrator canceled a booking whose external payment never arrived.
  * The customer started paying through the payment gateway but didn't finish, or canceled the payment.
  * The scheduled credit or day pass charge failed.
  * A booking of a recurring booking was still unpaid when it started, or the customer's credits or day passes didn't cover it.
  * Nobody confirmed the booking on Room display, so it was canceled automatically.

### Export a bookings report

On the **Resources** > **Bookings** page, apply the filters you need, then click **(...)** in the top right corner > **Export bookings** > **CSV** or **XLSX**.

![Export bookings options in the Bookings page menu on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/kl77z0yNTV5SI3uW/images/resource-management-resources-bookings-export-a-bookings-report.png?fit=max\&auto=format\&n=kl77z0yNTV5SI3uW\&q=85\&s=9870301f5d3ebcf6595f0004ba471701)

The report includes each booking's status, resource type and title, its start, end, create, and delete dates, quantity, and memo, its payment type, price, currency, and payment status, the booker's name and company, and the name of whoever created the booking on their behalf.

## Troubleshoot booking errors

A booking error almost always points at the location schedule or a resource setting, not at the booking itself.

> [accordion] The booking period is invalid
>
> The location schedule changed after the booking was made, and the booking no longer fits it. For example, the booking ends at 11 PM, but the location now closes at 10 PM. Extend the **Until** time in the [schedule](https://www.spacebring.com/docs/location/schedule.md) that applies to the customer: the **Default** schedule for members, or the **Public** schedule for nonmembers. Then ask them to edit the booking again.

> [accordion] Select a correct date. This day is not available
>
> The date is a [closed day](https://www.spacebring.com/docs/location/schedule.md#select-closed-days) or falls outside the schedule's workdays. If the day should be bookable, remove it from the **Closed days** of the schedule that applies to the customer.

> [accordion] You already have an active free booking
>
> The customer already holds as many free bookings at once as the [**Book for free**](https://www.spacebring.com/docs/resource-management.md#enable-rooms) limit for that resource type allows. Each occurrence of a recurring booking counts, and so does each seat, space, or item booked, so a series with more occurrences or a booking with more seats than the limit gets this error too. Raise the limit to let customers hold more free bookings at once.

> [accordion] You need to book at least 2 hours in advance
>
> The booking starts sooner than the **Minimum notice** in the resource's [**Booking window**](https://www.spacebring.com/docs/resource-management.md#add-rooms), or in its **Public booking window** when the customer is a nonmember. Lower the notice, or create the booking yourself, as administrators aren't limited by it.

> [accordion] The resource is already assigned or booked during this period
>
> Another booking or an [assignment](https://www.spacebring.com/docs/resource-management/rentals/assignments.md) holds the resource at that time. For a recurring booking, the conflict can be on just one date of the series. Filter the **Resources** > **Bookings** page by the resource, or check the **Resources** > **Assignments** timeline, to find it.

> [accordion] No payment methods are available
>
> The customer has no way to pay for the booking. Check that a [payment gateway](https://www.spacebring.com/docs/integrations/payments.md) is connected to the location and, for Stripe, that **Bookings** is selected in the [**Payments** section](https://www.spacebring.com/docs/integrations/payments/stripe.md#configure-stripe) of its settings.

If customers hit booking errors repeatedly, review these settings:

1. The **Default** and **Public** [location schedules](https://www.spacebring.com/docs/location/schedule.md) match the hours you offer to members and to nonmembers.
2. **Book for free** on each page of **Location settings** > [**Resources**](https://www.spacebring.com/docs/resource-management.md).
3. Each resource's **Min & Max duration**, **Availability increment**, **Buffer time**, **Booking window**, **Custom schedule**, and [rescheduling policy](https://www.spacebring.com/docs/billing/payments/refunds.md) on its **Booking** tab.
4. Each resource's **Booking** permission on its **Permissions** tab, which decides who books it right away and who [requests a booking](https://www.spacebring.com/docs/resource-management/resources/booking-requests.md) instead.

## FAQs

> [accordion] What hours does a day booking cover?
>
> A resource booked by the day, with **Min duration** and **Max duration** both set to 1 day, is booked for one whole day of the [schedule](https://www.spacebring.com/docs/location/schedule.md):
>
> * On most schedules, the booking covers that day's open hours, for example from 9:00 AM to 6:00 PM.
> * On a day that [stays open past midnight](https://www.spacebring.com/docs/location/schedule.md#stay-open-past-midnight), it covers the whole day, for example from 2:00 PM to 10:00 AM the next day.
> * On a schedule open 24/7, it can start at any time and ends at the same time the next day, for example from 6:00 PM to 6:00 PM.

> [accordion] Can I book an office?
>
> Yes. An office can be booked short-term, rented long-term, or both. What a customer can do depends on whether the office is [assigned](https://www.spacebring.com/docs/resource-management/rentals/assignments.md#entire-resource) to them for those dates.
>
> While nobody rents the office, customers book it themselves in the member web portal:
>
> * By the hour or by the day, following its **Availability increment**, **Min duration**, and **Max duration**. To offer full days only, set both durations to 1 day.
> * As members or nonmembers, following its **Visibility** and [**Booking**](https://www.spacebring.com/docs/resource-management/resources/booking-requests.md) permissions.
> * With any [payment method](https://www.spacebring.com/docs/billing/payments/payment-methods.md) the office accepts.
> * As a whole office, so all its seats must be free for the chosen period.
>
> While the office is assigned to a member or company, only that customer books it for those dates, for free, because the rental already pays for it. This is how a [hybrid office](https://www.spacebring.com/docs/resource-management/rentals/hybrid-offices.md) works.
>
> Administrators can book an office nobody rents for any customer, including on past dates. While it's assigned, they can book it only for the customer who rents it or a member of that company.
>
> To make an office bookable, [set up its booking pricing](https://www.spacebring.com/docs/resource-management/set-up-pricing.md#set-up-pricing-for-bookings). Use the same office for both bookings and rentals. Don't add a desk to sell the same office by the hour.

> [accordion] My customer can't book a resource with day passes
>
> Only a resource with the **Day passes** switch on can be booked with day passes. To allow it:
>
> 1. Go to the resource page, such as **Resources** > **Desks**, and start editing the resource.
> 2. On the **Pricing** tab, turn on the **Day passes** switch.

> [accordion] How can I calculate the rooms' occupancy in % during work hours?
>
> The **Analytics** > [**Occupancy**](https://www.spacebring.com/docs/analytics/track-occupancy.md) page shows the share of your schedule's hours booked for each type of room, for each day, week, or month of the period you select. To calculate occupancy during other work hours instead:
>
> 1. Filter the **Bookings** page by rooms and the period you need, then [export a bookings report](#export-a-bookings-report).
> 2. Open it in Google Sheets or Excel, calculate each booking's duration from the **Start date** and **End date** columns, and add them up. This gives you the total booked hours.
> 3. Multiply the number of rooms by the work hours per day and the working days in the period to get the available hours.
> 4. Divide the booked hours by the available hours and multiply by 100.
>
> The **Analytics** > **Rooms** page also shows the number of bookings and the revenue for your rooms.

> [accordion] Can my members' clients book a room with the member through the member web portal?
>
> No. The member web portal lets your own customers book your rooms, desks, and offices, so a member's clients can't book time with that member there.
>
> Instead, the member books the room and [adds each client as an invitee](https://www.spacebring.com/docs/member/bookings.md#create-a-booking). With an [access control integration](https://www.spacebring.com/docs/integrations/access-control.md), each client gets door access for the time of the booking.


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