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

# Read film performance by week, region and film

> Use Bookings, Performance to compare weeks and weekends by film and region, see a film's whole run, and tell provisional from definitive figures.

Performance shows how your films are doing: admissions, box office and how they compare with the same days a week earlier. Open **Performance** in the **Programming** group of the sidebar. The page reads the results already saved on your Bookings. It does not change anything.

## Provisional or definitive figures

Every Booking is read from one of two sources, and the page tells you which.

* **Definitive** figures are the cinema's settlement report. A Booking switches to them once all its current invoices are issued (sent, exported to accounting or paid).
* **Provisional** figures are the daily reports and MaccsBox data. They are used for every other Booking and can still change.

A label above the page says **Provisional**, **Definitive** or **Mixed**, with a line explaining it, for example how many Bookings are definitive and how many are still provisional. Treat provisional numbers as a running estimate. See [Load provisional results from MaccsBox](https://wiki.distribution-os.ch/results/maccsbox-import.md) and [Check a cinema report](https://wiki.distribution-os.ch/results/check-a-cinema-report.md).

## Before you start

* You need access to the Performance page.
* Bookings need results. A Booking without figures shows a missing report, not a zero.
* The **Tickets**, **Top 25**, **Market comparables** and **Cinema Top 15** tabs only appear if you have access to Analytics.

## Choose what you see

**1. Pick the period**

Choose **Week** or **Date range**. In **Week** mode, pick the Thursday that starts the reporting week, or use the arrows and **Current**. In **Date range** mode, pick **From** and **To**, or use **Last 7 days**, **Last 14 days** or **Last 30 days**.

**2. Narrow to days (optional)**

In **Week** mode, day buttons show the eight days from **Wed opens** to **Wed closes**. Click days to include or leave them out. Presets cover **Full week**, the Thursday to Sunday weekend, the Friday to Sunday weekend and **Wed only**.

**3. Pick a film and regions**

Use the film list (**All films** by default) and the region buttons **D-CH**, **F-CH** and **I-CH**. You can select one or several.

**4. Pick a figure**

The figure list sets what charts and daily tables show: **Admissions**, **Box office**, **Cinemas**, **Admissions / cinema** or **CHF / admission**.

Your choices stay in the page address, so a reload or a shared link opens the same view.

> [!NOTE]
>
> F-CH weeks start on a Wednesday. D-CH and I-CH weeks start on a Thursday. A Wednesday in the middle of a selection combines the F-CH opening with the D-CH and I-CH closing of that date.

## The tabs

* **Overview**: totals (**Admissions**, **Gross box office**, **Cinemas**, **Admissions / cinema**, **CHF / admission**), weekend admissions and box office (Friday to Sunday), then **Regions**, **Films**, **Language versions** and **Day by day**. Each day shows how it compares with the same weekday a week earlier, and its share of the week or weekend.
* **Lifetime**: the whole run of one film.
* **Cinemas by day**, **Cities** and **Trends**: the same figures by cinema, by city and over several weeks.
* **Week report**: a printable summary of the selected week. **Film comparison** compares films.

**Coverage** columns show how many days were reported out of the days expected, so you can see where figures are missing. Turn on **Colour values** to colour changes: green above the **Neutral** threshold, red below it, neutral within it.

## See a film's whole run

Choose a film, then open the **Lifetime** tab. The period does not apply here, because the tab always shows the film's whole run, from first day to last, with **Still playing** or **Ended**. You get totals, **Opening weekend**, **Best day**, **Best week**, **Weeks in release**, the run **Week by week** or **Day by day**, **Top cinemas** and **Best cities**.

Two lists show **Did better than usual** and the opposite. Each cinema or city gets a verdict: **Overperforming**, **Doing okay**, **Underperforming** or **Not enough days yet**. The verdict compares a cinema's share of this film with its usual share of your other films over the two years before. Hover over a verdict for the reason. Special projections are left out.

You can also use **Lifetime** next to the date range when a film is chosen.

## Download a PDF

Open the menu (hint "PDF reports") and choose **This page PDF**, **General report** or **Custom report**. The PDF states which figures are definitive and which provisional.

## If something looks wrong

> [accordion] Numbers are lower than expected
>
> Look at **Coverage**. Days marked **Not reported** have no figures yet. Provisional figures also change as cinemas report.

> [accordion] Lifetime is greyed out
>
> The button says "Choose a film to see its lifetime". Select a film first.

> [accordion] A film says it is not booked or has no figures
>
> You see "is not booked yet" or "Its figures appear here once cinemas report". Create the Booking or load results.

> [accordion] A range is refused
>
> The longest date range is 92 days. Use a film's **Lifetime** for longer runs.

> [accordion] The PDF fails
>
> A red message "Could not build the PDF." appears. Try again.

> [accordion] No verdict for a cinema
>
> **Not enough days yet** means too few days, cinemas or admissions to judge.

> [!NOTE]
>
> Two weekends appear on this page. The weekend tiles and columns on **Overview** count Friday to Sunday. The **Week report** shows "of which weekend Thu–Sun". The day presets let you pick either one.

## Related

* [Load provisional results from MaccsBox](https://wiki.distribution-os.ch/results/maccsbox-import.md)
* [Check a cinema report](https://wiki.distribution-os.ch/results/check-a-cinema-report.md)
* [Create a Booking](https://wiki.distribution-os.ch/bookings/create-a-booking.md)


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