RTE CKEditor Image 

Extension key

rte_ckeditor_image

Package name

netresearch/rte-ckeditor-image

Version

13.0.x

Language

en

Author

Netresearch DTT GmbH

License

This document is published under the Creative Commons BY 4.0 license.

Rendered

Fri, 07 Nov 2025 12:22:28 +0000

Image support in CKEditor for the TYPO3 ecosystem.

📘 Introduction 

The RTE CKEditor Image extension provides comprehensive image handling capabilities for TYPO3's CKEditor Rich Text Editor with full FAL integration.

Read more

⚡ Quick Start 

Get up and running quickly with installation instructions and basic configuration examples.

Read more

⚙️ Configuration 

Learn how to configure custom image styles, processing options, and frontend rendering setup.

Read more

🏗️ Architecture 

Understand the extension's architecture, design patterns, and how components interact.

Read more

🔧 Developer API 

Explore the PHP and JavaScript APIs for extending and customizing the extension.

Read more

🐛 Troubleshooting 

Find solutions to common issues and learn debugging techniques.

Read more

Introduction 

The RTE CKEditor Image extension provides comprehensive image handling capabilities for TYPO3's CKEditor Rich Text Editor. This extension enables editors to insert, configure, and style images directly within the CKEditor interface, with full integration into TYPO3's File Abstraction Layer (FAL).

Key Features 

  • Native CKEditor 5 plugin integration
  • Full TYPO3 FAL support with file browser integration
  • Advanced image processing (magic images, cropping, scaling)
  • Custom image style configuration
  • Responsive image support
  • Lazy loading and performance optimization
  • Event-driven architecture for extensibility

Visual Preview 

RTE CKEditor Image extension demo

Image insertion and configuration in CKEditor with TYPO3 file browser integration

Version Information 

Version

13.0.x for TYPO3 13.4+

License

AGPL-3.0-or-later

Repository

github.com/netresearch/t3x-rte_ckeditor_image

Requirements 

System Requirements 

  • TYPO3: 13.4 or later
  • PHP: 8.2, 8.3, or 8.4
  • Extensions: cms-rte-ckeditor (included in TYPO3 core)

Critical Dependencies 

New in version 13.0.0

The CKEditor plugin now requires StyleUtils and GeneralHtmlSupport dependencies for style functionality. Previous versions did not have this requirement.

The CKEditor plugin requires these dependencies for style functionality:

static get requires() {
    return ['StyleUtils', 'GeneralHtmlSupport'];
}
Copied!

Quick Start 

Installation 

Install via Composer:

composer require netresearch/rte-ckeditor-image
Copied!

That's it! The extension works completely out-of-the-box with zero configuration:

  • ✅ Backend RTE: Automatically registers the rteWithImages preset and configures the toolbar with insertimage button for all sites
  • ✅ Frontend Rendering: Automatically loads TypoScript for proper image rendering via lib.parseFunc_RTE
  • ✅ No Manual Steps: No template inclusion, no TSConfig setup, no YAML configuration required
Image button in CKEditor toolbar

The insertimage button provides full image management capabilities with TYPO3 file browser integration

Custom Configuration (Optional) 

If you need to customize the RTE configuration or create your own preset, see the RTE Setup Guide for detailed instructions.

The extension provides a default preset that you can extend or override as needed.

Quick Navigation by Role 

Role Start Here Then Read Advanced
Integrator Configuration Guide Examples Troubleshooting
PHP Dev Architecture API Reference Data Handling
JS Dev CKEditor Plugin Style Integration Conversions
Contributor Architecture API Documentation Examples

Documentation Use Cases 

For Integrators 

For Developers 

PHP Backend Development 

JavaScript/CKEditor Development 

For Troubleshooters 

Support & Contributing 

Get Help 

Contribute 

License 

This extension is licensed under AGPL-3.0-or-later.

Credits 

Development & Maintenance 

Community Contributors 

See GitHub Contributors

Additional Resources