Browse: Home / Block Editor Handbook

Block Editor Handbook Edit

The Gutenberg project is transforming the way content is created on WordPress. A block editor was the first product launched creating a new methodology for working with content.

The Block Editor handbook provides documentation for designers and developers on how to extend the editor, and also how you can start contributing to the project. For authors, writers, and users of the block editor see the block editor support documentation.

Using a system of Blocks to compose and format content, the new block-based editor is designed to create rich, flexible layouts for websites and digital products. Content is created in the unit of blocks instead of freeform text with inserted media, embeds and Shortcodes (there’s a Shortcode block though).

Blocks treat Paragraphs, Headings, Media, and Embeds all as components that, when strung together, make up the content stored in the WordPress database, replacing the traditional concept of freeform text with embedded media and shortcodes. The new editor is designed with progressive enhancement, meaning that it is back-compatible with all legacy content, and it also offers a process to try to convert and split a Classic block into equivalent blocks using client-side parsing. Finally, the blocks offer enhanced editing and format controls.

The Editor offers rich new value to users with visual, drag-and-drop creation tools and powerful developer enhancements with modern vendor packages, reusable components, rich APIs and hooks to modify and extend the editor through Custom Blocks, Custom Block Styles and Plugins.

Quick Links

  • Beginners: The Create a Block Tutorial walks through creating a block plugin using the @wordpress/create-block package; a quick and easy way to start creating your own block.

  • Gutenberg Architecture covers the conceptual and tool choices going into the Gutenberg project, from repository structure to packages and tools.

  • Block API Reference

  • Contributors Guide covers how you can help; be it code, design, documentation, language, or triage, we need you to help make Gutenberg.