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

Synced Patterns (Reusable Blocks) in WordPress

Short answer

A synced pattern is a group of blocks you save once and reuse across your site, and editing it in one place updates every page that uses it at once. WordPress 6.3 renamed reusable blocks to synced patterns, and you create one by selecting blocks, opening the block menu, and choosing Create pattern with the Sync option on. Use synced patterns for content that must stay identical everywhere, such as a call to action or a legal notice.

Key takeaways

  • WordPress 6.3 renamed reusable blocks to synced patterns.
  • Editing a synced pattern updates every page that uses it at once.
  • An unsynced pattern copies its blocks into the page and never changes again.
  • You can Rename, Duplicate, Export as JSON, and Delete patterns from the Patterns screen.
  • Pattern overrides, added in WordPress 6.6, let Heading, Paragraph, Button, and Image blocks differ per page.

What is a synced pattern?

A synced pattern is a group of blocks you save once and reuse across your site, with every copy updating when you edit the original.

WordPress 6.3 renamed reusable blocks to patterns. The WordPress.org Block Patterns guide states that a synced pattern behaves in exactly the same way as a reusable block.

Patterns arrived in WordPress 5.4 as pre-configured groups of blocks, according to the Theme Handbook introduction to patterns. A pattern can be a button row, a call to action, or a whole section.

Think of a synced pattern as one master copy. Each page that uses it points at that copy, so one edit reaches every page.

How are synced patterns different from unsynced patterns?

A synced pattern updates everywhere when you edit it, while an unsynced pattern copies its blocks into the page and never changes again.

WordPress offers two kinds of patterns. The Theme Handbook introduction explains that synced patterns remain unchanged no matter where they are used, while unsynced patterns create a new instance of the blocks on insert.

An unsynced pattern is a starting layout. Insert it, adapt the text and images for that page, and later edits to the pattern will not touch the pages that already use it.

Template parts are a third option for repeated theme areas such as headers and footers. The Block Editor Handbook guide to propagating updates advises using reusable blocks or template parts for content you want to update later, not plain patterns.

TypeEdit once updates everywhere?Best for
Synced patternYesShared content: calls to action, notices, hours
Unsynced patternNo, only future insertsStarting layouts you adapt per page
Template partYesHeaders, footers, repeated theme areas

How do you create a synced pattern?

Select the blocks, open the block menu, choose Create pattern, name it, turn on Sync, and click Create.

  1. Select the block or blocks you want to turn into a pattern.
  2. Click the three-dot menu that opens the additional settings.
  3. Click Create pattern/reusable block.
  4. Enter a name for the pattern.
  5. Turn on the Sync option so editing the pattern updates it anywhere it is used.
  6. Click Create.

The steps come from the WordPress.org Block Patterns guide, which notes that you can create your own patterns since WordPress 6.3. Give the pattern a clear name, such as Pricing callout, so you can find it later.

Your new pattern appears under Patterns, then My Patterns, in the block inserter, according to the same guide.

How do you insert a synced pattern?

Click the add-block button, open the Patterns or Synced Patterns tab, and click the pattern you want.

The Block Patterns guide lists the steps: click the + icon in the top toolbar, click the Patterns tab or the Synced Patterns tab, then click the pattern or drag it into your content.

You can also copy patterns from the Block Pattern Directory. The same guide says to search the directory, click Copy, then paste the pattern into your page.

Patterns from the directory are unsynced by default, so they behave like starting layouts. Turn a copied pattern into a synced one only when you want every use to stay identical.

Some blocks suggest patterns of their own. A Make WordPress Core post on contextual patterns explains that the block inserter suggests patterns for the block you are working with, and you can also reach them from the quick inserter and the transform menu of individual blocks.

How do you edit a synced pattern?

Edit the pattern from any page that uses it, or from Appearance > Editor > Patterns, and every use updates at once.

When you insert a synced pattern, WordPress limits editing to content only: you can change text and swap images, but not the layout. The Block Patterns guide says this content-only mode keeps the design safe from accidental changes.

To change the layout, click the Edit pattern button in the block toolbar or the Block Settings sidebar. That opens the pattern itself, where you can move, add, or remove blocks.

When you save the post or page, WordPress warns you that the pattern is about to change everywhere it is used. The guide notes that saving updates the pattern anywhere it is used, even in other posts or pages.

Content-only mode for new blocks arrived in WordPress 7.0, according to the changelog on the Block Patterns guide, which was updated on 31 August 2026.

How do you detach a synced pattern?

