# Image field

Select or upload images from media.

Use for cover images, thumbnails, galleries, logos.

## Options

Key | Description
--- | ---
<code class="text-[var(--prism-keyword)]">media</code> | Named media config to use (e.g. `"images"`).
<code class="text-[var(--prism-keyword)]">path</code> | Default browsing folder (e.g. `"blog"`).
<code class="text-[var(--prism-keyword)]">multiple</code> | Allow multiple images (e.g. `{ max: 6 }`).
<code class="text-[var(--prism-keyword)]">extensions</code> | Allowed image extensions (e.g. `["jpg", "png", "webp"]`).
<code class="text-[var(--prism-keyword)]">categories</code> | Allowed image categories. Values: `image`.
<code class="text-[var(--prism-keyword)]">unique</code> | If `true`, disallows duplicate image paths when `multiple` is enabled.
<code class="text-[var(--prism-keyword)]">rename</code> | Controls upload renaming. Use `false` to keep the original filename, `true` or `safe` to slugify it, or `random` for a generated name.

## Examples

### Named media config and default folder

```yaml
- name: cover
  label: Cover image
  type: image
  options:
    media: images
    path: public/images/posts
```

### Multiple images

```yaml
- name: gallery
  label: Gallery
  type: image
  options:
    multiple:
      max: 6
    unique: true
    extensions: [jpg, png, webp]
    rename: true
```

### Category-based restriction

```yaml
- name: thumbnail
  label: Thumbnail
  type: image
  options:
    categories: [image]
```