Options Reference | SunEditor

Editor Options

Plugins & Buttons(4)

plugins

| { [x: string]: any; } | Array<{ [x: string]: any; }>

Plugin configuration. Pass an array of plugin classes or an object keyed by plugin name.

Example

import plugins, { image, link, table } from 'suneditor/src/plugins';
{ plugins: plugins,
plugins: [image, link, table],
plugins: { image, link, table }
}

buttonList

SunEditor.UI.ButtonList

List of toolbar buttons, grouped by sub-arrays.

•The default follows DEFAULTS.BUTTON_LIST

DefaultCONSTANTS.BUTTON_LIST

buttons

List of currently used toolbar buttons

buttons_sub

List of currently used sub-toolbar buttons

Modes & Themes(8)

v2Migration

boolean

Enables migration mode for SunEditor v2.

Defaultfalse

mode

Toolbar mode: classic, inline, balloon, balloon-always. Append :bottom to place toolbar at the bottom (e.g. classic:bottom, inline:bottom).

Default"classic"

type

string

Editor type. Use "document" for a document-style layout, with optional sub-types after :.

Default""

Example

// type
'document:header,page'

theme

string

Editor theme.

Default""

lang

{ [x: string]: string; }

Language configuration. default : EN

icons

{ [x: string]: string; }

Overrides the default icons.

textDirection

'ltr' | 'rtl'

Text direction: ltr or rtl.

Default"ltr"

reverseCommands

Merged reverse command pairs array.

•Includes default indent-outdent + user's reverseButtons.

Toolbar(9)

toolbar_width

string

Toolbar width.

Default"auto"

toolbar_container

HTMLElement | null

Container element for the toolbar.

toolbar_sticky

number

Enables sticky toolbar with optional offset.

Default0

toolbar_hide

boolean

Hides toolbar initially.

Defaultfalse

subToolbar

{ buttonList?: SunEditor.UI.ButtonList; mode?: 'balloon' | 'balloon-always'; width?: string; }

Sub-toolbar configuration. A secondary toolbar that appears on text selection.

Default{}

shortcutsHint

boolean

Displays shortcut hints in tooltips.

Defaulttrue

shortcutsDisable

boolean

Disables keyboard shortcuts.

Defaultfalse

shortcuts

{ [key: string]: Array<string> | undefined; }

Custom keyboard shortcuts.

•Keys starting with _ are user-defined custom shortcuts. Each value is an array of [keyCombo, hintLabel] pairs.

•Key combos use c (Ctrl/Cmd), s (Shift), and KeyEvent.code values joined by +.

•Use $~pluginName.method to call a specific plugin method.

Default{}

Example

{
shortcuts: {
bold: ['c+KeyB', 'B'],
_h1: ['c+s+Digit1+$~blockStyle.applyHeaderByShortcut', '']
}
}

toolbar_sub_width

Sub-toolbar width.

Filtering & Formatting(25)

strictMode

| true | { tagFilter: boolean; formatFilter: boolean; classFilter: boolean; textStyleTagFilter: boolean; attrFilter: boolean; styleFilter: boolean; }

Enables strict filtering of tags, attributes, and styles.

•Use true to enable all filters (default), or an object to control individual filters.

•Setting false is not supported; use the object form to disable specific filters instead.

•:filter description

•tagFilter: Filters disallowed HTML tags (elementWhitelist/elementBlacklist)

•formatFilter: Filters format elements (formatLine/formatBlock)

•classFilter: Filters disallowed CSS class names (allowedClassName)

•textStyleTagFilter: Filters text style tags (b, i, u, span, etc.)

•attrFilter: Filters disallowed HTML attributes (attributeWhitelist/attributeBlacklist)

•styleFilter: Filters disallowed inline styles (spanStyles/lineStyles/allUsedStyles)

Defaulttrue

Example

// disable only attribute and style filters
{
strictMode: {
tagFilter: true,
formatFilter: true,
classFilter: true,
textStyleTagFilter: true,
attrFilter: false,
styleFilter: false
}
}

scopeSelectionTags

Array<string>

Tags treated as whole units when selecting all content.

•The default follows DEFAULTS.SCOPE_SELECTION_TAGS

DefaultCONSTANTS.SCOPE_SELECTION_TAGS

elementWhitelist

string

Specifies HTML elements to additionally allow beyond the default allow list. Delimiter: "|".

•Added to the default list determined by PrivateBaseOptions.__defaultElementWhitelist.

Default""

Example

