Skip to main content

​
WordPress Gutenberg Block Editor

Welcome to the development hub for the WordPress Gutenberg project. Gutenberg is a codename for a whole new paradigm in WordPress site building and publishing that aims to revolutionize the entire publishing experience as much as Gutenberg did the printed word.

​
What is Gutenberg?

The Gutenberg Block Editor introduces a modular approach to pages and posts: each piece of content in the editor, from a paragraph to an image gallery to a headline, is its own block. Just like physical blocks, WordPress blocks can be added, arranged, and rearranged, allowing you to create media-rich pages in a visually intuitive way—without workarounds like shortcodes or custom HTML. The block editor first became available in December 2018, and is now the core editing experience for WordPress. The Gutenberg plugin provides the latest version of the block editor, with bleeding-edge features and improvements.

What is Gutenberg?

Learn about the project’s vision and how the block editor transforms WordPress publishing

Key Concepts

Understand blocks, patterns, templates, and the core concepts behind the block editor

Quick Start Guide

Get started building your first custom block in minutes

Packages

Explore the JavaScript packages that power the block editor

​
The Four-Phase Vision

Gutenberg is currently in the second phase of a four-phase process that will touch every piece of WordPress:
  1. Editing - A new editing experience with the block editor (completed)
  2. Customization - Full site editing with blocks and templates (in progress)
  3. Collaboration - Real-time collaboration, workflows, revisions, and publishing flows
  4. Multilingual - Native multilingual support throughout WordPress

​
Key Features

Modular Architecture: Every piece of content is a block, providing a consistent interface for inserting, moving, reordering, copying, duplicating, transforming, and deleting content.
Block Patterns: Combine blocks into reusable design patterns that provide starting points for building advanced pages and layouts quickly.
Full Site Editing: Use blocks to build your entire site from header to footer with templates and template parts.

​
Developer Resources

Extending and customizing is at the heart of the WordPress platform. The block editor can be extended by third-party developers using plugins.
  • Block Editor Handbook: Extensive tutorials, documentation, and API references
  • WordPress Developer Blog: Technical articles about block development
  • Learn WordPress: Courses on block development fundamentals
  • Storybook: Interactive component documentation at wordpress.github.io/gutenberg

​
System Requirements

"engines": {
  "node": ">=20.10.0",
  "npm": ">=10.2.3"
}
The Gutenberg plugin requires:
  • WordPress 6.8 or later
  • PHP 7.4 or later
  • Node.js 20.10.0 or later for development

​
Get Involved

Gutenberg is open-source and welcomes all contributors from code to design, and from documentation to triage. Join the community in the #core-editor channel on WordPress Slack.

Contributors Handbook

Learn how to contribute to the Gutenberg project

GitHub Repository

View the source code and submit issues or pull requests

Build docs developers (and LLMs) love

Get started for freeTalk to us