# MediaStyleDropdownDefinition

interface

The definition of a split-button dropdown that groups several media style buttons.

Integrators can declare custom dropdowns inline in [`config.mediaEmbed.toolbar`](module_media-embed_mediaembedconfig-MediaEmbedConfig.md#member-toolbar) alongside button-name strings; `defaultItem` is the discriminator that distinguishes a split-button media style dropdown from a generic toolbar grouping.

```typescript
mediaEmbed: {
	toolbar: [
		'mediaEmbed:alignCenter',
		{
			name: 'mediaEmbed:myAlignments',
			title: 'Alignment',
			items: [ 'mediaEmbed:alignBlockLeft', 'mediaEmbed:alignBlockRight' ],
			defaultItem: 'mediaEmbed:alignBlockLeft'
		}
	]
}
```

All names (`name`, `items[]`, `defaultItem`) use the full prefixed component-factory form. Items referencing styles that are not in the resolved [`config.mediaEmbed.styles`](module_media-embed_mediaembedconfig-MediaEmbedConfig.md#member-styles) list are filtered out at registration time. A dropdown that ends up with fewer than two items is skipped. If the configured `defaultItem` was filtered out, the first surviving item is used.

[See source](https://github.com/ckeditor/ckeditor5/blob/master/packages/ckeditor5-media-embed/src/mediaembedconfig.ts#L508)

<a id="properties">

## Properties

<a id="member-defaultItem">

### `defaultItem: string`

The default child whose icon and label the split button mirrors when no child is active. Must be one of the `items`.

[See source](https://github.com/ckeditor/ckeditor5/blob/master/packages/ckeditor5-media-embed/src/mediaembedconfig.ts#L531)

<a id="member-items">

### `items: Array<string>`

Prefixed style names included in the dropdown (for example, `[ 'mediaEmbed:alignBlockLeft', 'mediaEmbed:alignBlockRight' ]`).

[See source](https://github.com/ckeditor/ckeditor5/blob/master/packages/ckeditor5-media-embed/src/mediaembedconfig.ts#L525)

<a id="member-name">

### `name: string`

The dropdown name. Registered as-is in the UI component factory, so it must use the `mediaEmbed:` prefix (for example, `'mediaEmbed:myAlignments'`).

[See source](https://github.com/ckeditor/ckeditor5/blob/master/packages/ckeditor5-media-embed/src/mediaembedconfig.ts#L514)

<a id="member-title">

### `title: string`

The dropdown title, used both for the split-button label and the dropdown arrow tooltip.

[See source](https://github.com/ckeditor/ckeditor5/blob/master/packages/ckeditor5-media-embed/src/mediaembedconfig.ts#L519)

---

Full index of the CKEditor 5 API reference: [llms.txt](llms.txt)