WordPress Patterns vs. Template Parts – What’s the Difference?

You edited the logo in your header. You hit save. You opened your About page in another tab and the old logo is still sitting there.

Welcome to the most confusing corner of the new WordPress editor, and the heart of the WordPress patterns vs template parts mix-up.

The first time this happened to me, I thought the editor was broken. I’d been clicking around in something labeled “Header” for 20 minutes, tweaking the logo size and the menu colors. None of it carried over to other pages.

It turned out I wasn’t editing the actual header. I was editing a copy of the header that the editor calls a Pattern.

Once you understand the difference between WordPress patterns vs template parts, the whole block theme system makes sense. Until you do, you’ll keep editing the wrong thing and wondering why nothing works.

WordPress patterns vs template parts: Why do both exist?

Both came along with the block editor and Full Site Editing. The idea was to give you reusable layouts so you don’t have to rebuild a hero section or a footer from scratch every time.

The trouble is they look almost identical when you click on them. Both show up in the same sidebar. Both have a fancy outline around them in the editor and can be inserted with the “+” button.

But they behave in totally opposite ways once you save.

I see this confusion in the WordPress.org forums every week. Someone edits their header, saves, and then panics when other pages don’t update. The fix isn’t a plugin or a setting. It’s understanding which of these two things they were editing.

If you used to edit your header through the old Customizer and you’re wondering where the WordPress Customizer went, this whole Patterns/Template Parts split is what replaced it.

What is a WordPress Pattern?

A Pattern is a saved block layout that you stamp onto a page or post. Once you stamp it, the copy on that page becomes its own thing. Edits don’t sync back to the original.

Think of a rubber stamp and an ink pad. You press the stamp on page 1, you get a shape. You press it on page 2, you get the same shape.

But if you go back to page 1 and draw a mustache on the shape, page 2’s shape doesn’t grow a mustache too. They’re independent the moment they hit the paper.

That’s a Pattern. It’s a starting point you customize per page.

You’ll find Patterns in 2 places:

• In any post or page editor, click the “+” button and switch to the Patterns tab
• In the Site Editor, look in the left sidebar under Patterns

The WordPress.org pattern directory has over 800 free patterns you can copy in too. Most block themes ship with 20-40 of their own.

What is a Template Part?

A Template Part is a block layout that gets referenced (not copied) across every page that uses it. Edit it once and the change shows up everywhere.

The mirror analogy is the one that finally made it click for me. Imagine a mirror hanging in your hallway, and you put a sticker on the glass. Anyone walking past sees the sticker.

There’s only 1 sticker, but it shows up in every reflection. That’s a Template Part.

Your header is a Template Part. Your footer is a Template Part. Sometimes your sidebar is too. The whole point is that they should look identical on every page of your site, so they’re stored once and pulled in dynamically wherever they’re needed.

You’ll find Template Parts in the Site Editor only:

• Go to Appearance > Editor
• Click Patterns in the left sidebar
• Scroll down to the Template Parts section

If you’re on a classic (non-block) theme and you’re not sure whether to even touch Template Parts, my take on whether it’s safe to use block templates on an older theme covers when to opt in.

Patterns vs Template Parts: the 3-line summary

If you remember nothing else from this article, remember these 3 lines:

• Pattern = stamp. Inserted once per page. Edits stay local to that page.
• Template Part = mirror. Referenced everywhere it’s used. Edits show up site-wide.
• Both live under “Patterns” in the WordPress UI. Yes, that naming is confusing.

The naming overlap is genuinely the worst part. WordPress decided to put Template Parts inside the Patterns sidebar, which means when you click “Patterns” in the Site Editor, you see both kinds mixed together.

The header is technically called “Header” and lives in the Template Parts section. The hero block you built last week is called “Hero” and lives in the My Patterns section. Same sidebar, totally different behavior.

When should I use a Pattern?

Patterns are for layouts that change per page. Anything you’ll customize after dropping it in.

Real examples from sites I’ve worked on:

• A hero section with different headlines on the homepage, About page, and Services page
• Pricing tables where each product has its own copy and feature list
• Testimonial layouts where the quote and photo change per case study
• Call-to-action banners with different offers on different pages

The key question to ask: “Do I want this to look the same on every page, or different?” If different, use a Pattern.

