Get Setup for Testing

Welcome! To help test Gutenberg, your first step will be to set up a test environment.

Install as a Plugin Install as a Plugin

Use this option to do general testing with the latest beta or release candidate versions of Gutenberg:
  1. Go to
  2. Download the latest file.
  3. Go to WP Admin > Plugins > Add New > Upload Plugin.
  4. Select the file from step 2.
  5. Follow the prompts to install and activate the plugin.

Top ↑

Set Up a Site Set Up a Site

  1. Go to and click “Create.”
  2. You can test Gutenberg on 5.0 stable from this point, and if you need to test the latest updates to Gutenberg then loop back to the “Install as a Plugin” section above and also add the latest plugin released.

Top ↑

Install in a Local Environment Install in a Local Environment

Use this option if you would like to test pull requests or if you would like to check if something is working with the bleeding edge version.
  1. Make sure you have gitnode, and npm installed.
  2. Install docker.
  3. Clone the gutenberg repository locally.
  4. Run bin/ from the root directory of the repository.
  5. Run npm run dev from the root directory of the repository.
  6. Open localhost:8888 in your browser (username: admin, password: password).
Need more detailed installation instructions? Please see Contributing in the documentation.

Top ↑

Useful Commands Useful Commands

All of these commands are intended to be run from Terminal, in your Gutenberg directory. Running npm install occasionally is a useful habit, as well as any time you know that packages.json has been changed. If you restart your computer, or upgrade Docker, start the Gutenberg containers again by running: docker-compose up -d It’s a good practice to stop (with Ctrl+Cnpm run dev and restart when you switch to a different branch. If everything is broken, and you have no idea what’s happened, run bin/ again to reset everything to a fresh install. Thank you for testing!