Editor.js 2.31: Read-only Enhancements, API Updates, Stability Fixes

This release focuses on polishing the Editor’s read-only mode, improving APIs for developers, and fixing several long-standing issues across different browsers.

Read-only Mode

We’ve expanded the capabilities of read-only mode:

• Inline tools with isReadOnlySupported can now be used even when the Editor is initialized as read-only.
• Their keyboard shortcuts are also active in this mode, providing a smoother reviewing experience.
• Clicking on blocks now correctly updates the current block reference in read-only mode, allowing integrations to track user navigation across content.

API Improvements

A set of updates makes the Editor.js API more predictable and flexible:

• Block Manager now passes the tool’s config into conversionConfig.import, enabling more precise block conversions.
• caret.setToBlock() offset works across the entire block content, not just the first or last node.
• blocks.renderFromHTML() is now asynchronous and can be awaited.
• .clear() API no longer causes index invalidation issues.

Editing Experience

• Shift + Up/Down now selects the previous/next line of text instead of toggling the Inline Toolbar.
• Tool developers will also notice that submodules of tools have been removed from the repository, simplifying dependency management.

Fixes and Stability

We’ve resolved several bugs and memory issues:

• Autofocus now works correctly on the first block in read-only initialization.
• Fixed incorrect caret position in Safari after merging blocks.
• Prevented identical shortcuts being shown for multiple Toolbox items from the same tool.
• codex-notifier and codex-tooltip were moved from devDependencies to dependencies to fix type errors.
• Inputting whitespace into empty placeholders no longer moves the caret unexpectedly.
• Fixed a memory leak in the Shortcuts class.
• The  /   command no longer overrides text selected outside of the Editor.
• blocks.renderFromHTML() no longer throws "Can't find a Block to remove.".

This update makes Editor.js more stable, predictable, and pleasant to use, especially in read-only scenarios where content review or presentation is required.

Update now

If you like the release

If you like this release and want more updates of Editor.js core, API, Tools and ecosystem, support CodeX team with a donation via OpenCollective platform:

🥇 Support Editor.js on OpenCollective

🎖️ Support Editor.js on Patreon

Why donate

Donations to open-source products have several advantages for your business:

• If your business relies on some of our products, you'll probably want these products to be maintained
• It helps products you rely on to evolve and get the new features
• We can support contributors and the community around the project. You'll receive well organized docs, guides, etc.
• We need to pay for our infrastructure and maintain public resources (domain names, homepages, docs, etc). Supporting it guarantees you to access any resources at the time you need them. 
• You can advertise by adding your brand assets and mentions on our public resources

Need something special?

Hire CodeX experts to resolve technical challenges and match your product requirements. 

• Resolve a problem that has high value for you
• Implement a new feature required by your business
• Help with integration or tool development
• Provide any consultation

Contact us via [email protected] with your details.

Thanks everyone. We'll return with the new update in a while.