Block Patterns

Block Patterns

Aegis ships with over 145 block patterns organized across 30 categories. Block patterns are pre-designed layouts that you can insert into any page or template and customize to fit your content.

Understanding Block Patterns

A block pattern is a pre-arranged group of blocks that forms a complete section or layout component. Patterns accelerate page building by providing professionally designed starting points that you can modify freely after insertion.

Inserting a Pattern

From the Block Inserter

1. Click the Block Inserter (+) in the top toolbar of the editor.
2. Switch to the Patterns tab.
3. Browse the categories in the dropdown or search by keyword.
4. Click a pattern to insert it at the current cursor position.

From the Slash Command

1. Type / in an empty block to open the quick inserter.
2. Start typing a pattern name or keyword.
3. Select the pattern from the results.

From the Pattern Explorer

1. In the Patterns tab of the block inserter, click Explore all patterns.
2. Browse the full-screen pattern explorer with previews.
3. Click a pattern to insert it.

Pattern Categories

Aegis organizes its patterns into 30 categories:

Category	Description	Typical Use
404	Page not found layouts	Error pages
About	About sections and pages	Company info, bios
Author	Author profile and bio layouts	Blog author pages
Blog	Blog listing and post layouts	Blog pages, post grids
Commerce	E-commerce product sections	Shop pages, product highlights
Contact	Contact forms and information	Contact pages, footer sections
CTA	Call-to-action sections	Conversion sections
Event	Event listings and details	Event pages, calendars
FAQ	Frequently asked questions	Support pages
Feature	Feature showcases and grids	Product features, services
Footer	Footer layouts	Site footers
Header	Header layouts	Site headers
Hero	Hero banners and landing sections	Page headers, landing pages
Hidden	Utility patterns not shown in inserter	Internal theme use
Library	General-purpose reusable sections	Various page sections
Logos	Logo grids and client showcases	Trust signals, partnerships
Modal	Modal and popup layouts	Overlays, announcements
Newsletter	Email signup sections	Lead generation
Notice	Alert and notification banners	Announcements, warnings
Page	Full page layouts	Complete page designs
Portfolio	Portfolio and project showcases	Creative portfolios
Pricing	Pricing tables and comparisons	SaaS, service pricing
Product	Product detail sections	Product showcases
Slider	Carousel and slider layouts	Image galleries, testimonials
Stats	Statistics and number highlights	Achievement sections
Team	Team member grids and profiles	About pages
Template	Template-level layouts	Template building
Testimonial	Reviews and testimonial sections	Social proof
Timeline	Chronological content layouts	Company history, roadmaps
Utility	Helper patterns and spacers	Layout utilities

Customizing Patterns After Insertion

Once inserted, a pattern becomes regular blocks that you can fully customize:

• Change text — Click any text and edit directly.
• Replace images — Click an image and use the toolbar to replace it.
• Modify colors — Select a block and change its color settings in the sidebar.
• Adjust spacing — Use the block spacing controls to change padding and margins.
• Rearrange blocks — Drag blocks to reorder them within the pattern.
• Remove blocks — Delete any block you do not need.
• Add blocks — Insert additional blocks into the pattern structure.

Pattern Design Principles

All Aegis patterns are built following these principles:

• Responsive — Every pattern adapts gracefully from mobile to desktop viewports.
• Accessible — Patterns use semantic markup, proper heading hierarchy, and ARIA attributes where needed.
• Theme-aware — Patterns use design tokens (CSS custom properties) from theme.json, so they automatically adapt to style variations.
• Lightweight — Patterns use only core blocks and Aegis custom blocks, with no external dependencies.

Hidden Patterns

The Hidden category contains patterns used internally by the theme for template composition. These patterns do not appear in the block inserter but can be accessed programmatically or found in the patterns/ directory.

WooCommerce Patterns

Patterns in the Commerce and Product categories are designed to work with WooCommerce. They include:

• Product grids with add-to-cart buttons
• Featured product showcases
• Sale banners and promotional sections
• Product category navigation

These patterns require WooCommerce to be active for full functionality.

Creating Your Own Patterns

Synced Patterns (formerly Reusable Blocks)

1. Select the blocks you want to save as a pattern.
2. Click the Options menu (three dots) in the block toolbar.
3. Select Create pattern.
4. Name the pattern and optionally assign a category.
5. Choose whether the pattern should be Synced (changes propagate everywhere) or Not synced (independent copies).

Registering Custom Patterns (Developers)

Developers can register patterns by creating PHP files in the patterns/ directory:

<?php
/**
 * Title: My Custom Pattern
 * Slug: aegis/my-custom-pattern
 * Categories: feature
 * Description: A custom feature section.
 */
?>
<!-- wp:group {"align":"wide"} -->
<div class="wp-block-group alignwide">
    <!-- Block markup here -->
</div>
<!-- /wp:group -->

Browsing Patterns by Page Type

When building specific types of pages, look at these categories:

Page Type	Recommended Categories
Homepage	Hero, Feature, Testimonial, CTA, Logos, Stats
About Page	About, Team, Timeline, Stats
Services	Feature, Pricing, FAQ, CTA
Contact	Contact, Newsletter
Blog	Blog, Author
Portfolio	Portfolio, Slider
Shop	Commerce, Product, Pricing
Landing Page	Hero, Feature, Testimonial, CTA, Pricing

Next Steps

• pattern-reference — Complete list of all pattern categories with descriptions.
• style-variations — See how patterns adapt to different style variations.
• custom-blocks — Learn about the custom blocks used in patterns.
• templates — Use patterns to build custom templates.