WordPress Patterns and Synced Patterns

Browse manual On this page × Wordpress Manual WordPress Fundamentals Toggle WordPress Fundamentals section What Is WordPress? WordPress.org vs WordPress.com What Can You Build with WordPress? How WordPress Works WordPress Core, Themes, Plugins and Content Essential WordPress Terminology How to Plan a WordPress Website Domains, Hosting, DNS and HTTPS Explained How to Choose WordPress Hosting…

3 min read

  • Article
  • Beginner
  • 3 minutes read
  • Reviewed August 3, 2026

A WordPress pattern is a preconfigured group of blocks that can be inserted as a reusable design.

Patterns help teams create consistent layouts without rebuilding the same arrangement from scratch. They can be supplied by WordPress, a theme, a plugin or the website itself.

The most important distinction is whether inserted copies remain independent or synchronized.

Unsynced Patterns

An unsynced pattern acts as a starting layout.

When you insert it, WordPress copies its blocks into the current post, page or template. You can then edit that copy independently. Later changes to the original pattern do not update existing copies.

Use unsynced patterns for:

  • Hero sections with replaceable content.
  • Pricing layouts.
  • Testimonial arrangements.
  • Article callouts.
  • Contact sections.
  • Standard page structures that need local variation.

They provide consistency at creation time without creating a permanent dependency.

Synced Patterns

A synced pattern is a reusable entity whose content remains connected across every placement.

Editing it in one location updates all uses. Synced patterns replaced the terminology previously used for reusable blocks.

Use them for content that should remain identical, such as:

  • A current promotional notice.
  • A legal disclosure.
  • A repeated subscription call to action.
  • Shared contact details.
  • A centrally managed announcement.

Because one edit can affect many pages, assign permissions and review processes appropriately.

Overrides and Controlled Variation

Modern WordPress can allow selected blocks inside a synced pattern to be overridden per instance while preserving the shared design.

This supports components such as team cards or calls to action where the layout remains governed but text or images vary.

Availability and behavior depend on WordPress and block support, so test the intended workflow before relying on it across a large site.

Theme and Directory Patterns

Themes can register patterns as part of their design system. WordPress can also surface patterns from the Pattern Directory.

Theme patterns should use broadly available blocks or clearly document dependencies. A pattern containing blocks from an unavailable plugin cannot be reproduced correctly.

Patterns can also be categorized to help editors find appropriate layouts.

Patterns vs Templates

A pattern is a group of blocks that can be inserted into content or templates.

A template defines the structure used to display an entire page type. It may include patterns, but it has a different responsibility.

For example, a Single Post template can contain a header template part, Post Title, Post Content and a related-content pattern.

Patterns vs Template Parts

Template parts represent repeated structural regions used by templates, especially headers and footers.

They participate in the theme template system and are edited within the site-design workflow. Patterns are more general reusable block compositions.

The WordPress interface may list template parts within the Patterns area, but the concepts remain distinct.

Planning a Pattern Library

A useful library should be curated rather than enormous.

Define:

  • Naming conventions.
  • Categories.
  • Intended context.
  • Required blocks and plugins.
  • Whether the pattern is synced.
  • Which content can be overridden.
  • Responsive and accessibility expectations.
  • Ownership and review process.

Remove outdated or duplicated patterns so editors can find the approved choice quickly.

Frequently Asked Questions

Do changes to a normal pattern update existing pages?

No. Unsynced patterns are copied when inserted. Existing copies remain independent.

Are synced patterns the same as template parts?

No. Both are reusable, but template parts belong to the template structure while synced patterns are reusable block content.

Can a pattern contain custom blocks?

Yes, but those blocks must be available wherever the pattern is used.

Continue Learning

Previous: Understanding WordPress Blocks

Next: Global Styles and theme.json