# Option list

### Creating a new Option List

Go to **Settings > Activity Template > Option Group > Create**

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

**Enter a name** for the Option list and select a type.

Once you've chosen the type, select ***Save and open*****.**

### Option List Types

<table><thead><tr><th width="149">Type</th><th width="293">Description</th><th>Image Examples</th></tr></thead><tbody><tr><td><strong>SINGLE</strong></td><td><p>Presents all options, allowing the operator to only select one item in the list.</p><p>The following example shows a single option list -><br></p></td><td><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-66d30b1861ece542e8840c9de34cfef0721a6623%2Fimage.png?alt=media" alt="" data-size="original"></td></tr><tr><td><strong>MULTIPLE</strong></td><td><p>Presents all options, allowing the operator to only select multiple items in the list.</p><p>The following example shows a multiple option list -></p></td><td><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-2a620bdbb6e870ec5169b46c321467fc57349298%2Fimage.png?alt=media" alt=""></td></tr><tr><td><strong>TREE</strong></td><td><p>Uses Parent-Child relationships to allow the user to drill down to a more detailed response quickly. The first option will be the main parents, moving onto each child until there are no more children in the list.</p><p>The following example shows a tree option list that has four branches -></p></td><td><p><strong>Level 1:</strong></p><p><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-9b64184cd2d7fd592b05ce555b9cb87f53683fd1%2Fimage.png?alt=media" alt=""><br><strong>Level 2:</strong><br><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-1427546ceb274e519f8ba2801cc7246b11d58e7f%2Fimage.png?alt=media" alt=""><br><strong>Level 3:</strong><br><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-59a62a17d893980c4599d11db5b0ef587945e36f%2Fimage.png?alt=media" alt=""><br><strong>Level 4:</strong><br><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-89f5010532ad5bedb495bdb2452f43578e0b5dc7%2Fimage.png?alt=media" alt=""><br></p></td></tr><tr><td><strong>DOWNTIME_ REASON</strong></td><td><p>Uses same Parent-Child relationships as TREE type (see example above), but allows you to define each answer's downtime type as either PLANNED or UNPLANNED.</p><p>If the reason is PLANNED, this will not affect OEE metrics, but if it is UNPLANNED, it will start to negatively affect availability in OEE.</p></td><td></td></tr></tbody></table>

### Adding Items

Once you've created your option list, you will need to add items for the list.

Under **Activity Item Option Item**, click **Create**; and fill out the fields.

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

<div align="center"><figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-51fcb0d7687140eaee0343e6c4e43c256c999683%2Fimage.png?alt=media" alt="" width="277"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="168.33333333333331">Field</th><th width="253">Description</th><th>Image Example</th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>This will be what is visible on the list.</td><td></td></tr><tr><td><strong>Parent</strong></td><td>Parent is required for TREE and DOWNTIME_REASON types only.</td><td></td></tr><tr><td><strong>Value</strong></td><td>Enter a Value; this is the value of the selection.<br><br>For example, you may want <em>Yes</em> and <em>No</em> as the options in the list, but the value be Boolean-></td><td><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-670ac8d25334042cc166669e2663c086eed91c6f%2Fimage.png?alt=media" alt=""></td></tr><tr><td><strong>Pass checkbox</strong></td><td>Allows you to decide whether choosing that item will pass or fail the activity. Tick the box to pass; untick the box to fail.<br></td><td><br><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-c1ba2bc3134abef660a2c70918c5e6124a542ea7%2Fimage.png?alt=media" alt=""><br><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-841bd721538df0b18d71b24e776825a45bc5b619%2Fimage.png?alt=media" alt=""></td></tr><tr><td><strong>Display Order</strong></td><td>Sets the order in which the item appears in the list, starting with 0 being first. There is no upper limit.</td><td></td></tr><tr><td><strong>Required checkbox</strong></td><td>Used to define a certain level of classification. When completing the form, if any child of the current selected option item has a required field, then the form is invalid and cannot be submitted.</td><td><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-6f69cc56fa30cc877776bb816152162160648944%2Fimage.png?alt=media" alt=""></td></tr></tbody></table>

When the form is being filled out, the submit button is disabled until the item on this level is selected (Note that any item can be selected to meet the requirements, since any item contains no children that are required)

![](https://s3.amazonaws.com/helpscout.net/docs/assets/60208fd212248b2c96d50eeb/images/63698321aa984a61e2085fea/file-KFJtDUzSHY.png)
