> ## Documentation Index
> Fetch the complete documentation index at: https://buttercms.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# HTML field

> The ButterCMS HTML field accepts raw HTML snippets, outputs a string via the API, and bypasses editor formatting controls — ideal for custom embeds.

The **HTML** field is a raw HTML input field that provides a multi-line text input for short snippets of HTML.

<Warning>
  Use HTML fields sparingly, as they bypass editor controls and can introduce inconsistent formatting or security concerns.
</Warning>

## HTML field at a glance

### Input and output

<CardGroup cols={2}>
  <Card title="Input type" icon="arrow-right-to-bracket">
    Multiline code textarea
  </Card>

  <Card title="API output" icon="arrow-right-from-bracket">
    `string` (HTML)
  </Card>
</CardGroup>

### API response example

```json theme={null}
"widget_snippet": "<Tag>Here is our widget;</Tag>"
```

### Field configuration options

| `Option Name`            | `Type`  | `Function`                                   |
| ------------------------ | ------- | -------------------------------------------- |
| Required?                | boolean | Make field required to save page             |
| Help text                | string  | Add help text to describe usage to your team |
| Exclude from translation | boolean | Exclude the field from translation function  |