# Foreach

Loop through and render values from an array of named keys and values without needing to know the keys.


## Overview

Normally when you have data stored in a named array format perhaps created by the [array fieldtype](/fieldtypes/array.md), you would need to know the keys to render data in your view.

Using the `foreach` tag you can pass in variable name as the second argument in the tag name and loop through the data using `{{ key }}` and `{{ value }}`.

```yaml
company_info:
  address_1: 123 Hollywood Blvd
  address_2: Suite 404
  city: Beverly Hills
  state: California
  zip: 90210

song_reviews:
  Never Gonna Give You Up: 5/5
  My Heart Will Go On: 3/5
```
::tabs

::tab antlers
```antlers
{{ foreach:company_info }}
  {{ key }}: {{ value }}<br>
{{ /foreach:company_info }}

<ul>
  {{ foreach:song_reviews as="song|rating" }}
    <li>{{ song }}: {{ rating }}</li>
  {{ /foreach:song_reviews }}
</ul>
```
::tab blade

When authoring Blade templates, you should use the `@foreach` directive instead.

```blade
@foreach ($company_info as $key => $value)
  <li>{{ $key }}: {{ $value }}<br>
@endforeach

<ul>
  @foreach ($song_reviews as $song => $rating)
     <li>{{ $song }}: {{ $rating }}</li>
  @endforeach
</ul>
```
::

```html
Address 1: 123 Hollywood Blvd<br>
Address 2: Suite 404<br>
City: Beverly Hills<br>
State: California<br>
Zip Code: 90210

<ul>
  <li>Never Gonna Give You Up: 5/5</li>
  <li>My Heart Will Go On: 3/5</li>
</ul>
```

:::tip
PHP reserves the word `foreach`, so this tag is _technically_ an alias of `iterate` under the hood. If you're spelunking through the source code, that's where you'll find it.
:::

## Dynamic Variables

Instead of using the shorthand `{{ foreach:variable_name }}` syntax, you may pass in the array's name manually.

::tabs

::tab antlers
```antlers
{{ foreach array="song_reviews" }}
    ...
{{ /foreach }}
```
::tab blade
```blade
@foreach ($song_reviews as $review)
  ...
@endforeach
```
::

If you have a more complicated array location, you can use a dynamic parameter to pass the array itself.

```yaml
reviews:
  songs: [...]
```

::tabs

::tab antlers
```antlers
{{ foreach :array="reviews:songs" }}
    ...
{{ /foreach }}
```
::tab blade
```blade
@foreach ($reviews['songs'] as $song)
  ...
@endforeach
```
::