> For the complete documentation index, see [llms.txt](https://viewzenlabsug.gitbook.io/userguides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://viewzenlabsug.gitbook.io/userguides/appverse/apps/create-an-app/forms/create/get-familiar/choices.md).

# Choices

Choices allow you to define static lists for single or multi-select form fields. While these lists are inherently static, additional values can be manually added. For offline forms, new choice values become available after the form is synced. In online forms, all values that make the single or multi-select field are displayed when clicked.

<figure><img src="/files/BCpMsbrFQnxaDX05mPrO" alt=""><figcaption><p>Choice Option</p></figcaption></figure>

<figure><img src="/files/Y3vHzLTe8TgMxSEfqNaD" alt="" width="375"><figcaption><p>Choices</p></figcaption></figure>

### Examples

For example, your form includes a dropdown field to capture employees' gender. Users can select either Male, Female, or Other Gender. In such cases, the choices option can be used to create a predefined list, as shown below.

* List Name - Gender

This list will have three items

* Item 1 - Male
* Item 2 - Female
* Item 3 - Other Gender

This list can then be associated to the "gender" field.

### Choices Configuration

To create a pre-defined list, the following has to be configured

#### List Configuration

* List Name - This is used to assign a logical name for easy identification of the list during association
* Filter (Hierarchical) - By default, it is disabled. However, if the dropdown is hierarchical, meaning its values depend on the selection from another list, this option should be enabled.
  * Select List - This option is shown only for hierarchical lists. The dependent list should be provided here.

#### Item Configuration

* Item Name - This is an internal name used to unqiuely identify this value.
* Item Label - The text in the label field is displayed in the dropdown of the form.
* Options - This field is shown only for hierarchical lists. The list of values from the associated dependent list shoud be provided here.&#x20;

{% hint style="info" %}
You can create as many lists as you like in this section
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://viewzenlabsug.gitbook.io/userguides/appverse/apps/create-an-app/forms/create/get-familiar/choices.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.