> 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/users/manage/user-subscriptions.md).

# User Subscriptions

Configure subscriptions to receive event-driven notifications via email or other channels, with optional Report Template output.

After completing the user channel definition, the second step to complete the notification setup is to configure the **subscription**.

To see all current subscriptions configured for a user, navigate to your user profile page. Expand the ***Subscriptions*** panel and click ***Create***.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2FIu4XaWLtgqsxI8cFYoi5%2Fa.png?alt=media&amp;token=3c32a7d1-a960-44cf-b5e8-bf55473e0ca4" alt="User Profile page in TilliT showing the Subscriptions list section."><figcaption></figcaption></figure>

Fill in the form and click ***Save***.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-13a447ee5d2ca70f16ebbf227c74dd42e8dfe544%2Fimage.png?alt=media" alt="Create Subscription dialog form containing dropdown fields for Channel, Event Type, Site, Parent Asset Class, Asset Class, Parent Asset, and Asset." width="563"><figcaption></figcaption></figure>

## Fields

| Field                  | Description                                                                                                                                                                                       |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Channel \***         | The channel you are subscribing to. If you are using [User Channels](/tillit/knowledge-base/users/manage/user-channels.md), find your username.                                                   |
| **Event Type \***      | Event trigger you want to use. If you only select an event type, you will receive payloads every time that event triggers. Using the other fields allows you to make more specific subscriptions. |
| **Site**               | A specific site you want.                                                                                                                                                                         |
| **Parent Asset Class** | Filters for all assets whose parent assets have this asset class.                                                                                                                                 |
| **Asset Class**        | A specific asset class. Filters for all assets under that class.                                                                                                                                  |
| **Parent Asset**       | Filters for all assets that have this parent asset.                                                                                                                                               |
| **Asset**              | A specific asset you want.                                                                                                                                                                        |
| **Report Template**    | Available for email channel types only. Choose the Report Template that defines the content and layout of the email body and attached PDF.                                                        |
| **Shift Template**     | Only shown when **Event Type** is **Shift Started** or **Shift Ended**. Choose the Shift Template this subscription triggers for.                                                                 |

## Get Your Report Sent with the Subscription

When a [**Report Template**](/tillit/knowledge-base/setting-up-tillit/configuration/creating-and-using-report-templates.md) is selected on an email subscription, a PDF report is **always** attached to the notification email. You can also choose to include the rendered HTML content directly in the email body.

This lets you customise your report body in the email and the attached generated PDF using the HTML and existing configurations of the Report Template you choose.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-bf3c0236e1324eb9eee1450e98d4947c4bd761b1%2Fsubscriptions-report-template-preview.png?alt=media" alt="Production Order Report preview interface displaying Activities Overview and Activities Details tables with pass/fail results."><figcaption><p>HTML generated in the Report Template preview</p></figcaption></figure>

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-5cf7393a4e338922d88017c1cbce5e360f1a3b46%2Fsubscriptions-report-template-email.png?alt=media" alt="Received email notification for a completed order containing an embedded HTML Production Order Report with activity details and action buttons."><figcaption><p>The same generated HTML included in the email body</p></figcaption></figure>

{% hint style="info" %}
Configure activity filtering (which activities and items appear in the report) in the Report Template settings, not in the subscription form.
{% endhint %}

## Shift-Triggered Subscriptions

Selecting **Shift Started** or **Shift Ended** as the Event Type reveals a **Shift Template** field. This lets you trigger the subscription only for shift instances of the chosen Shift Template — useful for automated end-of-shift reporting without requiring an active order. Combine this with a SHIFT type [Report Template](/tillit/knowledge-base/setting-up-tillit/configuration/creating-and-using-report-templates.md#shift-reports) to email a report as soon as the shift ends.

## Reporting Period for Board Report Subscriptions

When you attach a BOARD type [Report Template](/tillit/knowledge-base/setting-up-tillit/configuration/creating-and-using-report-templates.md#board-reports) to a subscription, a **Reporting period** field controls how much historical data each generated report covers, independent of how often the subscription fires.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-d79c008305782f5c78e2759e3f12050b667a26a2%2Fboard-report-templates-20260919152327.png?alt=media" alt=""><figcaption></figcaption></figure>

| Option                     | Description                                                                                                                                                                                                                                                                                                                                                         |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **The event's own window** | Only available for events that naturally span a period, such as a shift ending or an order lifecycle event (completed, paused, resumed, cancelled, changeover-overrun, changeover-resumed). If you switch the trigger to an event without a natural window (e.g. a shift or order *starting*), this option disappears and is cleared if it was previously selected. |
| **Day / Week / Month**     | A rolling window of that length, ending at the moment the event fires.                                                                                                                                                                                                                                                                                              |
| **Custom**                 | Enter a specific number of days for the window. There's no upper limit enforced — preview the report template first with that many days selected, to check it won't hit a row or size limit.                                                                                                                                                                        |

The form shows a summary line stating exactly what window will be used, e.g. "the 7 days ending at the event" or "the shift's own duration":

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-d79c008305782f5c78e2759e3f12050b667a26a2%2Fboard-report-templates-20260919152327.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Fan-out warning:** if the trigger event fires per individual asset (e.g. an equipment status change, or an operator check-in/out) but the attached report isn't scoped to one specific asset, every time the event fires for *any* asset the same broad report gets sent again. Review and acknowledge the warning before saving — it doesn't block saving — or scope the report to a single asset instead.
{% endhint %}

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-61391f0ada5f16e484886fdc64dfdd568b2b5647%2Fboard-report-templates-20260919152340.png?alt=media" alt=""><figcaption></figcaption></figure>

## Legacy Subscriptions

Subscriptions created before this update may have **Activities Included** and **Choose activity criteria** fields. These fields are now retired and will appear as read-only with a warning message.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-ef95fb114fb54d2b62ae1f17220bef4c3409bc97%2Fsubscriptions-report-old-warning.png?alt=media" alt="Edit Subscription window displaying an orange warning box informing that legacy activity criteria fields are deprecated."><figcaption><p>Warning shown on a legacy subscription</p></figcaption></figure>

If you select a Report Template on a legacy subscription, an additional warning indicates that the legacy activity settings will be ignored — the Report Template configuration takes priority.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-ef95fb114fb54d2b62ae1f17220bef4c3409bc97%2Fsubscriptions-report-old-warning.png?alt=media" alt="Edit Subscription window displaying an orange warning box informing that legacy activity criteria fields are deprecated."><figcaption><p>Warning shown when a Report Template is selected on a legacy subscription</p></figcaption></figure>

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-b808674759c1c044032d01e87b6d6d8544872e1f%2Fsubscriptions-report-old-email-style.png?alt=media" alt="Standard notification email layout for a completed order generated by a legacy subscription."><figcaption><p>Email output using a legacy subscription (no Report Template)</p></figcaption></figure>

{% hint style="warning" %}
It is recommended to delete legacy subscriptions and create new ones. Legacy subscriptions will continue to work, but the **Activities Included** and **Choose activity criteria** fields cannot be edited.
{% endhint %}