> For the complete documentation index, see [llms.txt](https://docs.documint.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.documint.me/templates/working-with-dynamic-data/functions-and-operators/functions/list-arrays/each.md).
# #each
This is different than the other functions because it has an opening (`{{#each}}`) and closing (`{{/each}}`) tag and uses an `#` instead of a `$` to prefix the function name. The content within the opening and closing tags is set to the context of the current item in the loop. This means that any variables used within the opening and closing tags are relative to the current item in the loop. If the list of items being looped over is a list of objects, then variable names will represent properties on that object. See example below.
#### Signature
`{{#each array }}{{this}}{{/each}}`
#### Arguments
Name
Description
Type
Required
array
List of items to repeat/loop over
String Array, Number Array, Boolean Array, Object Array, Array Array
true
#### **Returns**
Content within the opening and closing tags, for each item in the given array/list.
#### **Example - Array of Objects**
In this example we're looping over an array/list of Objects. We can access the properties of the current object in the loop simply by using the name of the property. In the case below, we're displaying the `name` property of each object using the `{{name}}` token. This works because the within the opening and closing tags of the `#each` function, the context is set to the current item in the loop.
{% tabs %}
{% tab title="Template" %}
```handlebars
{{#each characters}}{{name}}, {{/each}}
```
{% endtab %}
{% tab title="Data" %}
```json
{
"characters": [
{ "name": "Wile E. Coyote", "email":"wile.coyote@acme.co" },
{ "name": "Road Runer", "email":"road.runner@acme.co" }
]
}
```
{% endtab %}
{% tab title="Result" %}
Wile E. Coyote, Road Runner
{% endtab %}
{% endtabs %}
#### **Example - Array of Strings**
In this example, we're looping over an array/list of Strings. We use the `this` keyword to reference the current item in the loop. `this` always represents the current item in the loop, even when looping over data types other than Strings.
{% tabs %}
{% tab title="Template" %}
```handlebars
{{#each characters}}{{this}}, {{/each}}
```
{% endtab %}
{% tab title="Data" %}
```json
{
"characters": [ "Wile E. Coyote", "Road Runer" ]
}
```
{% endtab %}
{% tab title="Result" %}
Wile E. Coyote, Road Runner
{% endtab %}
{% endtabs %}
---
# 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://docs.documint.me/templates/working-with-dynamic-data/functions-and-operators/functions/list-arrays/each.md?ask=&goal=
```
`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.