RTE Setup 

Complete guide for configuring the RTE (Rich Text Editor) with CKEditor image support.

Table of Contents

Automatic Configuration (Default) 

The extension automatically provides:

  • Preset: rteWithImages registered and enabled globally
  • Toolbar: insertimage button included in default toolbar
  • TypoScript: Frontend rendering hooks loaded automatically
  • Configuration: Configuration/RTE/Default.yaml with full toolbar

To use the automatic configuration, simply install the extension. No additional steps required.

Custom RTE Configuration 

Creating Custom Presets 

If you need to customize the toolbar or RTE behavior beyond the defaults, create a custom preset:

EXT:my_ext/Configuration/RTE/Custom.yaml 
imports:
  # Import default RTE config
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Default.yaml" }
  # Import image plugin configuration
  - { resource: "EXT:rte_ckeditor_image/Configuration/RTE/Plugin.yaml" }

editor:
  config:
    toolbar:
      items:
        - heading
        - '|'
        - insertimage
        - link
        - '|'
        - bold
        - italic
Copied!

Register Custom Preset 

EXT:my_ext/ext_localconf.php 
$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['custom']
    = 'EXT:my_ext/Configuration/RTE/Custom.yaml';
Copied!

Enable Custom Preset 

Page TSConfig 
RTE.default.preset = custom
Copied!

Advanced RTE Configuration 

Custom Allowed Extensions 

editor.externalPlugins.typo3image.allowedExtensions

editor.externalPlugins.typo3image.allowedExtensions
type

string

Default

Value from $GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext']

Comma-separated list of allowed image file extensions for the RTE image plugin.

Restricts which file types can be selected through the image browser.

Example:

editor:
  externalPlugins:
    typo3image:
      route: "rteckeditorimage_wizard_select_image"
      allowedExtensions: "jpg,jpeg,png,gif,webp"
Copied!

If not specified, falls back to the global TYPO3 configuration at $GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext']

Multiple RTE Presets 

Different configurations for different content types:

EXT:my_ext/Configuration/RTE/Simple.yaml 
imports:
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Minimal.yaml" }
  - { resource: "EXT:rte_ckeditor_image/Configuration/RTE/Plugin.yaml" }

editor:
  config:
    removePlugins: null
    toolbar:
      items:
        - insertimage
Copied!
Different presets for different fields 
# Different presets for different fields
RTE.default.preset = default
RTE.config.tt_content.bodytext.preset = full
RTE.config.tt_content.header.preset = simple
Copied!