dot CMS

Block Editor

June 29, 2026

Block Editor

Description

The Block Editor is the Story Block field you add to any content type to compose rich, structured content. Instead of one long blob of HTML, authors build with discrete, reorderable blocks: paragraphs, headings, lists, tables, images, video, code, and embedded contentlets. Every document is stored as structured JSON, so the same content renders cleanly in dotCMS templates, headless front ends, mobile apps, and other channels.

The writing experience follows patterns authors already know. A persistent top toolbar, like Google Docs or Word, keeps every formatting control in one place, and focus mode expands the editor into a large, distraction-free canvas for long-form writing. Authors can paste Markdown from other tools and keep its structure. A larger asset picker makes it faster to find images, video, and content to embed, with multi-word search that actually narrows results, and adding a link suggests matching dotCMS pages as you type.

Output is clean and accessible. Tables carry header scope, captions, and aria labels, and subscript and superscript render as real sub and sup elements, consistently across dotCMS templates and the React and Angular SDKs.

The Block Editor was first released in dotCMS 22.08. Since then it has had two major updates:

  • v2 (25.08.11-01): moved to the stable TipTap release and official TipTap extensions for smoother menus and drag-and-drop, and added Markdown copy and paste.

  • v3 (26.06.29-01): rebuilt on TipTap v3 with the fixed top toolbar, focus mode, larger asset picker, internal link search, and accessible table output. The stored JSON is unchanged, so existing content needs no migration.


Benefits

For Content and Marketing Teams

  • Write in a familiar surface: a fixed top toolbar keeps controls in one place, and focus mode gives long-form drafts a distraction-free canvas.

  • Build and reorganize media-rich content by dragging blocks, with images, video, tables, code, and embedded content as first-class elements.

  • Bring drafts in from other tools by pasting Markdown instead of rebuilding formatting by hand.

  • Find and place assets faster in a larger picker, and add internal links by searching dotCMS pages instead of copying URLs.

For Developers and Platform Teams

  • Work with structured JSON instead of opaque HTML: predictable block data that maps cleanly to front-end components.

  • Ship accessible output by default, with consistent table semantics across dotCMS templates and the React and Angular SDKs, plus an opt-in clean-semantic Angular renderer for lean, standards-aligned markup.

  • Extend the editor with custom blocks on the standard TipTap v3 foundation.

  • Take editor upgrades without content migration or consumer changes; the JSON shape and governance field variables stay the same.


Use Cases

Long-form articles, blogs, and documentation
A marketer drafting a detailed product update works in focus mode, structures it with headings, lists, and tables, drags blocks to reorder a section, and pulls a diagram from the asset picker, all without leaving the editor or filing a developer ticket.

Bringing in drafts from other tools
A writer who outlines elsewhere pastes the Markdown draft into the editor. Headings, lists, and code arrive as blocks, with minimal clean-up.

Placing related content where it belongs
A product marketer writing a product description adds supporting material where it matters: a product table under the feature overview, an image beside the description, and an embedded product contentlet near the call to action. They find each item in the asset picker, drop it into place, and drag blocks to reorder. Embedded contentlets stay linked to their source, so when product details change, the description updates too.

Keeping documentation on standard
A technical writing team publishes product guides that must all follow one format. The admin limits the guide's Block Editor field to headings, lists, tables, code, and images, and allows only approved content types to be embedded. Writers can't add anything off-standard, so every guide looks and renders the same.

Accessible headless delivery
A developer renders Block Editor JSON in a React, Next.js, or Angular front end through the dotCMS SDKs, delivering tables with proper header scope and captions, with no HTML scraping or post-processing.


Resources

Explore dotCMS for your organization

image

dotCMS Named a Major Player

In the IDC MarketScape: Worldwide AI-Enabled Headless CMS 2025 Vendor Assessment

image

Explore an interactive tour

See how dotCMS empowers technical and content teams at compliance-led organizations.

image

Built for Compliance. Certified for AI.

dotCMS is ISO 27001 and ISO 42001 certified, pairing independently verified information security with governed, accountable AI.