Select the pattern, open the block menu, and click Detach to turn it into regular blocks that no longer follow the pattern.

Detaching copies the pattern blocks into the page as ordinary blocks. Later edits to the pattern will not touch the detached copy, and edits to the copy will not touch the pattern.

Detach when one page needs its own version of shared content. The Block Patterns guide describes Detach as the way to edit a block without affecting your already saved synced pattern.

Detaching cannot be undone with one click. If you detach by mistake, undo the change at once or re-insert the pattern.

How do you manage and organize patterns?

Open Appearance > Editor > Patterns in a block theme, or Appearance > Patterns in a classic theme, to list every pattern.

The Theme Handbook introduction places pattern management on the Appearance > Editor > Patterns screen. On a classic theme, the same screen sits under Appearance > Patterns as of WordPress 6.5.

From the Actions menu of each pattern you can Rename, Duplicate, Export as JSON, and Delete it, according to the Block Patterns guide. Export as JSON is handy for moving a pattern to another site.

Our comparison of block themes with classic themes explains which kind of theme you run, since the Patterns screen sits in a different place for each.

Give patterns clear names and delete the ones you no longer use. A pattern library with twenty near-identical entries is slower to use than one with five clear ones.

What should you use synced patterns for?

Use synced patterns for content that must stay identical everywhere, such as a call to action, opening hours, or a legal notice.

Good fits are a newsletter signup box, a pricing note, a disclaimer, and a contact strip at the end of posts. One edit updates them all.

Do not use a synced pattern for a one-off layout. An unsynced pattern is the better pick when each page will adapt the design, and our comparison of Gutenberg with page builders covers the layout tools around patterns.

The Learn WordPress intro to block patterns workshop shows the same idea: patterns are predefined groups of blocks meant to be customized, with placeholder text and images you replace with your own.

What are pattern overrides?

Pattern overrides let selected blocks inside a synced pattern show different content on each page, while the layout and style stay in sync.

WordPress 6.6 added overrides. The WordPress 6.6 release page says overrides let you customize content in each instance of a synced pattern while keeping a consistent style, and that you can set them for Heading, Paragraph, Button, and Image blocks.

To use one, open the pattern, select a supported block, open Advanced in the block settings sidebar, and click Enable overrides. Then give the override a name.

Overrides suit a staff card with the same layout but a different name on each page, or a pricing table with the same design but different prices. The shared structure still updates everywhere when you edit the pattern.

What mistakes should you avoid?

Do not sync content that should differ per page, do not edit a synced pattern without checking where it is used, and do not delete a pattern that is still live.

  • A synced pattern with a page-specific heading will change that heading on every page. Use an unsynced pattern or an override instead.
  • Before you edit a pattern, check which pages use it. A small text change can appear in places you forgot about.
  • Deleting a pattern removes it from the library, and pages that used it lose their content. Duplicate it first if you are unsure.
  • Patterns do not exist in the classic editor. Our guide to going back to the classic editor explains the trade-off if you switch away from blocks.
  • If a pattern breaks the editor, our guide to fixing the editor error walks through the recovery steps.

Frequently asked questions

Can I use synced patterns in a classic theme?

Yes. Classic themes gained the Patterns screen under Appearance > Patterns as of WordPress 6.5. The editing experience is the same, though template parts and the Site Editor need a block theme. Check which theme type you run before you plan a pattern library.

What happens to a synced pattern when I change themes?

Your own patterns stay on the site when you change themes. Patterns that shipped inside the old theme go with it, so export your own patterns as JSON before you switch, so you can import them again.

Can I share a synced pattern with another site?

Yes. Open the Patterns screen, use Export as JSON on the pattern, then import the file on the other site from the same screen. The pattern arrives with its blocks and settings, and you can sync it again there.

Why can I only edit text inside a synced pattern?

WordPress limits an inserted synced pattern to content-only editing, so you can change text and swap images but not the layout. Click Edit pattern in the block toolbar or sidebar to change the layout itself. Content-only mode for new blocks arrived in WordPress 7.0.

Do synced patterns work with page builders?

Synced patterns are a block editor feature, so they work in the block editor and in block themes. Page builders such as Elementor have their own saved templates that do the same job. Use patterns for block content and your builder templates for builder content.

Sources

  1. Block Patterns WordPress.org Documentation
  2. Introduction to Patterns WordPress Developer Resources
  3. Propagating updates for block types WordPress Developer Resources
  4. WordPress 6.6 WordPress.org
  5. Intro to Block Patterns Learn WordPress
  6. Contextual patterns for easier creation Make WordPress Core

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