When I built my first block theme site, I made the mistake of turning every section into a Template Part because I liked how organized it felt. Then I needed the homepage hero to say something different from the About page hero. I had to detach the Template Part and rebuild it as a Pattern. Save yourself the cleanup and start with a Pattern when the content varies.

When should I use a Template Part?

Template Parts are for sections that should look identical across every page. The classic 3 are header, footer, and sidebar.

Use a Template Part when:

• The header logo and menu need to match on all 47 pages of your site
• The footer copyright and social links should never drift between pages
• The sidebar with your newsletter signup needs to stay consistent across blog posts
• An announcement banner should appear (and disappear) sitewide with one edit

The single biggest reason to use a Template Part is the dread of “I changed my logo but only the homepage updated.” If you’re editing site-wide branding, you want a Template Part. Period.

If you’ve ever fought with global template changes that rolled out beyond what you expected, the fix is to scope your edits more carefully – detach the block on the one page that needs to differ, and leave the shared Template Part alone. And if your footer Template Part is rendering empty, that’s usually because your old widget areas didn’t carry over when the theme switched to block-based templates.

How do I tell which one I’m currently editing?

This is the trick that saves the most pain. WordPress shows you what you’re editing, but the label is small and easy to miss.

When you click on a block group in the editor, look at the top of the right sidebar. Under Block settings, you’ll see a small label that says either “Pattern” or “Template Part.” That’s your answer.

There’s a second spot to check. In the block toolbar that floats above the selected block, the icon at the far left tells you the block type.

A Pattern shows a small grid icon. A Template Part shows a layered rectangle icon. They’re subtle but consistent once you know what you’re looking for.

If you’re in the Site Editor and the breadcrumb at the bottom says “Header” or “Footer,” you’re almost certainly inside a Template Part. If the breadcrumb says “Group” or “Cover,” you’re probably inside a Pattern that was inserted into a page.

Can I convert a Pattern to a Template Part (or vice versa)?

Yes, both directions work, with one important catch.

Pattern to Template Part: Click the Pattern in the editor. Open the block toolbar (the 3-dot menu). Look for “Create template part.” You’ll get a prompt to name it and pick the area (Header, Footer, or General). Once converted, that block becomes a single source of truth and edits propagate.

Template Part to Pattern: Click the Template Part. Open the 3-dot menu. Look for “Detach” or “Detach blocks from template part.” This breaks the mirror connection. The blocks stay where they are, but they’re now just regular blocks on that page. No sync.

The catch with detaching: it’s a one-way street. Once detached, your edits become local. If you detach the header on a single page and then update the actual Template Part later, that one page won’t get the update. Detach only when you genuinely want a page to break from the site-wide layout.

I usually recommend going Pattern first, Template Part later. Build the section as a Pattern, see if you actually want it everywhere, then convert if it makes sense. It’s much safer than starting with a Template Part and accidentally syncing changes you didn’t want to share.

If all this Site Editor talk has you missing the old days, my comparison of Classic Editor vs Gutenberg in 2026 walks through whether the classic interface is still a sensible choice. And if you’re wondering where the WordPress Customizer went, that one covers what replaced it on block themes.

FAQs

What is the primary use of WordPress Patterns?

I use Patterns for content layouts and design sections, like dropping a pre-designed “Call to Action” or a “Testimonial” block directly into a blog post without building it from scratch.

What is the primary use of Template Parts?

Template Parts define the global structure of my site. I use them for areas that stay the same across every page, like my Header, Footer, or main Sidebar.

Can WordPress Patterns be synced like Template Parts?

Yes, they can. When I want a piece of content to update everywhere at once, I create a “Synced Pattern.” If I want independent copies, I leave it unsynced. Template parts, on the other hand, are always synced by default.

Can I use Patterns and Template Parts together?

Yes, I do this all the time. I frequently use a pre-designed Pattern as the starting point inside a Template Part – like dropping a “Header Pattern” directly into my Header Template Part to save time.

The mental model that actually works

Once you stop thinking of Patterns and Template Parts as 2 versions of the same thing, the editor stops feeling broken.

Patterns are stamps. They give you a starting point you customize per page. Template Parts are mirrors – 1 layout that shows up in every reflection.

Both have a place. The trick is knowing which one you’re clicking on before you start editing.

Next time your header logo refuses to update across your site, you’ll know exactly where to look. Open Appearance > Editor, click Patterns, scroll to Template Parts, and edit the Header from there. That’s the mirror. That’s the one that actually changes everything.