> ## 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.

# Add a film and set up its versions

> Create a film in Films, enter its release dates, age rating and SUISA ID, then add language versions, formats and aspect ratio on the Versions tab.

Every Booking needs a film. Add the film once in **Films**, give it release dates and then describe the versions you can play, such as OV with German and French subtitles. Versions decide what you can book and which DCPs fit which screens.

## Before you start

* You need the admin or operations role. With another role the Films page is read-only.
* Check that the film is not already listed. Use the search box on **Films**.

## Steps

**1. Open Films and start a new film**

Click **Films** in the Catalog section of the sidebar, then **Add film**. A panel opens titled **New film**.

**2. Enter the title**

Type the **Title** (required). To fill in the rest from public film data, click **Autofill**. It fills only empty fields and never overwrites what you typed. Check what it filled in.

**3. Fill in the film information**

On the **Details** tab, add the **Original title**, **Sigla**, **SUISA ID** and **Runtime**. Enter the **Age rating** for Switzerland (**CH**) and Ticino (**TI**). Leave it empty if the film is not rated yet. Add **Genres** and an **Overview**. You can upload artwork with **Upload artwork**.

**4. Enter regional titles and release dates**

Switch on **Different title per region** if the title changes by region. Under **Regional release schedule**, enter the release date for each of D-CH, F-CH and I-CH. The film's **First release** shows the earliest of them.

**5. Create the film**

Click **Create film**. The Versions, Materials and other tabs open up once the film is saved.

**6. Set up the versions**

Reopen the film and click the **Versions** tab. See the next section.

## Set up the versions

On the **Versions** tab:

**1. Add a language version**

Under **Add a language version**, choose the **Language** (for example OV) and tick the **Subtitles** it has: de, fr or it. No subtitles ticked means a version without subtitles. Click **Confirm version**. To add the same language with other subtitles, add it again.

**2. Choose regions and formats**

For each version row, tick the **Regions** where it is available (D-CH, F-CH, I-CH) and the **Formats** it comes in, such as 5.1, 7.1, 2.0, IAB, DBOX, 4DX, Screen-X, Cinity, IMAX or Blu-ray.

**3. Set the picture**

In the **Picture** line, choose 2D or 3D and the resolution. Use **+ Add picture** for another combination. Tick **Pre-release (Pre)** if this is a pre-release version.

**4. Set the aspect ratio**

In the **Aspect ratio** line, pick one value for the whole film, for example Scope or Flat. If versions differ, click **Different aspect ratio per version** and set each one. **Same aspect ratio for every version** switches back.

**5. Save the versions**

Click **Save versions**. **Discard** drops your unsaved changes.

The **Techsheet preview** shows the versions per region. Click **Techsheet PDF** to download it. The button is disabled until you have saved your version changes.

## What you'll see

The film appears in **Films** and in the film pickers of the Booking forms. Its status is automatic from the regional release dates unless you set a manual override in **Status**. Open the **KDM & DCP** tab to set the film's delivery rules. See [KDM and DCP](https://wiki.distribution-os.ch/bookings/kdm-and-dcp.md). You can then [create a Booking](https://wiki.distribution-os.ch/bookings/create-a-booking.md).

## If something looks wrong

> [accordion] The Versions tab says 'Save the film first to set up its versions.'
>
> Click **Create film** first, then reopen the film.

> [accordion] I cannot edit the film
>
> Your role is read-only on Films. The footer shows **Close** instead of **Cancel** and **Save changes**.

> [accordion] The Versions tab says 'No film versions have been published yet.'
>
> Nobody with edit rights has saved a version. Ask an admin or operations colleague to add them.

> [accordion] Techsheet PDF is greyed out
>
> You have unsaved version changes. Click **Save versions** first.

> [accordion] Preview and Pre-Start cannot be set
>
> They appear once a region has a release date and the film is saved.

> [accordion] I added the film by mistake
>
> See [Archive a film](https://wiki.distribution-os.ch/films/archive-a-film.md).

## Related

* [Archive a film](https://wiki.distribution-os.ch/films/archive-a-film.md)
* [Create a Booking](https://wiki.distribution-os.ch/bookings/create-a-booking.md)
* [KDM and DCP](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.