> For the complete documentation index, see [llms.txt](https://examind.gitbook.io/v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://examind.gitbook.io/v1/examind-platform/build/question-builder/dynamic-questions/dynamic-engine/lists.md).

# Lists

## The List Blocks

There are twelve *list* blocks you can use in the Dynamic Engine. This article focuses on the three most common blocks you will use:

1. Create List With
2. Make List From Text
3. In List Get

### List: Create List With

The **create list with** block assigns a list of values to your variable. This allows you to group items together while also maintaining their independence from one another.

For example, this sets the value of the variable named "List of Colors" to "Red,Blue,Green,Yellow". The colors are separated by a comma when stored in the Dynamic Engine.

<figure><img src="/files/ihC4VFNDQyTxm6TxsrCS" alt=""><figcaption></figcaption></figure>

### List: Make List From Text

The **make list from text** block does the same thing as the **create list with** block. It works great when you have a really large list that you want to add to the Dynamic Engine because it saves time by not having to drag and drop blocks.\
\
For example, this sets the value of the variable named "List of Colors" to "Red,Blue,Green,Yellow" (same as above).

<figure><img src="/files/N4tEMIr87BXBUbvjcslr" alt=""><figcaption></figcaption></figure>

The colors are separated by a comma when stored in the Dynamic Engine. The most common delimiter that people use with computers is a comma. We blew our intern's mind when we showed them that .csv files from excel stands for **C**omma **S**eparated **V**alues. 🤯

{% hint style="info" %}
There are no spaces when using the delimiter, unless you specify the delimiter to have a space.
{% endhint %}

### List: In List Get

The **in list get** block pulls a value out of the list. This is useful when you want to pull a random value from a list. For example, this sets the value of the variable named "Random Color" to either "Red", "Blue", "Green", or "Yellow".

<figure><img src="/files/gLsbsU1MLBhdt0xctAEQ" alt=""><figcaption></figcaption></figure>

The way this works is we first want to create a list. In this case, the list is called "List of Colors". Then, we want to create a new variable called "Random Color" that uses the **in list get** block from, and specify that we want a random value from the list.\
\
The options for the **get** dropdown are:

* **Get** - retrieves a value from the list, leaving the list unchanged
* **Get and Remove** - retrieves a value from the list, removes it and updates the list
* **Remove** - removes a value from the list and updates the list

For example, the following blocks could result in the variable "Random Color" being "Green" and the list becoming "Red,Blue,Yellow".

<figure><img src="/files/KKMINzQRkRx0h1uIYEEr" alt=""><figcaption></figcaption></figure>

The options for the **#** dropdown are:

* **#** - retrieves a value from a specific position in the list (e.g., the 2nd value would be "Blue")
* **# from end** - retrieves a value from a specific position in the list, counting from the end
* **First** - retrieves the first value in the list
* **Last** - retrieves the last value in the list
* **Random** - retrieves a random value in the list

***

## Example Question

Consider the following multiple-choice question.

<figure><img src="/files/zNuPTUuiyllehvaZc9be" alt=""><figcaption></figcaption></figure>

The goal of this question is to add a custom list of long-term assets and current assets.

Here is what the Dynamic Engine would look like:

<figure><img src="/files/jc6w2mOYt7zA9C6t1FeS" alt=""><figcaption></figcaption></figure>

In this example, we use the **create list with** block to generate a list of values and the **in list get** block to assign a random value to the variable "Long-term-Asset". Then, we use the **get and remove** feature to pull values for "Current Asset 1" and "Current Asset 2" based on the "List of Current Assets".

Here is what the sample question would look like (values highlighted in blue for convenience):

<figure><img src="/files/dABBflyx1pLfn2DyNTDY" alt=""><figcaption></figcaption></figure>


---

# 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, and the optional `goal` query parameter:

```
GET https://examind.gitbook.io/v1/examind-platform/build/question-builder/dynamic-questions/dynamic-engine/lists.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.