> 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

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="/files/OLFv286J31v6AkXEkbqk" alt="User Profile page in TilliT showing the Subscriptions list section."><figcaption></figcaption></figure>

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

<figure><img src="/files/REnketRyfBoaGGYw0bAn" 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.                                                        |

## 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="/files/Zt0txOgAX0QGec34VAWI" 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="/files/NBZe44UoMAL1YbEz8fI6" 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 %}

## 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="/files/UFfYsUwzCtctekG32TpC" 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="/files/UFfYsUwzCtctekG32TpC" 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="/files/MigdcryBMm9UklzlT2gB" 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 %}