Skip to main content
Welcome to WordPress Gutenberg’s contributing guide! The Gutenberg project is an open-source initiative that welcomes all contributors—from code to design, and from documentation to triage. The project is built by many contributors and volunteers, and we’d love your help building the future of web publishing.

How You Can Contribute

There are many ways to contribute to the Gutenberg project:

Code Contributions

Write JavaScript, PHP, or React Native code for the block editor

Design

Contribute to UI/UX design and user experience improvements

Documentation

Write and improve documentation for developers and users

Triage

Review existing issues to ensure they’re relevant and actionable

Getting Started

1

Join the Community

Connect with the Gutenberg community in the #core-editor channel on WordPress Slack. Slack is free to join and is where real-time discussions take place.
2

Read the Guidelines

Review the Code of Conduct to ensure a welcoming environment for everyone. All contributors are expected to follow these guidelines.
3

Choose Your Path

Decide how you want to contribute:
4

Start Contributing

Browse good first issues to find beginner-friendly tasks, or explore good first review pull requests if you’re interested in code reviews.

Community Resources

Slack Channels

Join the WordPress Slack to connect with other contributors:
  • #core-editor: Main channel for Gutenberg development discussions
  • #core-js: JavaScript development discussions
  • #docs: Documentation contributions and meetings (Tuesdays at 14:00 UTC)

Development Hub

The Gutenberg project uses GitHub for code management and issue tracking:

Additional Resources

Important Guidelines

All WordPress projects follow the WordPress Code of Conduct. With that in mind, all contributors are expected to maintain a welcoming environment for everyone.

Key Principles

React Native Considerations

If your changes affect function/class/variable names, verify that any changes in your PR are mirrored in the corresponding .native.js versions of the files to avoid introducing breaking changes in the React Native Mobile Editor.

Finding Work

Good First Issues

Issues labeled Good First Issue are specifically identified as good for new contributors. When you find one you’d like to work on:
  1. Comment on the issue to indicate you intend to work on it
  2. Reference the issue number in your pull request when you submit it

Good First Reviews

Pull requests labeled Good First Review are good starting points for contributors interested in doing code reviews.

Reporting Security Issues

If you discover a security vulnerability, please see SECURITY.md for reporting instructions. Do not create public issues for security vulnerabilities.

Next Steps

Ready to contribute? Here are your next steps:

Code Contributions

Set up your development environment and start coding

Documentation

Help improve documentation for developers and users

Testing Guide

Learn how to write and run tests

Git Workflow

Understand the pull request process

Build docs developers (and LLMs) love