> 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.md).

# Calendars

## Overview

Calendars are used to set up shifts against an asset.

## Creating a Calendar

{% hint style="info" %}
To create a **Calendar**, go to ***Settings > Asset Hierarchy > Calendars***.
{% endhint %}

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fw86a8GIc4zJOaJmpij2U%2Fimg.png?alt=media&amp;token=75c74a2d-16be-4492-b320-71077dd72779" alt="TilliT left navigation sidebar highlighting the path Settings > Asset Hierarchy, with &#x22;Calendars&#x22; highlighted" width="151"><figcaption></figcaption></figure>

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

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2FB6rodWrPMBneYHg7S02T%2Fimage.png?alt=media&amp;token=6a56f57f-c538-4c8b-9443-8f40f212c40a" alt="Calendar section highlighting the Create button"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
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%2FYgHb0fjKQvILBliYkGMH%2Fimage.png?alt=media&amp;token=58add9ce-93f7-4eca-83ce-0440c43f8207" alt="Modal window titled &#x22;Create Calendar&#x22; containing an input field labeled &#x22;Name *&#x22; and action buttons at the bottom"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **Save and open** button.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Now you need to create a [Calendar Item](/tillit/knowledge-base/setting-up-tillit/asset-hierarchy/calendar/calendar-item.md) to assign it to specific days of the week and define its validity period.
{% endhint %}

#### Fields

| Name    | Description              |
| ------- | ------------------------ |
| Name \* | The name of the calendar |

### Assigning a Calendar to an Asset

To make use of your shift patterns, you need to assign your calendar to the desired asset.

{% hint style="info" %}
Navigate to **Settings > Asset Hierarchy > Assets**. Then select the relevant **Asset**, locate the **Basic Information panel**.
{% endhint %}

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2FTEyB5TbyswnkQ0blZ5FV%2Fimg.png?alt=media&amp;token=3bf6cff0-df8c-4737-838c-10f0747e2b8a" alt="TilliT left navigation sidebar highlighting the path Settings > Asset Hierarchy, with &#x22;Assets&#x22; highlighted" width="151"><figcaption></figcaption></figure>

{% stepper %}
{% step %}
Click on the **Calendar field**.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2F8aeuMNMTfsIeMEjQsKg9%2Fimg.png?alt=media&amp;token=0a3605b7-b674-4569-99b2-4fe66948b19c" alt="Line 01&#x22; Asset Basic Information dashboard displaying asset details and the Calendar dropdown field highlighted"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
From the dropdown list, select the desired Calendar for the Asset.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2FQdxyDxO99VTqvllFl2Cv%2Fimage.png?alt=media&amp;token=ac67f7ea-b8bd-4f28-91f9-84331502acef" alt="Expanded &#x22;Calendar&#x22; dropdown list showing a search bar and options to select calendars"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

When you assign a calendar to an asset, TilliT automatically checks whether a shift would currently be running based on the calendar configuration. If a shift is active at that moment, it starts immediately — you do not need to wait for the next scheduled occurrence.

{% hint style="info" %}
This provides instant feedback so you can confirm your calendar configuration is working as expected right away.
{% endhint %}