---
title: "RTE Setup"
manual: "RTE CKEditor Image"
version: "main"
permalink: "https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:integration-configuration-rte-setup@main"
source: "Integration/RTE-Setup.rst"
rendered: "2026-10-01T01:27:51+00:00"
---

# RTE Setup {#integration-configuration-rte-setup}

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

> [!IMPORTANT]
> **Automatic Backend Configuration**
>
> The extension automatically configures the backend RTE after installation:
>
> ```bash
> composer require netresearch/rte-ckeditor-image
> ```
>
> The `insertimage` button is automatically available in all RTEs. **No RTE configuration needed!**
>
> > [!NOTE]
> > **Frontend rendering requires TypoScript inclusion.** See [Frontend Rendering](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:integration-configuration-frontend-rendering@main).
>
> This guide is for **advanced users** who need custom RTE presets or want to override the defaults.

**Table of Contents**

-   [Automatic Configuration (Default)](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:automatic-configuration-default@main)
-   [Custom RTE Configuration](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:custom-rte-configuration@main)
-   [Related Documentation](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:related-documentation@main)

## Automatic Configuration (Default) {#automatic-configuration-default}

The extension automatically provides for the **backend**:

-   **Preset**: `rteWithImages` registered and enabled globally
-   **Toolbar**: `insertimage` button included in default toolbar
-   **Configuration**: `Configuration/RTE/Default.yaml` with full toolbar

> [!NOTE]
> **Frontend rendering** requires manual TypoScript inclusion.
> See [Frontend Rendering](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:integration-configuration-frontend-rendering@main).

## Custom RTE Configuration {#custom-rte-configuration}

### Creating Custom Presets {#integration-configuration-basic}

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

**EXT:my_ext/Configuration/RTE/Custom.yaml**

```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
```

#### Register Custom Preset {#register-custom-preset}

**EXT:my_ext/ext_localconf.php**

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

#### Enable Custom Preset {#enable-custom-preset}

**Page TSConfig**

```typoscript
RTE.default.preset = custom
```

### Advanced RTE Configuration {#advanced-rte-configuration}

#### Custom Allowed Extensions {#custom-allowed-extensions}

-   **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:**

    ```yaml
    editor:
      externalPlugins:
        typo3image:
          route: "rteckeditorimage_wizard_select_image"
          allowedExtensions: "jpg,jpeg,png,gif,webp"
    ```

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

#### Multiple RTE Presets {#multiple-rte-presets}

Different configurations for different content types:

**EXT:my_ext/Configuration/RTE/Simple.yaml**

```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
```

**Different presets for different fields**

```typoscript
# Different presets for different fields
RTE.default.preset = default
RTE.config.tt_content.bodytext.preset = full
RTE.config.tt_content.header.preset = simple
```

## Related Documentation {#related-documentation}

### Configuration Topics {#configuration-topics}

-   [Page TSConfig Setup](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:integration-configuration-tsconfig@main) \- Page TSConfig settings and upload configuration
-   [Frontend Rendering](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:integration-configuration-frontend-rendering@main) \- TypoScript and frontend rendering setup
-   [Advanced Configuration](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:integration-configuration-advanced@main) \- Advanced configuration, styles, and best practices

### General Documentation {#general-documentation}

-   [Integration & Configuration](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:integration@main) \- Main configuration guide overview
-   [Quick Start](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:quick-start@main) \- Quick start guide
-   [Troubleshooting & Support](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:troubleshooting-index@main) \- Troubleshooting guide