> 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 This guide walks you through the steps required to configure, define, and launch a new Activity Template from scratch. ## Creating a new Activity Template {% hint style="info" %} On ***Settings > Activity Template > Activity Template*** {% endhint %} {% stepper %} {% step %} Click **Create**.

Activity Template interface highlighting the Create action button

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.

Step 1 of the Activity Template modal displaying Basic Information fields, including the Wide form toggle

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

Step 2 of the Activity Template modal titled 'Where will this activity be available' showing location conditions

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

Step 3 of the Activity Template modal titled 'When should this trigger' showing trigger conditions

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

Name	Description
Activity name *	this is the text name of the activity
Activity Key *	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).
Activity Description	this is the description of the activity.
Activity Class	classes can be used to group activities, making it easier to maintain them
Article	Articles allow you to provide documentation with an activity. Use this section to choose which of your articles to attach.
Expiry In	sets the expiry time of the created activity. This will set the activity status to expire once the expiry setting is reached.
Priority	sets the priority of the activity, Low, Medium, High or Mandatory (default is "Low").
Display Order	sets the order where the activity will be displayed in the list.
Color	Sets the color indicator displayed on the left border of the activity card, helping operators quickly identify or categorize activities visually
Wide Form	When enabled, this activity always opens in the side panel on desktop rather than the inline dashboard column, giving items with configured widths room to sit side by side.
Comments Required	controls when operators must enter a comment on submission: On Fail — required only when the activity result is a failure; Always — required on every submission; Never — optional and never enforced
Claimable by	Defines the user groups or roles permitted to manually claim and take ownership of this activity
Auto-claimable by	Defines the user groups or roles for which the system will automatically assign and claim the activity upon creation or trigger
Startable by	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
Skippable By	Defines the user groups or roles allowed to skip or bypass the execution of this activity when active
On Order Complete	define what should happen to an active activity when the order it is attached to is completed
On Order Suspend	define what should happen to an active activity when the order it is attached to is suspended
On Shift End	define what should happen to an active activity when the shift it is attached ends
Trigger Retest	Select whether a retest workflow is required in the event that the activity fails.
Required Before Order Action	Blocks specific order action(s) (e.g. Start, Complete) until the activity has been submitted. The order action is not blocked if the activity is in an Expired or Skipped state.