{ elementWhitelist: 'mark|details|summary' }

elementBlacklist

string

Specifies HTML elements that should not be used. Delimiter: "|".

•Tags specified here will eventually be removed, even if they are included in other whitelists.

Default""

Example

{ elementBlacklist: 'script|style|iframe' }

allowedEmptyTags

string

A list of tags that are allowed to be kept even if their values are empty.

•The default follows DEFAULTS.ALLOWED_EMPTY_NODE_LIST

•Concatenated with ALLOWED_EMPTY_NODE_LIST to form the final allowedEmptyTags list.

DefaultCONSTANTS.ALLOWED_EMPTY_NODE_LIST

allowedClassName

string

Allowed class names.

•Added the default value DEFAULTS.CLASS_NAME

Default""

attributeWhitelist

{ [key: string]: string | undefined; }

Specifies additional attributes to allow for each tag. "*" applies to all tags.

•Rules specified here will be merged into PrivateBaseOptions.__defaultAttributeWhitelist.

Defaultnull

Example

{
attributeWhitelist: {
a: 'href|target',
img: 'src|alt',
'*': 'id|data-*'
}
}

attributeBlacklist

{ [key: string]: string | undefined; }

Specifies attributes to disallow by tag. "*" applies to all tags.

•Attributes specified here will eventually be removed even if they are allowed by other settings.

•A list of required elements, DEFAULTS.REQUIRED_FORMAT_LINE, is always included.

Defaultnull

Example

{ attributeBlacklist: { '*': 'onclick|onerror' } }

textStyleTags

string

Additional text style tags.

•The default follows PrivateBaseOptions.__textStyleTags

Default__textStyleTags

convertTextTags

{ [x: string]: string; }

Maps text styles to specific HTML tags.

Default{bold: "strong", underline: "u", italic: "em", strike: "del", subscript: "sub", superscript: "sup"}

Example

{
convertTextTags: {
bold: 'b',
italic: 'i',
underline: 'u',
strike: 's'
}
}

allUsedStyles

string

Specifies additional styles to the list of allowed styles. Delimiter: "|".

Example

{ allUsedStyles: 'color|background-color|text-shadow' }

tagStyles

{ [x: string]: string; }

Specifies allowed styles for HTML tags. Key is tag name(s), value is pipe-delimited allowed styles.

Default{}

Example

{
tagStyles: {
'table|td': 'border|color|background-color',
hr: 'border-top'
}
}

spanStyles

string

Specifies allowed styles for the span tag.

•The default follows DEFAULTS.SPAN_STYLES

DefaultCONSTANTS.SPAN_STYLES

lineStyles

string

Specifies allowed styles for the line element (p..).

•The default follows DEFAULTS.LINE_STYLES

DefaultCONSTANTS.LINE_STYLES

fontSizeUnits

Array<string>

Allowed font size units.

•The default follows DEFAULTS.SIZE_UNITS

DefaultCONSTANTS.SIZE_UNITS

retainStyleMode

'repeat' | 'always' | 'none'

Determines how inline elements (e.g. <span>, <strong>) are handled when deleting text.

•repeat: Styles are retained unless backspace is repeatedly pressed.

•Continuous pressing will eventually remove the styles.

•none: Styles are not retained. Inline elements are immediately removed with the text.

•always: Styles persist indefinitely unless explicitly removed.

•Even if all text inside an inline element is deleted, the element itself remains.

Default"repeat"

defaultLine

string

Default line element when inserting new lines.

Default"p"

defaultLineBreakFormat

'line' | 'br'

Specifies the default line break format.

•[Recommended] line : Line break is divided into general tags.

•[Not recommended] br : Line breaks are treated as <br> on the same line. (like shift+enter)

•Line breaks are handled as <br> within line.

•You can create a new line by entering a line break twice in a row.

•Formats that include line, such as Quote, still operate on a line basis.

•suneditor processes work in line units.

•When set to br, performance may decrease when editing a lot of data.

Default"line"

lineAttrReset

string

Line properties that should be reset when changing lines. Delimiter: "|".

Default""

Example

{ lineAttrReset: 'id|name' }

formatLine

string

Additionally allowed line elements beyond the default. Delimiter: "|".

•Concatenated with PrivateBaseOptions.__defaultFormatLine to form the final line list.

•line element also contains brLine element.

Default__defaultFormatLine

Example

{ formatLine: 'ARTICLE|SECTION' }

formatBrLine

string

Additionally allowed brLine elements beyond the default.

