### Headings Plugin

The Headings plugin adds a headings dropdown to the toolbar, letting users set heading levels (H1–H6) on text blocks.

> **Note:** The viewer renders headings natively without requiring a plugin — only the editor needs `pluginHeadings()`.

#### Editor

```tsx widget
import { fromPlainText, pluginHeadings, RicosEditor } from '@wix/ricos';
import React from 'react';

export default () => (
  // @essential-start
  <RicosEditor
    initialContent={fromPlainText('Type some text, then use the headings dropdown to set H1–H6.')}
    plugins={[pluginHeadings()]}
  />
  // @essential-end
);
```

##### <span style="font-weight: 700;" class="rounded-lg border-[1px] border-blue-300 font-mono border-none bg-blue-100 px-2 py-1 leading-[18px] tracking-[0.0175em] font-bold text-slate-900">HeadingsPluginEditorConfig</span>

Configuration for the Headings editor plugin. Pass to `pluginHeadings()`.

<code class="font-mono text-sm"><span class="text-blue-700">interface</span> HeadingsPluginEditorConfig</code>

<dl class="pl-4 border-l-2 border-slate-200">
<dt><code><strong>customHeadings</strong><span class="text-slate-400">?</span>: <a href="/api-docs/related-types#headingtype"><span class="font-mono">HeadingType</span></a>[]</code></dt>
<dd><p>Restricts which heading levels appear in the headings dropdown.</p>
<p>Default: <code>All headings are shown: `['H1', 'H2', 'H3', 'H4', 'H5', 'H6', 'P']`</code></p></dd>
<dt><code><strong>allowHeadingCustomization</strong><span class="text-slate-400">?</span>: boolean</code></dt>
<dd><p>When `true`, each heading entry in the dropdown shows a preview of its current font size and family (resolved from the theme), and clicking opens a sub-panel for in-content style customization.</p>
<p>Default: <code>false</code></p></dd>
</dl>
