# When

### Overview

In this section, you will set the when this activity will trigger.

If left blank, the activity won't trigger with any event, but can be triggered manually. Even when a trigger is assigned, you can still trigger an activity manually,

![](https://s3.amazonaws.com/helpscout.net/docs/assets/60208fd212248b2c96d50eeb/images/625fa72735f8b26458265f33/file-htfV1xeQF1.png)

#### Adding a Trigger

When you click "Add a trigger", you will be given the following groups to choose a trigger from:

![](https://s3.amazonaws.com/helpscout.net/docs/assets/60208fd212248b2c96d50eeb/images/629062b68c9b58508348d919/file-uwljc7Ntr4.png)

Under each group will be multiple options.

**Equipment Events**

Equipment status is controlled via Edge using an integration with some from of SCADA (e.g. Inductive Ignition). The events are as follows:

* Equipment blocked
* Equipment completed
* Equipment ready
* Equipment running
* Equipment starved
* Equipment stopped
* Equipment suspended

![](https://s3.amazonaws.com/helpscout.net/docs/assets/60208fd212248b2c96d50eeb/images/62906347c01fce37d9b17116/file-QAQlHdA5u1.png)

When you select an equipment event, you have the option to enter an interval for how often the activity will trigger (e.g. every 15minutes) and/or a delay between the event and when the activity triggers for the first time (e.g. 30mins after the event).

### **Order Events**

Order status can be controlled either in TilliT or via Edge using tags from SCADA. The events are as follows:

* Order cancelled
* Order completed
* Order paused
* Order ready
* Order resumed
* Order started

![](https://s3.amazonaws.com/helpscout.net/docs/assets/60208fd212248b2c96d50eeb/images/629063cd68d51e7794444489/file-YbWTyQiLgW.png)

When you select an order event, you have the option to enter an interval for how often the activity will trigger (e.g. every 15minutes) and/or a delay between the event and when the activity triggers for the first time (e.g. 30mins after the event).

### **Activity Events**

Activity status is controlled in TilliT. The events are as follows:

* Activity expired
* Activity failed
* Activity failed retest
* Activity manually started
* Activity passed
* Activity skipped

![](https://s3.amazonaws.com/helpscout.net/docs/assets/60208fd212248b2c96d50eeb/images/629064018bf21a2e2b6d7ff7/file-XYk5gi10XS.png)

When you select an activity event, you have the option to enter an interval for how often the activity will trigger (e.g. every 15minutes) and/or a delay between the event and when the activity triggers for the first time (e.g. 30mins after the event).

![](https://s3.amazonaws.com/helpscout.net/docs/assets/60208fd212248b2c96d50eeb/images/6290640d68d51e779444448a/file-u3Log5fjhX.png)

For Activity triggers, you can select the specific activity you want to reference when. For example, you may want to trigger one activity when the Approval to Start - Filler activity passes.

If you don't set an activity key, then the trigger will apply to all activities. For example, you may want to trigger an activity called ***Team Lead Intervention*** when any activity fails a retest.

### **Shift Events**

Shift events happen when shift patterns start and end. The events are as follows:

* Shift ended
* Shift started

![](https://s3.amazonaws.com/helpscout.net/docs/assets/60208fd212248b2c96d50eeb/images/6290642a68d51e779444448b/file-KyQrWFb85Z.png)

When you select a shift event, you have the option to enter an interval for how often the activity will trigger (e.g. every 15minutes) and/or a delay between the event and when the activity triggers for the first time (e.g. 30mins after the event).

Shift Templates are set via Asset Hierarchy > Shift Templates.

### **Custom Events**

Custom Events that are created in TilliT will be available here. For more details, see [Event Type](/tillit/knowledge-base/setting-up-tillit/events/event-type.md).

![](https://s3.amazonaws.com/helpscout.net/docs/assets/60208fd212248b2c96d50eeb/images/629064528bf21a2e2b6d7ff8/file-mMYyf9SxV8.png)

When you select an custom event, you have the option to enter an interval for how often the activity will trigger (e.g. every 15minutes) and/or a delay between the event and when the activity triggers for the first time (e.g. 30mins after the event).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/activity-templates/activity/when.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.