# Rich-text field

WYSIWYG editor for formatted content.

Use for article bodies, long descriptions, and page content.

## Options

Key | Description
--- | ---
<code class="text-[var(--prism-keyword)]">format</code> | Values: `markdown`, `html`.
<code class="text-[var(--prism-keyword)]">switcher</code> | Show or hide the `Editor` / `Source` mode switch. Defaults to `true`.
<code class="text-[var(--prism-keyword)]">media</code> | Media source for inserted images (e.g. `"content_images"`). Set to `false` to disable media.
<code class="text-[var(--prism-keyword)]">path</code> | Default image folder (e.g. `"blog"`).
<code class="text-[var(--prism-keyword)]">extensions</code> | Allowed image extensions (e.g. `["png", "webp"]`).
<code class="text-[var(--prism-keyword)]">categories</code> | Allowed image categories. Values: `image`.
<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

### Markdown with media

```yaml
- name: body
  label: Body
  type: rich-text
  options:
    media: content_images
    path: public/images/blog
    rename: true
    switcher: true
```

### HTML output

```yaml
- name: content
  label: Content
  type: rich-text
  options:
    format: html
```

### Hide the mode switch

```yaml
- name: excerpt
  label: Excerpt
  type: rich-text
  options:
    switcher: false
```

### Disable media

```yaml
- name: notes
  label: Notes
  type: rich-text
  options:
    media: false
```