•Concatenated with PrivateBaseOptions.__defaultFormatBrLine to form the final brLine list.

•brLine elements are included in the line element.

•brLine elements' line break is BR tag.

•※ Entering the Enter key on the last line ends brLine and appends line.

Default__defaultFormatBrLine

Example

{ formatBrLine: 'CODE' }

formatClosureBrLine

string

Additionally allowed closureBrLine elements beyond the default.

•Concatenated with PrivateBaseOptions.__defaultFormatClosureBrLine for the final closureBrLine list.

•closureBrLine elements are included in the brLine.

•closureBrLine elements' line break is BR tag.

•※ You cannot exit this format with the Enter key or Backspace key.

•※ Use it only in special cases. ([ex] format of table cells)

Default__defaultFormatClosureBrLine

formatBlock

string

Additionally allowed block elements beyond the default.

•Concatenated with PrivateBaseOptions.__defaultFormatBlock to form the final block list.

•block wraps the line and component.

Default__defaultFormatBlock

formatClosureBlock

string

Additionally allowed closureBlock elements beyond the default.

•Concatenated with PrivateBaseOptions.__defaultFormatClosureBlock for the final closureBlock list.

•closureBlock elements are included in the block.

•closureBlock element wraps the line and component.

•※ You cannot exit this format with the Enter key or Backspace key.

•※ Use it only in special cases. (e.g. format of table cells)

Default__defaultFormatClosureBlock

allowedExtraTags

{ [x: string]: boolean; }

Specifies extra allowed or disallowed tags. true to allow, false to disallow.

•The default follows DEFAULTS.EXTRA_TAG_MAP

DefaultCONSTANTS.EXTRA_TAG_MAP

Example

{
allowedExtraTags: {
script: false,
style: false,
mark: true
}
}

UI & Interaction(14)

closeModalOutsideClick

boolean

Closes modals when clicking outside.

Defaultfalse

syncTabIndent

boolean

Synchronizes tab indent with spaces.

Defaulttrue

tabDisable

boolean

Disables tab key input.

Defaultfalse

copyFormatKeepOn

boolean

Keeps the format of the copied content.

Defaultfalse

autoLinkify

boolean

Automatically converts URLs into hyperlinks. (Link plugin required)

•Default: Boolean(plugins.link) — determined by whether the link plugin is enabled.

historyStackDelayTime

number

Delay time for history stack updates (ms).

Default400

printClass

string

Class name for printing.

Default""

fullScreenOffset

number

Offset applied when entering fullscreen mode.

Default0

previewTemplate

string | null

Custom HTML template for preview mode. Use {{ contents }} as a placeholder for editor content.

Defaultnull

printTemplate

string | null

Custom HTML template for print mode. Use {{ contents }} as a placeholder for editor content.

Defaultnull

Example

{ previewTemplate: '<div class="my-preview"><h1>Preview</h1>{{ contents }}</div>' }

componentInsertBehavior

SunEditor.ComponentInsertType

Enables automatic selection of inserted components.

•For inline components: places cursor near the component, or selects if no nearby range.

•For block components: executes behavior based on selectMode:

•auto: Move cursor to the next line if possible, otherwise select the component.

•select: Always select the inserted component.

•line: Move cursor to the next line if possible, or create a new line and move there.

•none: Do nothing.

Default"auto"

defaultUrlProtocol

string | null

Default URL protocol for links.

Defaultnull

toastMessageTime

any

Duration for displaying toast messages (ms).

Default{copy: 1500}

freeCodeViewMode

boolean

Enables free code view mode.

Defaultfalse

External Libraries(4)

codeMirrorEditor

CodeMirror editor instance (frame-level). Set by _checkCodeMirror after initialization.

externalLibs

{ [x: string]: any; }

External libraries like CodeMirror, KaTeX, or MathJax.

