CKEditor

• Fixed errors that could occur if the ckeditor_references table didn’t exist yet. (#584)

Elements that contain CKEditor fields must be resaved before the new deletion blocker can take effect. That can be done automatically by running the following command:

php craft resave/all --with-fields=myCkeditorField1,myCkeditorField2

• CKEditor now requires Craft CMS 5.10 or later.
• Added a deletion blocker for elements that are referenced within CKEditor fields. (#576)
• Fixed a bug where custom removePlugins config values weren’t being respected. (#578)
• Fixed a bug where consecutive “Open in new tab?” and “Download” advanced link options were being displayed side-by-side. (#575)
• Fixed a bug where CKEditor fields with list items could get marked as dirty before any changes were actually made to them. (#554)
• Fixed a bug where “Copy value from site…” actions weren’t working properly with CKEditor fields. (#580)

• Improved the styling of Link modals. (#562)
• Updated CKEditor 5 to 48.0.1. (#518)
• Fixed an error that could occur when selecting an entry in the Link modal. (#556)
• Fixed a bug where the current text selection wasn’t respected when adding a new link. (#558)
• Fixed a bug where nested entry cards weren’t showing validation errors. (#564)

• New links now default to the first available link type option (usually “Entry”). (#550)
• Fixed a bug where invisible characters were being stripped out of field contents. (#537)
• Fixed a bug where Link modals had empty Site menus when no element was selected. (#534, #545)
• Fixed a bug where downloadable links’ download attributes were getting set to the value "download". (#551)
• Fixed an error that occurred when copy/pasting a nested entry within a nested CKEditor field on a non-primary site. (#548)
• Fixed a bug where CKEditor fields with list items would get marked as dirty before any changes were actually made to them. (#554)

• Fixed an error that could occur when updating to CKEditor 5.

• It’s now possible to set the “Config Options” setting to a JS or JSON file within config/ckeditor/. (#540)
• It’s now possible to set the “Custom Styles” setting to a CSS file within config/ckeditor/. (#540)
• The v5 migration now automatically creates JS/JSON/CSS files within config/ckeditor/ for any Config Options/Custom Styles from CKEditor Configs that were used by two or more fields. (#540)
• Fixed an error that could occur when registering a custom CKEditor plugin. (#531)

• Fixed a bug where @import statements within custom styles weren’t working. (#538)
• Fixed a bug where CKEditor Config settings could be lost when updating to CKEditor 5. (#517)

• It’s now possible to drag-and-drop images into fields with the “Nested entries” image mode, if the “Add nested content” button is present, but not “Insert image”. (#524)
• Added craft\ckeditor\web\assets\BaseCkeditorPackageAsset::getImportCompliantLanguage().
• Fixed a bug where custom toolbar config settings were getting ignored. (#522)
• Fixed a bug where files uploaded to Assets fields could also be added to nearby CKEditor fields. (#523)
• Fixed an error that could occur when registering a custom CKEditor plugin. (#525)
• Fixed a JavaScript error that occurred if the control panel was being translated into a language that CKEditor doesn’t support. (#526)

• Updated CKEditor 5 to 47.6.0. (#518)
• Fixed an error that could occur if a CKEditor field’s value was instantiated without a known site ID. (#500)
• Fixed an error that occurred if a CKEditor field was saved with no selected heading levels. (#511)
• Fixed a bug where inline entry type creation wasn’t working. (#515)
• Fixed a bug where import map URLs could have query strings appended to them. (#516)
• Fixed an arrer that could occur when applying project config changes, if a newly-added entry type was selected by a CKEditor field. (#512)

• Fixed a bug where new nested entries created for images weren’t always respecting the selected entry type. (#510)

Third party CKEditor plugins are now registered as modules. See #363 for details on how to update existing Craft plugins.

• CKEditor now requires Craft CMS 5.9 or later.
• Added support for fullscreen mode. (#399)
• The link modal UI now reflects Craft’s native Link fields. (#375)
• It’s now possible to choose which entry types should get a dedicated toolbar button versus be listed within the “Add nested content” menu. (#423)
• Added support for drag-n-drop image uploading. (#486)
• Added support for inserting new images as nested entries. (#509)
• Added the “Advanced Link Fields” setting. (#375)
• Custom editor styles now get registered with a higher specificity than the default editor styles. (#433)
• Added craft\ckeditor\Field::$advancedLinkFields.
• Added craft\ckeditor\Field::$css.
• Added craft\ckeditor\Field::$headingLevels.
• Added craft\ckeditor\Field::$imageEntryTypeUid.
• Added craft\ckeditor\Field::$imageFieldUid.
• Added craft\ckeditor\Field::$imageMode.
• Added craft\ckeditor\Field::$js.
• Added craft\ckeditor\Field::$options.
• Added craft\ckeditor\Field::$toolbar.
• Added craft\ckeditor\Field::IMAGE_MODE_ENTRIES.
• Added craft\ckeditor\Field::IMAGE_MODE_IMG.
• Added craft\ckeditor\Field::entryType().
• Added craft\ckeditor\Field::getImageEntryType().
• Added craft\ckeditor\Field::getImageField().
• Added craft\ckeditor\Field::getJson().
• Added craft\ckeditor\Field::setJson().
• Added craft\ckeditor\helpers\CkeditorConfig. (#363)
• Added craft\ckeditor\web\assets\BaseCkeditorPackageAsset::$namespace. (#363)
• Updated CKEditor 5 to 47.5.0. (#502)
• Fixed a JavaScript error that could occur when editing an element in a slideout. (#429)

• Fixed an error that could occur if a CKEditor field’s value was instantiated without a known site ID. (#500)

• Fixed an error that could occur when creating a nested entry. (#505)
• Fixed a bug where &nbps; briefly appeared below the editor on page load, if the “Show word count” setting was enabled. (#507)

• Fixed a bug where CKEditor field values weren’t always getting propagated to other sites (with duplicated nested entries) when creating a new element. (#479)
• Fixed styling issues on CKEditor config edit screens. (#494)

• Statically-rendered CKEditor fields are now shown in read-only mode. (#466)
• Fixed a bug where reversed attributes were being removed from <ol> elements by HTML Purifier. (#463)
• Fixed a bug where custom heading level configs weren’t always respected. (#470)
• Fixed a bug where selected heading levels weren’t always allowed within CKEditor fields. (#470)
• Fixed a bug where soft-deleted nested Matrix entries were getting restored by the convert/matrix command. (#468)

• Fixed a bug where heading levels specified via heading.options were being ignored if their corresponding checkbox wasn’t checked. (#456)

• Added support for cross-site field value copying. (#450)
• Fixed a bug where the CKEditor toolbar overflow menu could be cut off within Live Preview. (#417)
• Fixed a bug where the Field Limit setting was treating multibyte characters as multiple characters. (#441)
• Fixed a bug where the ckeditor/convert command wasn’t fully converting all Redactor fields within nested field contexts. (#432)
• Fixed a JavaScript error that occurred if a CKEditor field wasn’t configured with any link options. (#435)
• Fixed a bug where the heading.options CKEditor config option was overriding the available heading levels defined by the “Heading Levels” setting. (#431)
• Fixed a bug where new paragraphs were getting inserted automatically after newly-added nested entries. (#416)
• Fixed a JavaScript error that occurred when saving a nested entry, for an owner element that didn’t use the new element editor (like global sets). (#419)
• Fixed a bug where entry type toolbar buttons didn’t always meet minimum contrast requirements. (#424)

• Added the “Parse embeds” field setting. (#409)
• Added the “Show toolbar buttons for entry types with icons” field settings. (#413)
• Fixed an error that occurred when copy/pasting a nested entry from a top-level element’s CKEditor field into a nested element’s CKEditor field. (#408)
• Fixed an error that could occur when generating a GraphQL introspection schema, if a CKEditor field’s GraphQL Mode setting was set to “Full data”. (#414)

• Added the “Field Limit” field setting, which can be set to a character limit or word limit. (#384)
• Added the “GraphQL Mode” field setting. (#403)
• Editor toolbars now have dedicated nested entry creation buttons, for entry types that have icons. Any entry types that don’t have an icon are now grouped into a “+” menu. (#404)
• Improved the styling of CKEditor fields. (craftcms/cms#17164)
• The “Anchors” CKEditor plugin has been replaced with CKEditor’s new built-in Bookmarks plugin. (#397)
• Removed the “‘New’ Button Label” field setting. (#404)
• Updated CKEditor 5 to 45.0.0. (#397)
• Added craft\ckeditor\Field::$characterLimit.
• Added craft\ckeditor\Field::$fullGraphqlData.
• Added craft\ckeditor\data\FieldData::getEntries().
• Added craft\ckeditor\data\Markup::getMarkdown().
• Added craft\ckeditor\data\Markup::getPlainText().
• Added craft\ckeditor\gql\CkeditorData.
• Added craft\ckeditor\gql\CkeditorMarkup.
• Added craft\ckeditor\gql\Generator.
• Fixed a bug where it wasn’t easily possible to drag a toolbar button to the last position in the toolbar, if that meant wrapping the buttons to a new row.
• Fixed a JavaScript error that could prevent the toolbar configurator from loading, when editing a CKEditor config within a slideout. (#401)

• Nested entry cards no longer have edit buttons within their toolbars, or hyperlink their titles. (#387)
• JavaScript-based CKEditor configs can now access the CKEditor instance via an instance variable. (#385)
• Fixed a bug where expanded toolbar menus could be masked by a subsequent CKEditor field’s toolbar. (#376)
• Fixed a bug where back-end word limit validation wasn’t handling multiple words separated only by HTML tags properly. (#383)
• Fixed a bug where focus wasn’t getting handled properly when closing nested entry slideouts. (#388)
• Fixed a bug where CKEditor fields were inheriting the text color from Matrix field blocks. (#390)

• Added the ability to override entry type names and handles for CKEditor fields. (#369)
• CKEditor fields now show provisional drafts for nested entries when previewing an owner element. (#340)
• Fixed an error that occurred if the “Who should see the ‘Source’ button?” field setting was totally blank. (#359)

• CKEditor now requires Craft CMS 5.6+.
• Added support for viewing CKEditor settings when allowAdminChanges is disabled. (#358)
• CKEditor fields no longer have extra bottom padding, and the CKEditor logo is now displayed over the bottom border. (#252)
• Added the ability to show the “Source” button for specific user groups. (#318)
• Added craft\ckeditor\Field::$sourceEditingGroups.
• Deprecated craft\ckeditor\Field::$enableSourceEditingForNonAdmins.
• Updated CKEditor 5 to 44.0.0.
• Fixed a bug where toolbar menus weren’t usable within slideouts. (#345)
• Fixed a bug where “Edit entry” buttons were only partially translated. (#337)
• Fixed a bug where copying and pasting nested entries wasn’t working on non-primary sites. (#315)
• Fixed an error that could occur when editing nested entries on newly-created provisional drafts. (#339)
• Fixed an error that occurred when editing a CKEditor field, if its CKEditor config had been deleted. (#344)

• When saving a nested entry within a CKEditor field, the changes are now saved to a draft of the owner element, rather than published immediately. (craftcms/cms#16002, #308)

• Fixed a bug where sticky toolbars weren’t positioned correctly.

• Image toolbars now include an “Edit Image” button. (#253)
• The ckeditor/convert/redactor command now ensures that it’s being run interactively.
• CKEditor container divs now have data-config attributes, set to the CKEditor config’s handle. (#284)
• Fixed a bug where page breaks were being lost.
• Fixed a bug where menus within overflown toolbar items weren’t fully visible. (#286)
• Fixed an error that occurred when editing a nested entry, if it didn’t exist in the primary site. (#295)

• CKEditor now requires Craft CMS 5.3+.
• Added the ckeditor/convert/matrix command. (#234)
• CKEditor fields can now be merged together. (#277)
• CKEditor configs created via the ckeditor/convert command now allow modifying HTML attributes, classes, and styles within the source view, if the Redactor config included the html button. (#264, #263)
• Added craft\ckeditor\migrations\BaseConvertMatrixContentMigration.
• Fixed a bug where CKEditor fields’ search keywords were including nested entries’ rendered partial templates rather than nested entries’ search keywords.
• Fixed a bug where nested entries weren’t always getting propagated correctly. (#254)
• Fixed a bug where code blocks created by a Redactor field only had <pre> tags with no <code> tags inside them. (#258)
• Fixed a bug where dropdown menus didn’t have a maximum height. (#268)
• Fixed a bug where word counts weren’t handling unicode characters correctly. (#275)

• Entry cards now display provisional changes, with an “Edited” label.
• It’s now possible to loop over CKEditor field values from templates, which will split the value into chunks representing HTML markup and nested entry entries. (#241)
• It’s now possible to copy/paste nested entries across CKEditor fields, as long as the entry type is allowed. (#237)
• Added craft\ckeditor\events\ModifyConfigEvent::$toolbar. (#233)
• CKEditor now requires Craft CMS 5.2+.
• Fixed a bug where nested entry edit pages could have a “Delete for site” action.
• Fixed a bug where disabled nested entries were getting rendered on the front end. (#246)
• Fixed a bug where disabled nested entries could get deleted.

• Fixed a bug where newly-created nested entries were getting soft-deleted. (#229)

• Fixed a bug where nested entries weren’t visible when viewing revisions. (#227)
• Fixed a bug where nested entry cards were getting rendered after page load. (#221)
• Fixed a bug where nested entry cards were getting labelled as invalid, for newly-created, then deleted, then restored entries. (#224, #228)
• Fixed a bug where deleting and restoring an existing nested entry wouldn’t restore the entry’s ownership data. (#228)
• Fixed a bug where soft-deleted entries weren’t getting rendered on front-end preview requests. (#223)

• Fixed a bug where front-end links included element reference URL fragments. (#197)
• Fixed a bug where resave commands would replace nested entries with their rendered output in stored CKEditor field values. (#211)

• Fixed a bug where the ckeditor/convert command wasn’t checking for and removing the old configFile Redactor setting. (#199)

• Fixed a bug where the “Insert image” toolbar button wasn’t available when editing CKEditor configs. (#195)

• Fixed an error that could occur when editing an entry with nested CKEditor entries that used a soft-deleted entry type. (#191)
• Fixed a bug where revisions weren’t getting created for the owner element, when CKEditor fields were edited. (#194)

• CKEditor now requires Craft CMS 5.0.0-beta.7 or later.
• Added the ability to embed nested entries within CKEditor fields.
• Added the “Entry Types” field setting.
• Added the “‘New’ Button Label” field setting. (#159)
• It’s now possible to edit the selected CKEditor config from field settings.
• The CKEditor inspector is now shown for admin users, if a CRAFT_SHOW_CKEDITOR_INSPECTOR environment variable is set to true.
• Added craft\ckeditor\Field::entryManager().

• Added support for creating anchor links. (#169)
• Improved accessibility for screen readers. (#74, #166)
• Fixed a bug where resized images weren’t getting updated width and height attributes. (#165)
• Fixed JavaScript warnings. (#168, #171)

• Fixed a JavaScript error. (#161)

• Added the IndentBlock CKEditor plugin, enabling the “Increase indent” and “Decrease indent” buttons to work on headings and paragraphs. (#156)

• Fixed a JavaScript error.

• Link element selector modals now include custom sources. (#139)
• Updated CKEditor 5 to 41.0.0. (#141, #148)
• Added the RemoveFormat CKEditor plugin. (#143)
• Added the TodoDocumentList CKEditor plugin. (#148)
• Removed the List, ListProperties, and TodoList CKEditor plugins. (#148)
• CKEditor fields now get a not-allowed cursor when viewing entry revisions. (#142)
• Fixed a bug where the CKEditor config-creation slideout could keep reappearing if canceled. (#138)
• Fixed a conflict with nystudio107/craft-code-editor 1.0.14 and 1.0.15. (#150)

• CKEditor is now released under the GPL-3.0 license.
• HTML Purifier is now configured to allow style attributes on <ol> and <ul> tags, when bulleted/numbered lists are allowed. (#136)
• Updated CKEditor 5 to 39.0.2.

• Fixed a bug where CKEditor inputs weren’t getting any padding within slideouts. (#126)
• Fixed a bug where the image transform menu wasn’t visible if only one transform was selected for the field. (#131)

• CKEditor now requires Craft 4.5.0 or later.
• Added the “Word Limit” field setting. (#107)
• Added the “List Plugin” CKEditor config setting. (#112, #122)
• Added the Text part language feature.
• Added keyboard shortcuts for switching the heading type for a given block. (#106, #116)
• CKEditor config edit pages now have a “Save and continue editing” alternative submit action, and the Command/Ctrl + S keyboard shortcut now redirects back to the edit page. (#108)
• CKEditor config edit pages now have a “Save as a new config” alternative submit action. (#110)
• The ckeditor/convert action will now find and convert craft\fields\MissingField instances that were meant to be Redactor fields.
• CKEditor fields with the “Insert table” button now include the TableProperties and TableCellProperties plugins. (#103, #115)
• Norwegian Bokmål and Nynorsk both now load the main Norwegian (no) UI translations. (#113)
• Added support for setting the toolbar.shouldNotGroupWhenFull CKEditor config option. (#124)
• The Attr.AllowedFrameTargets and Attr.AllowedRel HTML Purifier config settings are now automatically set based on the CKEditor link configuration. (#79)
• input[type=checkbox] is now automatically added to the HTML Purifier definition, for editors that include the To-do List button. (#121)
• Added craft\ckeditor\Plugin::registerCkeditorPackage().
• Deprecated craft\ckeditor\web\assets\ckeditor\CkeditorAsset::EVENT_PUBLISH.
• Fixed a bug where could get marked as dirty when focussed, without making any changes. (#90)
• Fixed a bug where the Norwegian Nynorsk UI translations weren’t working. (#113)
• Updated CKEditor 5 to 39.0.1.

• Added the ability to change an image’s transform. (#94)
• Added support for registering additional CKEditor plugins. (#97)
• CKEditor configs generated from Redactor fields no longer set link.addTargetToExternalLinks = true for Redactor fields that had linkNewTab enabled. (#98)
• Image and media markup defined by Redactor fields now gets updated to be consistent with how CKEditor likes it. (#96, #100)
• Fixed a JavaScript error that occurred if there were no sections, category groups, or volumes.
• Fixed a bug where inserted images were missing their ref tag hashes, if no transform was selected and the field was configured with a default transform.
• Added craft\ckeditor\web\assets\BaseCkeditorPackageAsset.
• Added craft\ckeditor\web\assets\ckeditor\CkeditorAsset::EVENT_PUBLISH.
• Updated CKEditor 5 to 37.1.0.

• Added the “Show the ‘Source’ button for non-admin users?” field setting. (#82)
• Link dropdowns now include an “Insert link” option. (#78)
• Link edit forms now include a site selection dropdown, when the URL contains a localizable element’s reference tag. (#89)
• Tables now show a toolbar with row, column, and cell-merging controls. (#81)
• Improved the styling of code blocks’ language labels.
• Fixed a bug where fields with <br> tags and non-breaking spaces would get marked as dirty without making any changes. (#85, #90)
• Fixed a bug where changes in Source mode weren’t getting saved, unless Source mode was deactivated. (#84)

• Fixed an error that occurred when a CKEditor field was used in Quick Post widgets.

• Added the “Show word count” field setting. (#75)
• Added the Font CKEditor plugin, which provides “Font Size” “Font Family”, “Font Color”, and “Font Background Color” toolbar buttons.
• Ordered/unordered list buttons now include additional options.
• Config options are now automatically updated when “Heading”, “Style”, “Alignment”, and “Font Size” buttons are added/removed in the toolbar. (#73)
• Fixed a bug where unordered lists weren’t padded. (#72)

• Added the “Heading Levels” CKEditor config setting.
• Added the ckeditor/convert command, for converting Redactor fields/configs to CKEditor. (#68)
• “Config Options” settings can now be entered as JSON, with autocompletion and automatic JavaScript-to-JSON reformatting on paste. (#66, #67)
• The placeholder config option now gets translated, when the config options are defined as JSON.
• Images now have caption and alternative text toolbar items by default.
• CKEditor instances no longer support editing features that aren’t explicitly allowed via toolbar items. (#65)
• Added craft\ckeditor\events\ModifyConfigEvent.
• Added craft\ckeditor\Field::EVENT_MODIFY_CONFIG. (#70)
• Fixed a bug where editor toolbars would overlap the control panel header when scrolling.
• Fixed a bug where the editor UI wasn’t getting translated.

This is a major overhaul of the plugin. Your existing CKEditor fields and content will remain in-tact, however you’ll need to reconfigure your fields with a new CKEditor Config.

• CKEditor 5 now comes bundled with the plugin.
• Dropped support for CKEditor 4 and custom builds.
• Added globally-managed CKEditor configurations, featuring drag-n-drop toolbars, and inputs for defining custom config options and CSS styles.
• Added the ability to create links to entries, categories, and assets.
• Added the ability to insert asset images, optionally with a transform pre-applied.
• The “Available Volumes”, “Available Transforms”, “Default Transform”, “Show unpermitted volumes”, and “Show unpermitted files” field settings are now supported for CKEditor 5.
• Removed the “Initialization Code” field setting.
• Added craft\ckeditor\Field::EVENT_DEFINE_LINK_OPTIONS.
• Added craft\ckeditor\events\DefineLinkOptionsEvent.
• Removed craft\ckeditor\events\ModifyPurifierConfigEvent.

• CKEditor now requires Craft CMS 4.3.6 or later.
• Fixed a bug where CKEditor 4 stopped working when used within a Matrix block, if the block was moved to a new position. (#23)
• Fixed a bug where changes made in source mode weren’t saved unless additional changes were made in WYSIWYG mode afterward. (#34)

• Added RTL language support. (#33, #55)
• Fixed a bug where it wasn’t possible to browse files. (#45)

Added

• Added Craft 4 compatibility

• CKEditor now requires Craft CMS 3.7.63 or later.
• Fixed a bug where CKEditor 4 stopped working when used within a Matrix block, if the block was moved to a new position. (#23)
• Fixed a bug where changes made in source mode weren’t saved unless additional changes were made in WYSIWYG mode afterward. (#34)

• Added RTL language support. (#33, #55)

Changed

• Static element URLs that contain query string parameters are no longer converted to reference tags.

Deprecated

• Deprecated craft\ckeditor\events\ModifyPurifierConfigEvent. craft\htmlfield\events\ModifyPurifierConfigEvent should be used instead.

Fixed

• Fixed a bug where reference tags weren’t getting parsed on the front end.

Fixed

• Fixed an error that occurred if Redactor wasn’t also installed.

Added

• Added support for CKEditor 4’s file manager integration. (#11)
• Added the “Show unpermitted volumes” field setting (CKEditor 4 only).
• Added the “Available unpermitted files” field setting (CKEditor 4 only).
• Added the “Available Volumes” field setting (CKEditor 4 only).
• Added the “Available Transforms” field setting (CKEditor 4 only).
• Added the “Default Transform” field setting (CKEditor 4 only).
• CKEditor fields now convert static element URLs to reference tags on save.

Changed

• CKEditor now requires Craft 3.7.31 or later.
• The “Initialization Code” field setting now auto-expands its height to fit the contents.
• Custom initialization code can now reference language, filebrowserBrowseUrl, and filebrowserImageBrowseUrl constants, which are predefined.
• It’s now possible to include SVG images within field values, without them being removed by HTML Purifier. They will be sanitized with SVG Sanitizer instead.
• CKEditor 5 32.0.0 is now used by default, if a custom CKEditor Build URL hasn’t been set.

Changed

• Fixed a bug where privacy-enhanced YouTube video embeds were getting stripped out by HTML Purifier. (craftcms/redactor#312)

Changed

• Improved content styles.

Added

• Added support for the “Inline” and “Balloon” CKEditor 5 distributions.

Changed

• Improved the focussed editor styling.

Fixed

• Fixed a PHP error that occurred when saving CKEditor fields.

Added

• Added partial support for CKEditor 4.
• Added the “CKEditor Build URL” plugin setting, making it possible to customize which CKEditor build is used.
• Added the “Initialization Code” field setting, making it possible to take control over the editor initialization and configuration.
• Added craft\ckeditor\Field::EVENT_MODIFY_PURIFIER_CONFIG, which makes it possible to modify the HTML Purifier config at runtime.

Changed

• The plugin now requires Craft 3.6 or later.
• CKEditor 5 (27.0.0, “classic” build) is now used by default.
• The default HTML Purifier config now allows video embeds from YouTube and Vimeo.

Changed

• CKEditor fields’ default HTML Purifier config now allows id attributes. (craftcms/redactor#82)

Fixed

• Fixed a bug where content changes weren’t getting saved in Craft 3.4. (#22)
• Fixed a deprecation error. (#17)
• Fixed a bug where an empty CKEditor field would return some HTML content.

Changed

• Improved the field content legibility.

Fixed

• Fixed a bug where lists were’t getting indented, and were missing their bullets/numerals. (#1)

Initial release.