Skip to main content



Block Patterns are predefined block layouts, ready to insert and tweak.

You can check the WordPress documentation on this subject.

Patterns are (as we understand them) the same thing as block variations. The main difference is that you can provide full layouts with patterns, as described in this chapter. You can also provide the full page layouts with our variations.

This means that the only differences between our variations and block patterns are:


  • Variations provide data using our manifest.json file (the rest is handled using JavaScript).
  • Variations appear in the editor next to the static blocks.


  • Patterns are registered using PHP.
  • Patterns appear in the editor inside the special tab for patterns.

We will soon provide WP-CLI command to automaticity create block patterns, boilerplate class, for you to use.

Remove all core patterns

If you don't use core blocks, core patterns won't work. Don't confuse your users and remove them (but feel free to add new patterns based on your own custom blocks!)

To remove all core patterns add this code to you src/Blocks/Blocks.php class.

Filter goes in the register method:

// Remove block patterns.
add_filter('block_editor_settings', [$this, 'removeCorePatterns']);

Callback method:

* Remove core block patterns
* @param array $settings Array of block editor settings to filter out.
* @return array Filtered array.
public function removeCorePatterns(array $settings): array
$settings['__experimentalBlockPatterns'] = [];

return $settings;