Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared Managed Cloud India
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Best lists Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Setup & site building · Guide

How to Use and Create Block Patterns

Short answer

A block pattern is a ready-made group of blocks you insert into a post or page and then edit with your own content. Open the inserter, click the Patterns tab, pick a pattern and click it, then change the text and images. To make your own, select blocks, open the three-dot menu, choose Create pattern, and turn Sync on if every copy should update together.

Key takeaways

  • A block pattern is a ready-made group of blocks you insert and edit with your own content.
  • WordPress 6.3 renamed reusable blocks to patterns and added custom patterns.
  • A synced pattern updates everywhere it is used; a plain pattern is a one-off starting layout.
  • Block patterns arrived in WordPress 5.5 and can be registered with code since then.
  • The Pattern Directory on WordPress.org holds free patterns to copy and paste.
  • Manage patterns from Appearance, then Editor, then Patterns.

What is a block pattern in WordPress?

A block pattern is a ready-made group of blocks you insert into a post or page and then fill with your own content.

WordPress.org's documentation defines block patterns as a collection of blocks that you can insert into posts and pages and then customize with your own content.

A pattern can hold a heading, a paragraph, buttons, an image and a cover block, arranged as one layout. Inserting it adds all of those blocks at once, already arranged.

Patterns save time on repeated layouts. A call-to-action band, a pricing table or a testimonial row takes one click to add, instead of building the same blocks from scratch each time.

Patterns also teach the editor. Opening a pattern shows how blocks combine to make a layout, which helps new users learn what the block editor can do.

What is the difference between patterns, synced patterns and template parts?

Patterns are one-off layouts, synced patterns update everywhere at once, and template parts belong to the site structure.

A plain pattern, sometimes called an unsynced pattern, is a starting layout. Once you insert it, the copy is yours to change, and edits do not affect other pages.

A synced pattern behaves like the old reusable block. WordPress.org's documentation says that with the Sync option on, the synced pattern will behave in exactly the same way as a reusable block, and editing it will update it anywhere it is used.

A template part is a piece of the site itself, such as a header or footer. It is managed in the Site Editor, not in a post, and it appears on every page that uses that template. Our guide to block themes vs classic themes explains how template parts fit into each theme type.

TypeSyncs across the site?Best for
Pattern (unsynced)NoA layout you will change on each page
Synced patternYesA notice, disclaimer or call to action that must match everywhere
Template partYesHeaders, footers and other site-wide structure

WordPress 6.3 renamed reusable blocks to patterns, as WordPress.org's documentation records. Old reusable blocks still work, and they now appear as synced patterns.

How do you insert a block pattern?

Open the block inserter, click the Patterns tab, and click the pattern you want.

Click the + icon in the top toolbar of the block editor. WordPress.org's documentation lists the steps: click the + icon, click the Patterns tab or Synced Patterns tab, then either click the pattern or drag it into your content.

Use the dropdown on the Patterns tab to pick a category, or click Explore to open a larger view of each pattern. Clicking a pattern inserts it where your cursor sits.

Some blocks carry their own patterns. The Social Icons block and the Query Loop block show patterns inside their own settings, so you can pick a layout without opening the main inserter.

After insertion, the pattern opens in content-only editing. In that mode you can change text and swap images, while the layout stays locked, which stops accidental changes to the design. Learn WordPress has a free lesson that walks through inserting and changing patterns with examples.

How do you edit a block pattern after inserting it?

Edit the text and images in place, or click Edit pattern to change the layout itself.

Once you insert a pattern, click any block inside it to edit its content the same way as any other block. You can also add more blocks to the pattern, or insert another pattern inside it.

To change the layout, select the pattern and click Edit pattern in the block inspector or on the Block Settings sidebar. That opens the full editing controls for each block inside.

WordPress.org's documentation notes that new blocks in WordPress 7.0 use content-only mode, which limits editing to basic content changes such as modifying text or swapping images.

If you only want one page to differ, detach the copy first. For a synced pattern, choose Detach to turn it into a regular block, and then edit it without affecting the other copies.

How do you create your own block pattern?

Select the blocks, open the three-dot menu, choose Create pattern, and name it.

Since WordPress 6.3, you can create your own patterns without a plugin. WordPress.org's documentation lists the steps: select the blocks, click the three-dot menu, click “Create pattern/reusable block”, enter a name, and click Create.

Give the pattern a clear name, such as “Product call to action” or “Opening hours”. A clear name is what you will search for later in the inserter.

Your patterns appear under Patterns > My Patterns in the inserter, or under the Synced Patterns section if you turned Sync on.

Build the pattern from blocks you know well. A Group block with a heading, a paragraph and a button inside makes a solid first pattern, and it is easy to reuse.

How do you create a synced pattern?

Create the pattern the same way, and turn the Sync option on before you click Create.

To synchronize patterns, turn on the Sync option when you create it. WordPress.org's documentation says editing the pattern will then update it anywhere it is used.

A synced pattern suits content that must match on every page. Use it for a disclaimer, an offer banner, opening hours or a contact strip. If the pattern needs to show data from a custom field, block bindings connect a block to that field.

Saving a page that holds a synced pattern shows the pattern in the saving flow. The save updates the pattern everywhere it is used, even in other posts and pages.

To change one copy only, detach it. After inserting the synced pattern, choose Detach pattern from the block options, and the copy becomes a regular block you can edit on its own.

