Skip to main content
Version: 2026.2

Configuration

The TinyMCE editor supports configuration through Pimcore editables (per-field) and Symfony configuration (global defaults).

Default Toolbar​

When no custom toolbar is configured, the editor uses this default:

Toolbar 1:

undo redo | blocks | bold italic | alignleft aligncenter alignright alignjustify | link hr charmap

Toolbar 2:

table | bullist numlist outdent indent | removeformat | code | searchreplace visualblocks help

In the shared translations context, both toolbars display as separate rows. In all other contexts (documents, data objects), they merge into a single row:

Default TinyMCE toolbar on a WYSIWYG field, with both default rows merged into oneDefault TinyMCE toolbar on a WYSIWYG field, with both default rows merged into oneDefault TinyMCE toolbar on a WYSIWYG field, with both default rows merged into one

Default Behavior​

convert_unsafe_embeds is set to true by default. Unsafe elements like <embed> or <object> are converted to more restrictive alternatives. See the TinyMCE documentation for details.

Toolbar Configuration in Twig​

Use the pimcore_wysiwyg editable in document templates to render a WYSIWYG field. It accepts TinyMCE configuration options directly. Use toolbar1 and toolbar2 to define toolbar rows.

Basic example​

{{ pimcore_wysiwyg("content", {
toolbar2: 'forecolor | h1 | h2'
})
}}

This adds a second toolbar row with the color picker and heading buttons, below the merged default row:

WYSIWYG editable with a second toolbar row holding the color picker, H1 and H2WYSIWYG editable with a second toolbar row holding the color picker, H1 and H2WYSIWYG editable with a second toolbar row holding the color picker, H1 and H2

Restricting the toolbar​

Pass only the controls you need via toolbar1. Controls not listed are excluded.

{{ pimcore_wysiwyg("content", {
toolbar1: 'bold italic | bullist numlist'
})
}}

For the full list of available toolbar buttons, see the TinyMCE toolbar documentation.

Global Configuration​

Global WYSIWYG defaults live under the pimcore_studio_ui extension provided by the Studio UI bundle, not under pimcore_tinymce. The TinyMCE bundle's own config key (pimcore_tinymce) is only used for cloud configuration.

These defaults apply to all WYSIWYG fields unless overridden per-field in Twig.

# config/packages/pimcore_studio_ui.yaml
pimcore_studio_ui:
wysiwyg:
defaultEditorConfig:
dataObject:
toolbar1: 'undo redo | bold italic'
menubar: true
document:
toolbar1: 'undo redo | bold italic'
menubar: true
  • dataObject - applies to WYSIWYG fields in data object classes
  • document - applies to WYSIWYG editables in documents
  • Per-field configuration in Twig overrides these global defaults
  • Shared translations use the TinyMCE editor but do not have a separate global config key
note

The configuration structure under dataObject and document follows the TinyMCE configuration format.

Cloud Configuration​

Load TinyMCE from the Tiny Cloud CDN instead of the bundled version. See Cloud Configuration for details.