How to contribute to Gutenberg

Contributing to an open source project can be fun. But how to get started? The following simple steps should get you up and running and empower you to contribute to open source projects on Github.

Fork and clone the original repository

  1. Head over to
  2. Create a personal fork, e.g.
  3. Clone the fork into the plugin folder on your local environment
  1. Move into Gutenberg plugin folder

Add an upstream

  1. Add upstream
  1. Verify upstream

Synch the fork

  1. Fetch upstream
  1. Check out the master branch
  1. Merge changes from the upstream/master into the local master branch


Now, you should have a fork of the original repository added to your Github profile as well as having the upstream defined and your local master branch synched with the upstream branch. Thus, time to apply your own changes to the code.

Push changes and create pull request

  1. Push the local master branch
  1. Head over to your forked repository and click on New pull request.

Install dependencies and start watcher

  1. Open a terminal and browse to the Gutenberg plugin folder
  2. Install dependencies
  1. Activate watcher



Omkar Bhagat October 2, 2018 Reply

Thanks for sharing this Niels! 🙂

Niels Lange October 2, 2018 Reply

You’re very welcome! I remember that months ago I struggled with this and received great help from a friend. Especially the upstream part wasn’t obvious to me initially.

Omkar Bhagat October 2, 2018

Ditto! I recently learned the upstream part when contributing to Jetpack repo.

Leave a Reply to Omkar Bhagat Cancel reply