# Entries

The `entries` field allows you to create and manage multiple entries for the same field.

****

- Since [5.0.0](https://github.com/getkirby/kirby/releases/tag/5.0.0)
- Read more: <https://getkirby.com/docs/guide/blueprints/fields>
- Source: <https://github.com/getkirby/kirby/tree/5.5.3/src/Form/Field/EntriesField.php>

****

The entries field allows you to create and manage multiple entries for the same field. It offers editors a flexible alternative to the <a href="https://getkirby.com/docs/reference/panel/fields/structure">structure field</a> for when they need to handle a list of content that only consists of one field.

<figure class="image"><a data-lightbox href="https://assets.getkirby.com/media/pages/docs/reference/panel/fields/entries/17a19d2eab-1750751812/entries.png?width=1586&amp;height=1170&amp;enlarge=0"><img alt="" class="rounded" height="682" loading="lazy" sizes="auto" src="https://assets.getkirby.com/media/pages/docs/reference/panel/fields/entries/17a19d2eab-1750751812/entries.png?width=924&amp;height=682&amp;enlarge=0" srcset="https://assets.getkirby.com/media/pages/docs/reference/panel/fields/entries/17a19d2eab-1750751812/entries.png?width=462&amp;height=341&amp;enlarge=0 462w, https://assets.getkirby.com/media/pages/docs/reference/panel/fields/entries/17a19d2eab-1750751812/entries.png?width=690&amp;height=509&amp;enlarge=0 690w, https://assets.getkirby.com/media/pages/docs/reference/panel/fields/entries/17a19d2eab-1750751812/entries.png?width=924&amp;height=682&amp;enlarge=0 924w, https://assets.getkirby.com/media/pages/docs/reference/panel/fields/entries/17a19d2eab-1750751812/entries.png?width=1380&amp;height=1018&amp;enlarge=0 1380w, https://assets.getkirby.com/media/pages/docs/reference/panel/fields/entries/17a19d2eab-1750751812/entries.png?width=1586&amp;height=1170&amp;enlarge=0 1848w" width="924"></a></figure>

## Field properties

Property | Type | Default | Description
- | - | - | - |
autofocus | `bool` | - | Sets the focus on this field when the form loads. Only the first field with this property gets focus.
default | `array` | - | Default value for the field, which will be used when a page/file/user is created
disabled | `bool` | - | If true, the field is no longer editable and will not be saved
field | `array` | - | The options for the field to repeat. Supported field types are `color`, `date`, `email`, `number`, `select`, `slug`, `tel`, `text`, `time`, `url`.
help | | - | Optional help text below the field
label | | - | The field label can be set as string or associative array with translations
max | `int` | - | Maximum number of allowed entries
min | `int` | - | Minimum number of required entries
required | `bool` | `false` | If true, the field has to be filled in correctly to be saved.
sortable | `bool` | `true` | Whether you can manually sort the entries in the Panel
translate | `bool` | `true` | If false, the field will be disabled in non-default languages and cannot be translated. This is only relevant in multi-language setups.
when |  | - | Conditions when the field will be shown
width | `string` | `1/1` | The width of the field in the field grid. Available widths: `1/1`, `1/2`, `1/3`, `1/4`, `2/3`, `3/4`

## Usage

```yaml
entries:
  type: entries
  min: 2
  max: 4
  required: true
  field:
    type: select
    options:
      design: Design
      architecture: Architecture
      photography: Photography
      3d: 3D
      web: Web
```

### In templates/snippets

To easily loop through your entries and retrieve each entry as field object, you can use the new `$field->toEntries()` method:

```php
<ul>
  <?php foreach ($page->entries()->toEntries() as $entry): ?>
    <li><?= $entry->upper() ?></li>
  <?php endforeach ?>
</ul>
```