wp-block-patterns

Create and register WordPress block patterns with PHP and pattern files.

14|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/wpgaurav/WordPress-skills --skill wp-block-patterns
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-block-patterns
Source: https://github.com/wpgaurav/WordPress-skills/tree/main/skills/wordpress/wp-block-patterns
Command: npx skills add https://github.com/wpgaurav/WordPress-skills --skill wp-block-patterns

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

WordPress theme and plugin developers often struggle to organize and reuse layout code. This skill enables creating, registering, and organizing block patterns (file-based and synced) to streamline design systems.

Core Features & Use Cases

  • Create pattern files in your theme's patterns directory and register them with a slug.
  • Categorize, discover, and reuse patterns across posts and templates, including synced patterns that update globally.
  • Use pattern overrides and pattern categories to build a scalable pattern library for themes and sites.

Quick Start

Create a new pattern file under your theme's patterns directory, register it with a slug in your PHP code, and insert it into a page or template.

Frequently Asked Questions about wp-block-patterns

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I register custom WordPress block patterns in my theme?

To register custom WordPress block patterns, create pattern files in your theme's patterns directory and register them using PHP with a specific slug. This enables a scalable, reusable layout library for site development.

What are synced patterns in WordPress and how do they update globally?

Synced patterns in WordPress are reusable block layouts that update globally across all pages and templates when modified. They streamline design systems by ensuring layout consistency without manual edits on every page.

Does WordPress 6.3 support pattern overrides for file-based patterns?

Yes, WordPress 6.3+ supports pattern overrides for file-based patterns. This feature allows specific content within synced patterns to be customized on individual instances while maintaining the global layout structure.

How do I categorize Gutenberg block patterns for better discovery?

You categorize Gutenberg block patterns using pattern category management in PHP. This organizes your pattern library, making it easier to discover and reuse specific layout components across posts and templates.

What is the best way to build a scalable pattern library for theme development?

Building a scalable pattern library involves creating file-based patterns in your theme directory and using PHP registration with categories and synced patterns. This ensures consistent site layouts and reusable design systems.

When should I use file-based block patterns instead of direct template code?

Use file-based block patterns when you need to reuse layout code across multiple pages or templates. They solve organization challenges by allowing you to categorize, discover, and sync layouts globally rather than duplicating code manually.