> For the complete documentation index, see [llms.txt](https://help.tillit.cloud/tillit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/asset-hierarchy/calendar/calendar-item.md).

# Calendar item

### Overview

Calendar items are used to store important information about the timing and duration of shifts. These items include three critical pieces of information: the shift item itself, the days of the week on which the shift runs, and the dates the shift is valid for.

When shifts are fixed and run regularly, the shift dates can be set years in advance. However, calendar items are also useful when companies run different shift patterns during peak times of the year. In such cases, the dates of the shifts can be easily adjusted to reflect the specific requirements of the production schedule.

### Creating a Calendar Item

{% hint style="info" %}
Go to **Settings >** **Asset Hierarchy >** **Calendars.** Then select the relevant **Calendar**, and locate the **Calendar Items** panel.
{% endhint %}

{% stepper %}
{% step %}
Click **Create**.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2FLEAT532vRqBN2PC04P1B%2Fimage.png?alt=media&amp;token=8a18e329-df33-4cb8-acf9-ccd6e40e8fdf" alt="Items panel highlighting the Create button"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
In the modal, fill in the required fields.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2FauZ3Ctkakj1eU4YupwbY%2Fimage.png?alt=media&amp;token=ec8a89af-e28e-463f-bc7c-b045af42623a" alt="Modal window titled Create Calendar Item with fields for Shift Template *, Calendar *, Valid From *, Valid To *, and toggle switches for days of the week (Monday through Sunday)"><figcaption></figcaption></figure>

{% hint style="info" %}
A Shift Template is required to create a Calendar Item. You can select a pre-existing one or create a new one directly from this dropdown (see [Shift Template](/tillit/knowledge-base/setting-up-tillit/asset-hierarchy/shifts/shift-patterns.md)).
{% endhint %}
{% endstep %}

{% step %}
Click the **Save and close** button to finalise.
{% endstep %}
{% endstepper %}

### Fields

| Name              | Description                                                                               |
| ----------------- | ----------------------------------------------------------------------------------------- |
| Shift Template \* | Select the shift template to apply to this calendar item.                                 |
| Calendar \*       | Select the parent calendar to which this item belongs.                                    |
| Valid From \*     | Enter the start date from which the calendar item becomes active.                         |
| Valid To \*       | Enter the end date until which the calendar item remains active.                          |
| Days of the week  | Toggle the switches (Monday through Sunday) to define exactly which days this shift runs. |