---
title: Block Unit Test
description: 'The Block Unit Test WordPress plugin simplifies testing Gutenberg’s core blocks, ensuring your themes are ready for the new block editor.'
doc_version: current
last_updated: '2026-03-31T09:57:52.000Z'
date: '2018-06-26T05:00:31.000Z'
author: Rich Tabor
summary: 'The Block Unit Test WordPress plugin simplifies testing Gutenberg’s core blocks, ensuring your themes are ready for the new block editor.'
tags:
  - Blocks
  - Gutenberg
published: true
type: blog
url: /block-unit-test
canonical: https://richtabor.com/block-unit-test
id: 621
---

There’s no better time to start exploring how each of our WordPress themes will interface with [Gutenberg](https://wordpress.org/plugins/gutenberg). So to help folks level-up their themes to support the new WordPress block editor, I built the [Block Unit Test WordPress plugin](https://wordpress.org/plugins/block-unit-test).

Testing every core block within Gutenberg — and every variation of every block — is no small task. As a founder of a pretty awesome [WordPress theme shop](https://themebeans.com) with over 20 active themes, I needed to employ a fast-paced methodology to testing, preparing my WordPress themes for Gutenberg. The [Block Unit Test WordPress Plugin](https://wordpress.org/plugins/block-unit-test) is built just for that purpose: to easily prepare WordPress themes for Gutenberg.

## Installing the Block Unit Test plugin

If you’re familiar with the [WordPress Theme Unit Test](https://codex.wordpress.org/Theme_Unit_Test), the Block Unit Test plugin is essentially the same kind of test — but for Gutenberg core blocks. To start, you will need to install [Gutenberg](https://wordpress.org/plugins/gutenberg) — at least until the new block editor is merged with core. Then, simply install the Block Unit Test plugin from the official [WordPress.org Plugin Directory](https://wordpress.org/plugins/block-unit-test).

![](https://i0.wp.com/rich.blog/wp-content/uploads/2023/01/f099a-block-unit-test-2.jpg?ssl=1&resize=1600%2C1400)

_The Block Unit Test page, created upon plugin installation._

Once downloaded and installed, the plugin will create a new page with every core block added. The test will also include different block alignment settings, variable columns, and nearly every variation of each Gutenberg block.

## Running the Block Unit Test

A good place to start is to compare each block within Gutenberg to what your WordPress theme is rendering on the front-end. Check for alignment issues, spacing, columns — the whole lot. And if you have custom WordPress theme styles loaded within the Gutenberg editor (which you should!), you’ll need to ensure every block displays the same within Gutenberg and on the theme’s front-end.

I wrote a primer all about [adding custom WordPress theme styling to Gutenberg](/add-wordpress-theme-styles-to-gutenberg/), if you need a refresher. Sure, it’s a lot of work to add WordPress theme styling to Gutenberg and to ensure blocks are displaying correctly on the front-end, but it really pays off when you, or your users, enjoy a seamless content-creation experience. And with the Block Unit Test plugin, it’s really not that bad.

## Contribute to the project

Extensible, adaptable, and open source — the Block Unit Test WordPress plugin source code can be found on [GitHub](https://github.com/thatplugincompany/block-unit-test). If you find a new Gutenberg block that needs to be added to the test, or discover it’s missing a block variation of sorts — let me know by [opening up an issue](https://github.com/thatplugincompany/block-unit-test/issues/new) on GitHub. Let’s work together to make more WordPress themes ready for Gutenberg, and therefore empower more folks to create beautiful content.

## Sitemap

[Full site index](/sitemap.md)