> 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/activity-templates/activity/creating-an-activity.md).

# Creating an activity

## Creating a new Activity Template

{% hint style="info" %}
On ***Settings > Activity Template > Activity Template***
{% endhint %}

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

<figure><img src="/files/yLJFIUzOsPvody2mf4Wr" alt="Activity Template interface highlighting the Create action button"><figcaption></figcaption></figure>

The Activity Template creation window guides you through 3 setup steps before you can add Activity Items.
{% endstep %}

{% step %}
Firstly fill in the **Basic information** fields required.

<figure><img src="/files/5fgpISx3TBHeE6k6Lzvf" alt="Step 1 of the Activity Template modal displaying Basic Information fields"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Then fill [Where](/tillit/knowledge-base/setting-up-tillit/activity-templates/activity/where.md) this activity will be available.

<figure><img src="/files/r0aYfzhNWj1r0GGH9NcL" alt="Step 2 of the Activity Template modal titled &#x27;Where will this activity be available&#x27; showing location conditions"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Lastly fill in [When](/tillit/knowledge-base/setting-up-tillit/activity-templates/activity/when.md) this activity will be triggered

<figure><img src="/files/pWClmQ7OIKDGB1oF2LNO" alt="Step 3 of the Activity Template modal titled &#x27;When should this trigger&#x27; showing trigger conditions"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Save and close** (or **Save and open**) to finalise.
{% endstep %}
{% endstepper %}

### **Fields**

<table><thead><tr><th width="320">Name</th><th>Description</th></tr></thead><tbody><tr><td>Activity name *</td><td>this is the text name of the activity</td></tr><tr><td>Activity Key *</td><td>this is the key name that the system will use in linking the items. The name should be unique (no spaces or special characters allowed). </td></tr><tr><td>Activity Description</td><td>this is the description of the activity.</td></tr><tr><td>Activity Class</td><td>classes can be used to group activities, making it easier to maintain them</td></tr><tr><td>Article</td><td>Articles allow you to provide documentation with an activity. Use this section to choose which of your articles to attach.</td></tr><tr><td>Expiry In</td><td>sets the expiry time of the created activity. This will set the activity status to expire once the expiry setting is reached.</td></tr><tr><td>Priority</td><td>sets the priority of the activity (default is "Low")</td></tr><tr><td>Display Order</td><td>sets the order where the activity will be displayed in the list.</td></tr><tr><td>Color</td><td><p>Sets the color indicator displayed on the left border of the activity card, helping operators quickly identify or categorize activities visually</p><p><img src="/files/tYNg3ZJb7ul68Q7EVWlv" alt="" data-size="original"></p></td></tr><tr><td>Comments Required</td><td>controls when operators must enter a comment on submission: <strong>On Fail</strong> — required only when the activity result is a failure; <strong>Always</strong> — required on every submission; <strong>Never</strong> — optional and never enforced</td></tr><tr><td>Claimable by</td><td>Defines the user groups or roles permitted to manually claim and take ownership of this activity</td></tr><tr><td>Auto-claimable by</td><td>Defines the user groups or roles for which the system will automatically assign and claim the activity upon creation or trigger</td></tr><tr><td>Startable by</td><td>the user groups that will have permission to start/create the activity from the 'Start Activity' button. This is different to User Groups field as that defines who can perform an activity</td></tr><tr><td>Skippable By</td><td>Defines the user groups or roles allowed to skip or bypass the execution of this activity when active</td></tr><tr><td>On Order Complete</td><td>define what should happen to an active activity when the order it is attached to is completed</td></tr><tr><td>On Order Suspend</td><td>define what should happen to an active activity when the order it is attached to is suspended</td></tr><tr><td>On Shift End</td><td>define what should happen to an active activity when the shift it is attached ends</td></tr><tr><td>Trigger Retest</td><td>Select whether a retest workflow is required in the event that the activity fails.</td></tr><tr><td>Required Before Order Action</td><td>Blocks specific order action(s) (e.g. Start, Complete) until the activity has been submitted.<br>The order action is not blocked if the activity is in an Expired or Skipped state.</td></tr></tbody></table>