CKEditor Ecosystem Documentation
Search
Contribute to this guideReport an issue
Home/CKEditor 4/Guides

Issues Tracker Site

CKEditor 4 issues are handled through the GitHub issues page since the CKEditor 4.7 release (May 25th, 2017). The former tracking system is still available in the read-only mode and all past issues are still available publicly.

The issues page is used daily by the CKEditor 4 core team to organize and distribute the development workflow. It is also the right place to report issues.

Before you attempt to report an issue, please make sure you read this page and thus help us optimize the management of issues.

# Required Information

Please provide the following when reporting new issues. The more information you provide, the quicker the problem may be solved:

  • Descriptive summary – A “right to the point” phrase that best summarizes the issue that you are having.
  • Steps to reproduce – This is the most important thing. We are not able to fix an issue if we cannot see it with our own eyes. A numbered list of actions to reproduce the issue is invaluable.
  • Browser name and OS – Your computer configuration, OS, browser name and version.
  • Editor configuration – Your editor version, integration method, editor build (you can attach your build-config.js file).
  • Screenshot – For interface-related issues an image speaks more than thousands of words.
  • Sample data – For content-related issues please attach a sample file from which we can get the text for testing.
  • Test case file – If possible, attach a test case file showing the issue. This is the best way to show us the problem and make it quicker to solve.

# Important

When filing an issue, please bear these important things in mind:

  • Submit separate reports for each issue. Do not include more than one issue in the same report.
  • Make sure you are using the latest CKEditor 4 version. Maybe your issue has already been fixed.
  • Follow the instructions in the issue template when reporting an issue.

# Reporting an Issue

Before clicking the following link, make sure you have read the instructions above!

Only registered GitHub users may create issues. If you are not registered, take a minute to create a GitHub account.

Once you log in, you will be ready to report a CKEditor issue.

# Labels

Each issue is categorised with labels. Refer to the GitHub label list for the label descriptions.