---
title: "Troubleshooting & Support"
manual: "RTE CKEditor Image"
version: "main"
permalink: "https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:troubleshooting-index@main"
source: "Troubleshooting/Index.rst"
rendered: "2026-10-01T01:27:51+00:00"
---

# Troubleshooting & Support {#troubleshooting-index}

Solutions to common issues, debugging techniques, and support resources.

**Table of Contents**

-   [Quick Fixes](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:quick-fixes@main)
-   [Debugging Techniques](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:debugging-techniques@main)
-   [Getting Help](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:getting-help@main)
-   [Troubleshooting Topics](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:troubleshooting-topics@main)
-   [Related Documentation](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:related-documentation@main)

## Quick Fixes {#quick-fixes}

### Most Common Issues {#most-common-issues}

#### 1\. Style Dropdown Disabled (v13.0.0+) {#1-style-dropdown-disabled-v13-0-0}

```javascript
// Ensure these dependencies are present:
static get requires() {
    return ['StyleUtils', 'GeneralHtmlSupport'];
}
```

> [!NOTE]
> **See also**
>
> [Issue: Style Drop-Down Not Working with Images](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:troubleshooting-style-dropdown@main)

#### 2\. Images Not Appearing in Frontend {#2-images-not-appearing-in-frontend}

-   Check TypoScript setup
-   Verify file permissions
-   Clear all caches

> [!NOTE]
> **See also**
>
> [Image Display Problems](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:troubleshooting-frontend-rendering@main)

#### 3\. File Browser Not Opening {#3-file-browser-not-opening}

-   Check backend user permissions
-   Verify TSConfig
-   Check file mount configuration

> [!NOTE]
> **See also**
>
> [Issue: File Browser Empty or Not Loading](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:troubleshooting-file-browser@main)

## Debugging Techniques {#debugging-techniques}

### Enable Debug Mode {#enable-debug-mode}

```php
$GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'] = '*';
$GLOBALS['TYPO3_CONF_VARS']['SYS']['displayErrors'] = 1;
```

### Browser Console {#browser-console}

-   Check for JavaScript errors
-   Monitor network requests
-   Inspect CKEditor plugin loading

### TYPO3 Logs {#typo3-logs}

-   Check `var/log/typo3_*.log`
-   Review deprecation log
-   Monitor PHP error log

### Database Queries {#database-queries}

-   Enable SQL debug mode
-   Check soft references
-   Verify file relations

## Getting Help {#getting-help}

### Self-Help Resources {#self-help-resources}

1.  Check this troubleshooting guide
1.  Review [Integration & Configuration](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:integration@main)
1.  Consult [Examples & Use Cases](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:examples-common-use-cases@main)
1.  Search [GitHub Issues](https://github.com/netresearch/t3x-rte_ckeditor_image/issues)

### Community Support {#community-support}

> [!TIP]
> Multiple community channels are available for support:

-   ****GitHub Discussions****

    [github.com/netresearch/t3x-rte_ckeditor_image/discussions](https://github.com/netresearch/t3x-rte_ckeditor_image/discussions)

-   ****TYPO3 Slack****

    [#ext-rte_ckeditor_image channel](https://typo3.slack.com/archives/ext-rte_ckeditor_image)

-   ****TYPO3 Forum****

    [typo3.org/community/meet](https://typo3.org/community/meet/)

### Reporting Bugs {#reporting-bugs}

> [!WARNING]
> Before reporting, please:
>
> 1.  Check if issue already exists
> 1.  Verify you're using latest version
> 1.  Test with minimal configuration
> 1.  Collect debugging information

**Report bugs:** [github.com/netresearch/t3x-rte_ckeditor_image/issues](https://github.com/netresearch/t3x-rte_ckeditor_image/issues)

Include:

-   TYPO3 version
-   PHP version
-   Extension version
-   Steps to reproduce
-   Error messages
-   Browser console output

## Troubleshooting Topics {#troubleshooting-topics}

**📦 Installation Issues**

Extension installation problems, dependency conflicts, cache issues, and permission problems

[Read more](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:troubleshooting-installation-issues@main)

**✏️ Editor Issues**

Image button problems, style dropdown issues, file browser problems, CKEditor errors, and known limitations

[Read more](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:troubleshooting-editor-issues@main)

**🖥️ Frontend Issues**

Image display problems, broken links, dimension issues, and rendering problems

[Read more](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:troubleshooting-frontend-issues@main)

**⚡ Performance Issues**

Editor performance, frontend performance, image processing optimization, and database performance

[Read more](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:troubleshooting-performance-issues@main)

**🔍 Image Reference Validation**

Detect and fix stale image references, processed URLs, orphaned file UIDs, and broken src attributes

[Read more](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:troubleshooting-image-reference-validation@main)

## Related Documentation {#related-documentation}

**⚙️ Configuration**

Correct configuration and setup guide

[Read more](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:integration@main)

**📚 Examples**

Working implementations and use cases

[Read more](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:examples-common-use-cases@main)

**🏗️ Architecture**

System design and component interaction

[Read more](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:architecture-overview@main)

**🔌 API Reference**

Technical API documentation

[Read more](https://docs.typo3.org/permalink/netresearch/rte-ckeditor-image:api-index@main)