How do you find more patterns in the Pattern Directory?

Browse the Pattern Directory on WordPress.org, copy a pattern, and paste it into your page.

The Pattern Directory holds patterns shared by the community, sorted by category. Search for the layout you need, such as a hero section, a gallery or a call to action.

After you find one you like, select Copy, and it is saved to your clipboard. Return to your page or post and use Paste to add the pattern to your content.

WordPress.org's documentation warns that the images in directory patterns are referenced from an external source, not added to your Media Library. Replace them with your own images, or use the “Upload external image” button to save them locally.

WordPress also loads some patterns remotely from the official Pattern Directory. Theme authors can switch that off with the should_load_remote_block_patterns filter, as the Theme Handbook explains.

How do you add patterns to a theme with code?

Add pattern files to the theme's /patterns folder, or register them with register_block_pattern().

The Theme Handbook describes two methods, and recommends the /patterns folder except in some edge cases. WordPress reads any pattern file in that folder and registers it automatically, if the file has a valid header.

A pattern file header holds the metadata. The handbook lists the keys you can set: Title, Slug, Categories, Description, Viewport Width, Inserter, Keywords, Block Types, Post Types and Template Types.

For most patterns, add at least the Title, Slug and Categories fields. A file can look like this:

<?php
/**
 * Title: Hero
 * Slug: themeslug/hero
 * Categories: featured
 */
?>
<!-- Pattern code goes here. -->

The other method is PHP. The register_block_pattern() reference shows that the function takes a namespaced pattern name and an array of properties, including title, content, description, categories and keywords.

Register patterns on the init hook, from your theme's functions.php file. The handbook gives this example:

add_action( 'init', 'themeslug_register_patterns' );
function themeslug_register_patterns() {
    register_block_pattern( 'themeslug/hero', array(
        'title'      => __( 'Hero', 'themeslug' ),
        'categories' => array( 'featured' ),
        'source'     => 'theme',
        'content'    => '<!-- Block pattern goes here. -->'
    ) );
}

Use one method per pattern. The handbook notes that you can mix both methods in a theme, but a single pattern must be registered with only one of them. Developers who want patterns to show live post data can read our guide to the Block Bindings API, which connects blocks to that data.

How do you manage, rename or delete patterns?

Manage patterns from the Site Editor, under Appearance, then Editor, then Patterns.

Open Appearance > Editor and click Patterns to see your custom patterns. The WordPress.org documentation says you can Rename, Duplicate, Export as JSON, and Delete each pattern from its Actions menu.

Click a pattern, then click Edit to open it in a focused editing view. That is where you change the shared content of a synced pattern.

To remove a pattern from the inserter without deleting it, hide it with code. The Theme Handbook shows unregister_block_pattern() for one pattern, and remove_theme_support( 'core-block-patterns' ) to remove all core patterns at once.

WordPress registers several default pattern categories, including featured. Theme authors can add their own categories to group patterns by purpose.

What mistakes should you avoid?

Avoid the five mistakes that cause most pattern trouble.

First, do not edit a synced pattern when you mean to change one page. Edits update every copy, so detach the copy first if only one page should differ.

Second, do not use a synced pattern for content that changes per page. A testimonial with a different name on each page belongs in a plain pattern, not a synced one.

Third, do not leave directory images hosted elsewhere. They can change or vanish, so upload them to your own Media Library.

Fourth, do not register the same pattern twice. Pick the /patterns folder or register_block_pattern(), and use only one method for each pattern.

Fifth, do not forget to name patterns clearly. A pattern called “Pattern 1” is hard to find later, while “Footer call to action” is easy to pick from the inserter.

Frequently asked questions

If I edit a pattern, will it change every page that uses it?

No. Inserting a pattern copies its blocks into your page, and later changes to the original do not affect it. Only synced patterns stay linked, so editing one updates every page that uses it. To change one copy, detach it first.

What happened to reusable blocks in WordPress?

WordPress 6.3 renamed reusable blocks to patterns. Your old reusable blocks still work, and they now appear as synced patterns in the inserter. The creation flow is the same: select blocks, open the three-dot menu and choose Create pattern.

Can I use block patterns with any theme?

Yes. Themes can ship patterns in a /patterns folder, and plugins can register them with register_block_pattern(). The Pattern Directory also offers free patterns you can copy and paste into any site, whatever theme you use.

How do I edit a pattern I created earlier?

Open Appearance, then Editor, then Patterns, and click the pattern to edit it. Changes save to the pattern itself, and every synced copy updates. For a plain pattern, edit the copy on the page instead, because the original is only a starting layout.

Can I change the text inside a pattern without breaking its layout?

Yes, for headings, paragraphs, buttons and images in many cases, through content-only editing. Click into the pattern and change the text or swap the image. To change the layout itself, click Edit pattern to open the full block controls.

Where can I find more block patterns?

The Pattern Directory on WordPress.org holds free patterns in many categories, and your theme may ship its own. You can also build one from blocks you already use, or ask a developer to register a custom pattern in the theme.

Sources

  1. Block Patterns WordPress.org
  2. Registering Patterns WordPress Developer Resources
  3. register_block_pattern() WordPress Developer Resources
  4. Block Patterns in WordPress 5.5 Make WordPress Core
  5. Pattern Directory WordPress.org
  6. Using Block Patterns Learn WordPress

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

WPLegible editors

Researched from the primary sources listed above and checked against our editorial rules. About the site · How we test