Block Patterns in WordPress are pre-designed, reusable block layouts that users can insert into posts, pages, or templates. They allow you to quickly add complex designs without building them block by block.
📌 1. What Are Block Patterns?
- Block Patterns: Templates of multiple blocks arranged in a specific layout.
- Purpose: Save time and maintain consistency across your site.
- Difference from Reusable Blocks:
- Patterns: Insert a copy of the layout; editing the inserted copy does not affect the original.
- Reusable Blocks: Remain linked, so editing one updates all instances.
✅ Tip: Use block patterns for standard sections like hero banners, testimonials, or call-to-action blocks.
📌 2. Registering a Custom Block Pattern
You can register block patterns via a plugin or your theme using the register_block_pattern() function inside an init action.
🔹 Example: CTA Hero Pattern
<?php
/**
* Plugin Name: Training Patterns
*/
add_action( 'init', function () {
register_block_pattern(
'training/cta-hero',
[
'title' => __( 'CTA Hero', 'training' ),
'description' => __( 'A hero section with heading, text and button.', 'training' ),
'content' => '<!-- wp:group {"align":"full"} -->
<div class="wp-block-group"><!-- wp:heading --><h2>Start Learning Today</h2><!-- /wp:heading -->
<!-- wp:paragraph --><p>Build your first WP project in minutes.</p><!-- /wp:paragraph -->
<!-- wp:buttons --><div class="wp-block-buttons"><!-- wp:button --><div class="wp-block-button"><a class="wp-block-button__link">Get Started</a></div><!-- /wp:button --></div><!-- /wp:buttons --></div>
<!-- /wp:group -->',
'categories' => [ 'cta' ]
]
);
});Explanation:
register_block_pattern()registers a new pattern.title→ Name displayed in the block inserter.description→ Explains the purpose of the pattern.content→ HTML markup of the block layout.categories→ Helps users find the pattern in the inserter.
✅ Tip: Keep patterns simple and reusable; avoid including content that is overly specific to one page.
📌 3. Benefits of Block Patterns
- Consistency: Ensure uniform design across pages.
- Time-saving: Add complex layouts with a single click.
- Customizability: Users can modify the inserted copy freely.
- Plugin/Theme Integration: Patterns can be bundled with themes or plugins for instant layouts.
📌 4. Best Practices
- Categorize patterns logically (e.g., hero, CTA, testimonials).
- Include headings, buttons, and text placeholders instead of real content.
- Test patterns in multiple block editor contexts to ensure compatibility.
- Provide clear descriptions to guide users.
✅ Summary
Block patterns are a powerful tool in WordPress Full Site Editing to accelerate site building while maintaining design consistency.
- Patterns insert independent copies.
- Reusable blocks remain linked across multiple posts.
- Developers can register patterns using
register_block_pattern()and categorize them for easy access in the block inserter.
Mastering block patterns allows you to deliver professional layouts quickly without relying on custom code or multiple plugins.
