> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.distribution-os.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Booking or a special projection

> Add one Booking, a week for many cinemas at once, or a special projection such as a school show, on the Bookings page, with film, cinema and version.

A Booking is one film, in one language version, at one cinema, for one cinema week. You create Bookings on the **Bookings** page. Use **Add booking** for a single Booking, **Bulk creation** for the same film at many cinemas, and **Add Special Projection** for single days such as a school show.

## Before you start

* You need permission to edit Bookings. Without it, the buttons below do not appear.
* The film must exist in DOS and have at least one language version. See [Add a film](https://wiki.distribution-os.ch/films/add-a-film.md).
* The cinema must be in your own organizations list. The cinema pickers on Booking forms list only your firm's own cinemas. See [Add or fix a cinema](https://wiki.distribution-os.ch/cinemas/add-or-fix-a-cinema.md).
* A cinema marked **(not active)** is not offered for a new Booking. It stays selectable only on a Booking that already uses it.

## Create one Booking

**1. Open the form**

On **Bookings**, click **Add booking**. A side panel opens with the title **New booking**.

**2. Choose the film and the cinema**

Pick the film under **Film** and the cinema under **Cinema**. In the cinema picker you can type a town. If two cinemas share a name, the town is added to the label.

**3. Set the start date**

Pick the **Start date**. The calendar only lets you choose the first day of the cinema week for the cinema's region. That is a Thursday for D-CH and I-CH, and a Wednesday for F-CH. You must choose the cinema first.

**4. Choose the language version**

Open the **Version** tab and tick the language version. If you tick several, DOS creates one Booking per language version. The panel button then counts them, for example **Create 2 bookings**.

**5. Check the commercial terms**

Under **Commercial terms**, **Use film defaults** is on. DOS fills in the percentage or weekly rate from the film's terms for that playing week. Switch it off to type your own terms. See [Booking conditions and shares](https://wiki.distribution-os.ch/bookings/conditions-and-shares.md).

**6. Optional details**

Set **Status** (it stays **Automatic** unless you override it), **Billed to** if someone other than the cinema receives the invoice, and **Internal notes** or **Confirmation notes**. Confirmation notes are printed on the booking confirmation for the cinema.

**7. Create**

Click **Create 1 booking** (or **Create 2 bookings**, and so on, following your language versions). The new Booking appears in the table without a page reload.

## Create the same week for many cinemas

**1. Open Bulk creation**

Click **Bulk creation**. The panel is titled **Bulk create bookings**. If the table is empty, the **Bulk create** button on the empty screen does the same.

**2. Choose the film and language versions**

Pick the **Film**, then tick one or more under **Language version**. Cinemas only appear for regions where all ticked language versions are approved. A link under the list lets you show the other regions.

**3. Tick the cinemas**

Under **Cinemas releasing the film**, tick the cinemas. The list is sorted by potential and relationship score (shown as **P** and **R**). You can search by name, location or city, and filter by region. A cinema with a school or public holiday that week shows **Holiday**.

**4. Set playing days and week start**

Under each ticked cinema, untick any day the film does not play. By default every day is ticked. Set the **week start** for each region you selected.

**5. Choose who pays**

Under **Who pays?**, tick **One organisation pays for all** to bill every new Booking to one organization. Tick **Remember this for these venues** if later Bookings of these venues should follow. Leave it unticked for a one-off event.

**6. Create**

Click **Create N bookings**. A message tells you how many were created and how many already existed.

> [!NOTE]
>
> The technical version section offers **Only the versions each cinema's screens need**. When it is ticked, each cinema gets only the technical versions its screens can play, for example 4K only for 4K screens.

## Create a special projection

**1. Open the form**

Open the more menu in the top bar of **Bookings** and choose **Add Special Projection**. The panel is titled **Add Special Projection**.

**2. Choose film, cinema and version**

Pick the **Film** and the **Cinema**, then tick one language version under **Language version**. A special projection keeps exactly one.

**3. Add the days**

In the **Projections** table, set a **Date**, an optional **Label**, a **Condition** and a **Value** for each day. Click **Add projection day** for more days. You can tick **Same conditions for all days**.

**4. Save**

Click **Create special projection**.

A day labelled **Gratis** is free. When every day is **Gratis**, no invoice is created for the Booking. By default **Exclude from the cinema's week count** is ticked, so the special projection does not count as a cinema week.

## What you'll see

The new Booking appears in the **Bookings** table, with its status set automatically from the dates (**Next**, **Live** or **Results**). Open it to find the **Details**, **Version**, **Results**, **Screens**, **Invoice**, **Confirmation** and **Logs** tabs. The responsible user is set on a saved Booking: **Empty follows the Release Strategy card for this film, then the organisation, then its group.** Choosing a user there changes this Booking only.

On a saved weekly Booking, the **Playing days** row lets you untick days the film does not play. Unticking a day only describes the week. It changes no amount.

## If something looks wrong

> [accordion] The cinema is missing from the picker
>
> The picker lists only your firm's own cinemas, and a cinema marked not active is hidden for new Bookings. Check the cinema in your organizations list.

> [accordion] The start date is greyed out
>
> The date field stays disabled until you choose a cinema. It shows **Select cinema**.

> [accordion] Another Booking of this film and language already covers this week at this cinema
>
> DOS refuses a second Booking of the same film and language for the same cinema week. Open the existing Booking instead. For special projections the message says it covers one of these days.

> [accordion] The special projection button is disabled
>
> Hover the button. It shows what is missing: **Choose a film**, **Choose a cinema**, or **Tick a language version**.

> [accordion] Regional version exceptions
>
> In bulk creation, an amber box lists cinemas whose region has no approved version. Tick **I reviewed these exceptions and want to create the bookings anyway.** to continue.

> [accordion] Create no more than 500 cinema-language Bookings at once
>
> Bulk creation stops at 500 cinemas times language versions. Split the work in two.

## Related

* [Move a Booking date](https://wiki.distribution-os.ch/bookings/move-a-booking-date.md)
* [Booking conditions and shares](https://wiki.distribution-os.ch/bookings/conditions-and-shares.md)
* [KDM and DCP Dispatch](https://wiki.distribution-os.ch/bookings/kdm-and-dcp.md)


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