> ## 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.
# Assignments
> Learn how to assign resources to customers for long-term rental, how bookings work on assigned resources, and how to track all rentals on the Assignments timeline
An assignment is an allocation of a resource to a customer, typically for a long-term rental, such as of a private office or dedicated desk. Assignments are created automatically when a customer subscribes to a rental or when an administrator sets up a subscription on their behalf.
## Assign resources to customers for rental
1. Go to the **Customers** page.
2. Open the customer's profile.
3. [Create](/docs/billing/subscriptions) or [edit](/docs/billing/subscriptions/edit) their subscription.
4. Add a subscription item.
5. In the **Product** field, select a resource (desk, office, etc.).
6. In the **Tier** field, choose one of the tiers (pricing options) you added in this resource settings or choose **Custom** to set up the subscription details from scratch.
7. Use the **Entire resource** switch to choose the appropriate assignment type.
If you [configured long-term rental pricing](/docs/resource-management/set-up-pricing) in resource settings, customers can also [apply or sign up](/docs/resource-management/rentals/rental-applications-or-immediate-sign-ups) for a resource rental by themselves and be automatically assigned to the resource.
### Entire resource
Use it when:
* The customer rents the whole resource, such as:
* A private office
* A meeting room
* A desk
* A parking lot rented entirely by one company
* For as long as the assignment lasts, the resource is hidden from everyone except the assigned customer, and only that customer can book it. If the resource is assigned to a company, every member of that company can book it.
* A customer who is assigned an entire resource can book it for free, because their subscription already pays for it.
* If the customer books the resource outside their assignment dates, the booking is charged at the resource's regular price, and the customer has to pay for it.
* A booking made under an assignment can only be edited while the assignment still covers it. If you move the booking outside the assignment period, or the assignment was canceled, you will face the **Cannot update a hybrid booking without a subscription covering it** error. The booking stays in the calendar and can still be canceled.
Rooms can only be assigned entirely.
Assign a resource only when the customer rents it. If nobody rents the resource and you only need to control who can see and book it, set up [exclusive access](/docs/resource-management/resources/exclusive-resource-access) instead — the resource stays shared, and every customer you grant access to can book it.
### Quantity of seats/spaces/items
Use it when:
* The customer rents part of a shared resource, such as:
* 1 dedicated desk in a 10-desk zone
* 3 parking spaces in a 20-space lot
With this assignment type, customers don't book their seat(s) during their subscription period; they're reserved for the customer.
* You want the resource to remain visible to others even when fully occupied.
* In this case, leave the **Entire resource** switch off and assign the maximum quantity instead.
* The resource will appear with the **Fully occupied** label, allowing others to express interest for future availability.
How resources assigned by seats appear to others:
* Users see the reduced resource availability (e.g., 7/10 available).
* When capacity reaches zero, it remains visible with a **Fully occupied** label.
## Track all rentals on the Assignments page
1. Go to **Resources** > **Assignments.**
2. The **Assignments** page gives you a consolidated overview of:
* Resources rented by customers
* Resources available for rental
### How to read the Assignments timeline
Each resource appears with one or more bars labeled with customer names.
* Thicker bars indicate entire resource assignments.
* Thinner bars indicate [partial assignments](#quantity-of-seatsspacesitems).
* The number of seats is shown next to the customer name.
* If no seat count appears on the thin bar, it means 1 seat is assigned.
* Each resource shows its total capacity, so you can quickly assess remaining availability.
* Unassigned resources appear without any bars.
**Interactions:**
* Hover over a bar to see the rental period. It is shown based on the customer's [subscription item dates](/docs/billing/subscriptions).
* For subscriptions with no end date set, the assignment shows as indefinite.
* Click a bar to open the customer's profile and [manage the resource assignment](/docs/billing/subscriptions/edit) in their subscription.
* Click a resource to view its details.
**Filters:**
* Use the date picker to check availability for a specific period.
* Use the **Resource** dropdown to view all resources or filter by resource type.
The **Assignments** page is for tracking long-term rentals only — it does not include bookings.
### Floor plan view
* If you have the [Floor plans add-on](/docs/resource-management/floors), switch to **Floors** to see the occupancy visually on floor plans.
* Use the **Date** or **Resource** filters to check availability for a specific period or a specific resource type.
You can also view real-time availability and current assignments for each resource directly on the **Resources** pages.
**FAQs**
There are several reasons why you see this error message:
* One or more resources you've added to the customer's subscription are already assigned to another customer for the same dates or with a different assignment type (entire VS by seat).
To fix this:
1. Go to **Resources > Assignments.**
2. Find the resource in question to check:
* Which customer it's assigned to
* The assignment dates
* The type of assignment
* Wide bars = Entire resource assignments
* Narrow bars = Assignments by seats
3. To fix the conflict:
* Choose a different resource for your new customer.
* Go to the profile of the customer who currently rents this resource and remove this resource from their subscription items or adjust its dates.
* If the resource is assigned by seat, assign the resource to the new customer by seat as well.
Before creating an assignment, Spacebring checks that the resource is free for the whole assignment period. This error means something already occupies it:
* The resource has bookings during that period.
* The resource is already assigned to other customers, and your assignment would take it over its capacity.
* A [parent or child resource](/docs/resource-management/resources/overlapping-resources) of the one you are assigning is booked or assigned during that period.
To find the conflict, check the resource page for bookings, the **Resources > Assignments** timeline for other assignments, or generate a [**Bookings** report](/docs/resource-management/resources/bookings). Then cancel the conflicting bookings, adjust the other assignments, or set your assignment to start after they end.
A customer who rents the entire resource pays for it in their subscription, so booking it costs them nothing extra. This is expected, and applies to all resource types. If you want customers to pay per booking instead, remove the assignment and give them [exclusive access](/docs/resource-management/resources/exclusive-resource-access) to the resource.
1. Go to the **Resources > Assignments** page or to **Rooms, Desks, Offices, Parking,** or **Equipment** pages.
2. Find the resource in question to check which customer it's assigned to.
3. Go to the **Customers** page.
4. Open the profile of the customer who currently rents this resource.
5. [Edit their subscription](/docs/billing/subscriptions/edit) and remove this resource from their subscription items, or adjust the item's rental dates to assign it to a new customer for other dates.
One-off bookings, used for short-term or day-specific use, are not displayed on the **Assignments** timeline. These can be tracked on respective resource pages or through [analytics tools.](/docs/analytics)
This depends on whether the customer rents the resource or only needs the right to book it:
* If the customer rents this resource full-time (for example, it's their private office or their dedicated desk), [assign it to them in their subscription as a product](#assign-resources-to-customers-for-rental). Their bookings of it will be free.
* If the resource should stay hidden from everyone except certain members, but those members don't rent it and only need the right to see and book it at the resource's price, set it up as a resource with [**Exclusive access**](/docs/resource-management/resources/exclusive-resource-access).
If a customer rents an office, desks, room, or other resource on specific days of the week (for example, only on Mondays and Tuesdays), you can:
1. [Create a recurring booking](/docs/resource-management/resources/bookings#create-a-recurring-booking) for that resource for the customer with the required schedule.
2. [Create a subscription](/docs/billing/subscriptions) to invoice the customer for rental.
* Do not select this resource as a subscription item — this would assign it to the customer every day.
* Instead, choose a plan or the **Custom** option to set up the charge only.
* For as long as the assignment lasts, the resource is hidden from everyone except the assigned customer, and only that customer can book it. If the resource is assigned to a company, every member of that company can book it.
* A customer who is assigned an entire resource can book it for free, because their subscription already pays for it.
* If the customer books the resource outside their assignment dates, the booking is charged at the resource's regular price, and the customer has to pay for it.
* A booking made under an assignment can only be edited while the assignment still covers it. If you move the booking outside the assignment period, or the assignment was canceled, you will face the **Cannot update a hybrid booking without a subscription covering it** error. The booking stays in the calendar and can still be canceled.
How resources assigned by seats appear to others:
* Users see the reduced resource availability (e.g., 7/10 available).
* When capacity reaches zero, it remains visible with a **Fully occupied** label.
## Track all rentals on the Assignments page
1. Go to **Resources** > **Assignments.**
2. The **Assignments** page gives you a consolidated overview of:
* Resources rented by customers
* Resources available for rental
### How to read the Assignments timeline
Each resource appears with one or more bars labeled with customer names.
* Thicker bars indicate entire resource assignments.
* Thinner bars indicate [partial assignments](#quantity-of-seatsspacesitems).
* The number of seats is shown next to the customer name.
* If no seat count appears on the thin bar, it means 1 seat is assigned.
* Each resource shows its total capacity, so you can quickly assess remaining availability.
* Unassigned resources appear without any bars.
**Interactions:**
* Hover over a bar to see the rental period. It is shown based on the customer's [subscription item dates](/docs/billing/subscriptions).
* For subscriptions with no end date set, the assignment shows as indefinite.
* Click a bar to open the customer's profile and [manage the resource assignment](/docs/billing/subscriptions/edit) in their subscription.
* Click a resource to view its details.
**Filters:**
* Use the date picker to check availability for a specific period.
* Use the **Resource** dropdown to view all resources or filter by resource type.