•See {@link https://github.com/ARA-developer/suneditor/blob/develop/guide/external-libraries.md External Libraries Guide}

Example

{
externalLibs: {
katex: window.katex,
codeMirror: { src: CodeMirror }
}
}

codeMirror

CodeMirror configuration object from externalLibs.codeMirror.

hasCodeMirror

Uses CodeMirror for code view.

Events & Shortcuts(1)

events

SunEditor.Event.Handlers

User event handlers configuration.

Example

{
events: {
onChange: (content) => console.log(content),
onImageUploadBefore: (files, info) => true
}
}

Other(8)

top

Styles applied to the top container (e.g. width, z-index, etc).

frame

Styles applied to the iframe container (e.g. height, min-height).

editor

Styles applied to the editable content area.

statusbar_container

HTMLElement | null

Container element for the status bar.

historyStackSize

number

Maximum number of history entries per root frame. Oldest entries are discarded when exceeded.

Default100

finder_panel

boolean

Shows the built-in Find/Replace panel UI.

•The finder is always created internally; this option controls whether the panel is visible to users (Ctrl+F / Ctrl+H).

Defaulttrue

finder_liveSearch

boolean

Searches instantly as you type (debounced). When false, search runs only on Enter.

Defaulttrue

codeBlock_langs

List of selectable programming languages for code blocks.

•Defaults to 21 common languages

•[javascript, typescript, html, css, json, python, java, c, cpp, csharp, go, rust, ruby, php, swift, kotlin, sql, bash, markdown, xml, yaml].

•Set to empty array [] to disable language selection UI entirely.

Frame Options

(20)

These options can be configured individually per root in multi-root mode.

Content(3)

value

string

Initial value for the editor.

Default""

placeholder

string

Placeholder text.

Default""

editableFrameAttributes

{ [x: string]: string; }

Attributes for the editable frame[.sun-editor-editable].

Default{spellcheck: "false"}

Example

{ editableFrameAttributes: { spellcheck: 'true', autocomplete: 'on' } }

Layout & Sizing(7)

width

string | number

Width for the editor.

Default"100%"

minWidth

string | number

Min width for the editor.

Default""

maxWidth

string | number

Max width for the editor.

Default""

height

string | number

Height for the editor.

Default"auto"

minHeight

string | number

Min height for the editor.

Default""

maxHeight

string | number

Max height for the editor.

Default""

editorStyle

string

Style string of the top frame of the editor.

Default""

Example

{ editorStyle: 'border: 1px solid #ccc; border-radius: 4px;' }

Iframe(3)

iframe

boolean

Content will be placed in an iframe and isolated from the rest of the page.

Defaultfalse

iframe_fullPage

boolean

Allows the usage of HTML, HEAD, BODY tags and DOCTYPE declaration on the iframe.

Defaultfalse

iframe_attributes

{ [x: string]: string; }

Attributes of the iframe.

Default{}

Example

{ iframe_attributes: { 'allow-scripts': 'true', sandbox: 'allow-same-origin' } }

Statusbar & Counter(7)

statusbar

boolean

Enables the status bar.

Defaulttrue

statusbar_showPathLabel

boolean

Displays the current node structure in the status bar.

Defaulttrue

statusbar_resizeEnable

boolean

Enables resize function of the bottom status bar.

Defaulttrue

charCounter

boolean

Shows the number of characters in the editor.

•If the maxCharCount option has a value, it becomes true.

Defaultfalse

charCounter_max

number | null

The maximum number of characters allowed to be inserted into the editor.

Defaultnull

charCounter_label

string | null

Text to be displayed in the charCounter area of the bottom bar.

Defaultnull

Example

{ charCounter_label: 'Characters :' }

charCounter_type

'char' | 'byte' | 'byte-html'

Defines the calculation method of the charCounter option.

•char: Characters length.

•byte: Binary data size of characters.

•byte-html: Binary data size of the full HTML string.

Default"char"

Plugin Options

164

align

{(1)

items

Align items

}

audio

{(12)

defaultWidth

The default width of the AUDIO tag.

defaultHeight

The default height of the AUDIO tag.

createFileInput

Whether to create a file input element.

createUrlInput

Whether to create a URL input element.

•Defaults to true. Always true when createFileInput is false.

uploadUrl

The URL to which files will be uploaded.

uploadHeaders

Headers to include in the file upload request.

uploadSizeLimit

The total upload size limit in bytes.

uploadSingleSizeLimit

The single file size limit in bytes.

allowMultiple

Whether to allow multiple file uploads.

acceptedFormats

Accepted file formats (default is "audio/*").

audioTagAttributes

Additional attributes to set on the AUDIO tag.

insertBehavior

Component insertion behavior for selection and cursor placement.

•[default: options.get('componentInsertBehavior')]

•auto: Move cursor to the next line if possible, otherwise select the component.

•select: Always select the inserted component.

•line: Move cursor to the next line if possible, or create a new line and move there.

•none: Do nothing.

}

audioGallery

{(4)

data

Direct data without server calls

url

Server request URL

headers

Server request headers

thumbnail

Default thumbnail

}

backgroundColor

{(3)

items

Color list.

splitNum

Number of colors per line

disableHEXInput

Disable HEX input

}

blockStyle

{(1)

items

Format list.

•command — "line": single line block, "br-line": br-separated block, "block": container block.

}

drawing

{(11)

outputFormat

The output format of the drawing. Options: "dataurl", "svg".

useFormatType

Whether to enable format type selection (block vs inline).

defaultFormatType

The default format type, either "block" or "inline".

keepFormatType

Whether to maintain the chosen format type after drawing.

lineWidth

The width of the drawing line.

lineReconnect

Whether to reconnect lines when drawing.

lineCap

The style of the line cap ("butt", "round", or "square").

lineColor

The color of the drawing line.

canResize

Whether the modal form can be resized.

maintainRatio

Whether to maintain the aspect ratio when resizing.

formSize

The size configuration for the drawing modal form.

}

embed

{(16)

canResize

Whether the embed element can be resized.

showHeightInput

Whether to display the height input field.

defaultWidth

The default width of the embed element (numeric value or with unit).

defaultHeight

The default height of the embed element (numeric value or with unit).

percentageOnlySize

Whether to allow only percentage-based sizing.

uploadUrl

The URL for file uploads.

uploadHeaders

Headers to include in file upload requests.

uploadSizeLimit

The total file upload size limit in bytes.

uploadSingleSizeLimit

The single file upload size limit in bytes.

iframeTagAttributes

Additional attributes to set on the IFRAME tag.

query_youtube

YouTube query parameter appended to the embed URL.

query_vimeo

Vimeo query parameter appended to the embed URL.

urlPatterns

Additional URL patterns to recognize as embeddable content.

embedQuery

Custom embed service definitions.

controls

Figure controls.

insertBehavior

Component insertion behavior for selection and cursor placement.

•[default: options.get('componentInsertBehavior')]

•auto: Move cursor to the next line if possible, otherwise select the component.

•select: Always select the inserted component.

•line: Move cursor to the next line if possible, or create a new line and move there.

•none: Do nothing.

}

exportPDF

{(2)

apiUrl

Server request URL for PDF generation

fileName

Name of the generated PDF file

}

fileBrowser

{(5)

data

Direct data without server calls (bypasses URL fetch).

url

Server request URL

headers

Server request headers

thumbnail

Default thumbnail URL or a function that returns a thumbnail URL per item.

props

Additional tag names

}

fileGallery

{(4)

data

Direct data without server calls

url

Server request URL

headers

Server request headers

thumbnail

Default thumbnail

}

fileUpload

{(9)

uploadUrl

Server request URL for file upload

uploadHeaders

Server request headers

uploadSizeLimit

Total upload size limit in bytes

uploadSingleSizeLimit

Single file size limit in bytes

allowMultiple

Allow multiple file uploads

acceptedFormats

Accepted file formats.

as

Specify the default form of the file component as box or link

controls

Additional controls to be added to the figure

insertBehavior

Component insertion behavior for selection and cursor placement.

•[default: options.get('componentInsertBehavior')]

•auto: Move cursor to the next line if possible, otherwise select the component.

•select: Always select the inserted component.

•line: Move cursor to the next line if possible, or create a new line and move there.

•none: Do nothing.

}

font

{(1)

items

Font list

}

fontColor

{(3)

items

Color list.

splitNum

Number of colors per line

disableHEXInput

Disable HEX input

}

hR

{(1)

items

HR list

}

image

{(19)

canResize

Whether the image element can be resized.

showHeightInput

Whether to display the height input field.

defaultWidth

The default width of the image. If a number is provided, "px" will be appended.

defaultHeight

The default height of the image. If a number is provided, "px" will be appended.

percentageOnlySize

Whether to allow only percentage-based sizing.

createFileInput

Whether to create a file input element for image uploads.

createUrlInput

Whether to create a URL input element for image insertion.

•Defaults to true. Always true when createFileInput is false.

uploadUrl

The URL endpoint for image file uploads.

uploadHeaders

Additional headers to include in the file upload request.

uploadSizeLimit

The total upload size limit in bytes.

uploadSingleSizeLimit

The single file upload size limit in bytes.

allowMultiple

Whether multiple image uploads are allowed.

acceptedFormats

The accepted file formats for image uploads.

useFormatType

Whether to enable format type selection (block or inline).

defaultFormatType

The default image format type ("block" or "inline").

keepFormatType

Whether to retain the chosen format type after image insertion.

linkEnableFileUpload

Whether to enable file uploads for linked images.

controls

Figure controls.

insertBehavior

Component insertion behavior for selection and cursor placement.

•[default: options.get('componentInsertBehavior')]

•For inline components: places cursor near the component, or selects if no nearby range.

•For block components: executes behavior based on selectMode:

•auto: Move cursor to the next line if possible, otherwise select the component.

•select: Always select the inserted component.

•line: Move cursor to the next line if possible, or create a new line and move there.

•none: Do nothing.

}

imageGallery

{(3)

data

Direct data without server calls

url

Server request URL

headers

Server request headers

}

layout

{(1)

items

Layout list. Each item defines a named layout template with raw HTML.

}

lineHeight

{(1)

items

Line height list

}

link

{(12)

uploadUrl

The URL endpoint for file uploads.

uploadHeaders

Additional headers for file upload requests.

uploadSizeLimit

The total file upload size limit in bytes.

uploadSingleSizeLimit

The single file upload size limit in bytes.

acceptedFormats

Accepted file formats for link uploads.

title

Modal title display.

textToDisplay

Create Text to display input.

openNewWindow

Default checked value of the Open in new window checkbox.

noAutoPrefix

If true, disables the automatic prefixing of the host URL to the value of the link.

relList

Available rel attribute values shown as checkboxes in the link modal.

defaultRel

Default rel values auto-applied by condition.

enableFileUpload

If true, enables file upload.

}

math

{(5)

canResize

Whether the math modal can be resized.

autoHeight

Whether to automatically adjust the height of the modal.

fontSizeList

A list of font size options for the math expression size selector.

onPaste

A callback function to handle paste events in the math input area.

formSize

An object specifying the dimensions for the math modal.

}

mention

{(9)

triggerText

The character that triggers the mention list.

limitSize

The number of items to display in the mention list

searchStartLength

The number of characters to start searching for the mention list

delayTime

The time to wait before displaying the mention list

data

Static mention data (used instead of API).

apiUrl

The URL to call the mention list

apiHeaders

The headers to send with the API call

useCachingData

Whether to cache the mention list data

useCachingFieldData

Whether to cache the mention list data in the field

}

paragraphStyle

{(1)

items

Paragraph item list

}

table

{(4)

scrollType

Scroll type (x, y, xy)

captionPosition

Caption position (top, bottom)

cellControllerPosition

Cell controller position (cell, table)

colorList

HEX color list for the cell background color picker.

}

template

{(1)

items

Template list

}

textStyle

{(1)

items

Text style item list.

}

video

{(25)

canResize

Whether the video element can be resized.

showHeightInput

Whether to display the height input field.

defaultWidth

The default width of the video element. If a number is provided, "px" will be appended.

defaultHeight

The default height of the video element. If a number is provided, "px" will be appended.

percentageOnlySize

Whether to allow only percentage-based sizing.

createFileInput

Whether to create a file input element for video uploads.

createUrlInput

Whether to create a URL input element for video embedding.

•Defaults to true. Always true when createFileInput is false.

uploadUrl

The URL endpoint for video file uploads.

uploadHeaders

Additional headers to include in the video upload request.

uploadSizeLimit

The total upload size limit for videos in bytes.

uploadSingleSizeLimit

The single file upload size limit for videos in bytes.

allowMultiple

Whether multiple video uploads are allowed.

acceptedFormats

Accepted file formats for video uploads ("video/*").

defaultRatio

The default aspect ratio for the video (height/width, e.g. 16:9 → 9/16 = 0.5625).

showRatioOption

Whether to display the ratio option in the modal.

ratioOptions

Custom ratio options for video resizing (value = height/width).

videoTagAttributes

Additional attributes to set on the VIDEO tag.

iframeTagAttributes

Additional attributes to set on the IFRAME tag.

query_youtube

Additional query parameters for YouTube embedding.

query_vimeo

Additional query parameters for Vimeo embedding.

embedQuery

Custom embed service definitions (see EmbedPluginOptions.embedQuery).

urlPatterns

Additional URL patterns for video embedding.

extensions

Additional file extensions to be recognized for video uploads.

controls

Figure controls.

insertBehavior

Component insertion behavior for selection and cursor placement.

•[default: options.get('componentInsertBehavior')]

•auto: Move cursor to the next line if possible, otherwise select the component.

•select: Always select the inserted component.

•line: Move cursor to the next line if possible, or create a new line and move there.

•none: Do nothing.

}

videoGallery

{(4)

data

Direct data without server calls

url

Server request URL

headers

Server request headers

thumbnail

Default thumbnail

}