Skip to main content
Version: 2026.1

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.

TinyMCE toolbar in edit modeTinyMCE toolbar in edit modeTinyMCE toolbar in edit mode

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 color picker and heading buttons.

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.