Documentation
Introduction
Welcome to The Block WordPress theme documentation! This guide is designed to help you get the most out of The Block theme by teaching you how to use its powerful block-based features and make the most of its built-in patterns. Whether you’re new to WordPress block themes or looking to streamline your workflow, this documentation will walk you through every essential step.
With The Block theme, your website is built using blocks-the fundamental units of content in WordPress. Blocks allow you to easily add, arrange, and customize everything from text and images to galleries and buttons, giving you complete control over the look and feel of your pages and posts. The Block theme is designed for simplicity and flexibility, enabling you to create visually stunning layouts without the need for complex templates or custom code.
Features
A key feature of The Block theme is its use of block patterns. Patterns are pre-designed combinations of blocks that you can insert with a click, saving you time and ensuring design consistency across your site. This documentation will show you how to:
- Add and customize individual blocks to build your content.
- Insert, modify, and create your own block patterns to speed up your design process and maintain a cohesive style.
- Understand the hierarchy and structure of block themes, so you can confidently organize your pages and posts.
By following this documentation, you’ll learn not only how to use the blocks and patterns provided by The Block theme, but also how to create your own custom patterns to match your unique vision. Let’s get started and unlock the full creative potential of The Block theme!
Patterns
In WordPress block-based themes, patterns (often called block patterns) are pre-designed, reusable collections of blocks that can be quickly inserted into any post, page, or template. Each pattern is essentially a layout made up of multiple WordPress blocks-such as headings, paragraphs, images, or buttons-arranged in a specific way to create visually appealing sections like testimonials, hero banners, call-to-actions, or entire page layouts. Patterns are designed to streamline the site-building process, allowing users to add complex layouts with just a few clicks and then customize them as needed, without starting from scratch each time.
There are two main types of patterns: regular patterns, which are independent copies that can be edited individually after insertion, and synced patterns (formerly reusable blocks), which update across all instances when edited. Patterns can be created directly in the WordPress editor, registered by theme or plugin developers using PHP, or added from the official Pattern Directory. For theme developers, patterns are a powerful tool to provide consistent, user-friendly designs and speed up development, while for users, they offer an easy way to build and customize content-rich layouts within the block editor.
Slider Pattern
The Block theme Slider Pattern is a responsive carousel pattern designed specifically for block-based WordPress themes. This pattern enables users to create carousels-also known as sliders-directly within the WordPress block editor, allowing for seamless integration with both desktop and mobile layouts. Users can add as many slides as needed, with each slide capable of containing any type of WordPress block, such as images, text, buttons, or even more complex layouts.
Pagination
Box Columns Pattern
The Box Column pattern is a streamlined block layout featuring three distinct columns, each designed to highlight a key feature. Within each column, there is space for an image, a title, and descriptive text, creating a visually balanced and informative section. This pattern offers a clear, organized way to present main features or services, making it an effective choice for showcasing essential content in a professional and engaging format.
Native Blocks
Designed for the latest WordPress capabilities, block themes give you the power to edit and personalize every part of your site, from navigation menus and headers to content and footers, all through intuitive block-based controls.
Easy to Use
Experience your site in real time as you add, edit, and rearrange content—with intuitive editing tools and seamless features to keep everything effortlessly organized. No plugins or coding needed. A full WYSIWYG experience.
Fast & Secure
Keeping your website on the latest version of WordPress with the built-in editor ensures it remains secure, current, and lightning fast. This setup provides a seamless experience for both site owners and visitors.
Animated Logos Pattern
The Animated Logos pattern is designed to showcase a series of partner or brand logos in a visually engaging, continuously looping carousel. This pattern displays multiple logo images that scroll or animate in an infinite loop, ensuring ongoing visibility for each brand or partner featured. The animation works seamlessly across desktop and mobile devices, providing a smooth, responsive experience. By presenting logos in an endless loop, the pattern effectively highlights affiliations, sponsors, or clients, making it ideal for building trust and demonstrating credibility on your website. You can easily add as many logos as needed, and the animation ensures that all logos receive equal attention without requiring user interaction.
Contact Person Pattern
The Contact Person pattern is a focused block layout designed to highlight an individual point of contact on your website. This pattern typically features the person’s name, their position or title within the organization, and a brief descriptive text. It also includes a clear call to action-such as a button or link-encouraging visitors to reach out, connect, or learn more. The Contact Person pattern is ideal for introducing team members, support representatives, or key contacts, making it easy for users to identify the right person to connect with and take the next step. Its clean, organized structure ensures that important contact information stands out and is easily accessible.

Luan Gjokaj
Design Engineer
Do you want to learn more about our themes?
Drop me an email, say hi!
Featured Columns Pattern
The Featured Columns Pattern is a visually distinctive block layout designed to highlight a sequence of steps or features in a clear, engaging way. It consists of multiple columns, each set against a light background that helps the section stand out from the rest of the page. Each column prominently displays a numbered counter-such as 1, 2, 3-to guide visitors through a process or showcase key points in a logical order. This combination of visual emphasis and structured numbering makes the pattern ideal for presenting step-by-step instructions, feature highlights, or any content that benefits from a clear, sequential layout. The light background and bold counters ensure the content is both eye-catching and easy to follow.
Build beautiful websites
that are effortless to manage
1
Choose a Theme
Explore our range of professionally designed WordPress themes, perfect for any site—from blogs to online stores. Each theme is responsive and optimized for performance, so you can find the ideal fit for your needs.
2
Add your content
Easily make the theme your own by adding text, images, and videos using WordPress’s native editor. Customize layouts and design elements without any coding, creating a website that reflects your style and values.
3
Publish
Our themes are built for SEO and mobile-friendliness, ensuring your site looks great and reaches more people. Plus, with fast load times and a seamless experience, your website is set to make a strong first impression.
Image Cover Pattern
The Image Cover pattern is a striking block layout that features a bold title and a clear call to action layered over a background image. This pattern is designed to grab visitors’ attention by combining compelling visuals with concise messaging, making it ideal for hero sections, promotional banners, or featured announcements. The background image sets the tone and mood, while the title and call to action-such as a button or link-encourage users to engage further. The overlay ensures that text remains readable and visually balanced against the image, resulting in a professional and impactful presentation that works seamlessly across devices.

Get with our free theme download it now and see how easy building a beautiful website can be!
Interactive Columns Pattern
The Interactive Column pattern is a dynamic two-column layout designed to enhance user engagement and streamline information delivery. On the left side, it presents a list of feature titles accompanied by brief descriptions, while the right side displays a detailed explanation of the selected feature. Users can click or tap on any title in the left column to instantly reveal more information about that feature in the right column, making it easy to explore multiple features without leaving the section. This interactive experience works seamlessly on both desktop and mobile devices, ensuring accessibility and usability for all visitors. The pattern is ideal for product features, service highlights, FAQs, or any content that benefits from an organized, interactive presentation.
Style variations
Personalize your site instantly with our collection of pre-designed Style Variations. Each variation transforms your entire website with cohesive color palettes, typography pairings, and spacing adjustments—all while maintaining your content structure. Switch between professional, creative, or bold aesthetics with a single click, giving your site a complete makeover without rebuilding from scratch.
Responsive layout
Experience flawless design across all devices with our meticulously crafted responsive layouts. The Block Theme automatically adapts your content to look stunning on desktops, tablets, and smartphones without requiring additional configuration. Maintain professional aesthetics and functionality regardless of screen size, ensuring your visitors enjoy a seamless experience no matter how they access your site.
Animations
Captivate your audience with eye-catching animations that work instantly upon installation. Our theme includes carefully optimized motion effects integrated directly into our pattern library no plugins or coding required. From subtle hover effects to engaging scroll reveals, these performance-friendly animations add professional polish to your site while maintaining fast load times and smooth performance.
Pricing Columns Pattern
The Pricing Columns pattern is a structured block layout designed to clearly present different pricing options or packages. Each column typically highlights a specific package and includes a prominent “Recommended” tag to draw attention to the most popular or best-value option. The layout features a large, easy-to-read price, the name of the package, a concise description outlining what’s included, and a clear call to action (CTA) such as a “Sign Up” or “Get Started” button. This pattern makes it simple for visitors to compare packages at a glance and quickly identify the best choice for their needs, while the visually distinct elements ensure key information stands out and encourages user engagement.
Personal
$89
Yearly Package
Designed for your growing business, the Yearly Package delivers continuous value with regular theme enhancements, compatibility updates, and access to new features as they’re released. Stay current with WordPress innovations while receiving priority support.
Free updates for an entire year This is a yearly subscription.
Business
$499
Lifetime Package
Designed for long-term success, the Lifetime Package offers perpetual access to the Block Theme’s complete ecosystem, including all future innovations, design expansions, and performance optimizations. Make a one-time investment for endless possibilities.
Free lifetime updates, pay once and enjoy forever.
Mockup Quote Pattern
The Mockup Quote pattern is a visually appealing layout designed to highlight a testimonial, statement, or key message. It features an image-often a product mockup, user photo, or relevant graphic-positioned on the right side, while the left side displays a prominent title and a descriptive text. This arrangement draws attention to both the visual and written content, making it ideal for showcasing customer quotes, product endorsements, or important highlights. The clean, balanced design ensures that the message is easily readable and the accompanying image reinforces the content, creating a compelling and trustworthy presentation.

Title
Description
Testimonials Pattern
The Mockup Quote pattern is a visually appealing layout designed to highlight a testimonial, statement, or key message. It features an image-often a product mockup, user photo, or relevant graphic-positioned on the right side, while the left side displays a prominent title and a descriptive text. This arrangement draws attention to both the visual and written content, making it ideal for showcasing customer quotes, product endorsements, or important highlights. The clean, balanced design ensures that the message is easily readable and the accompanying image reinforces the content, creating a compelling and trustworthy presentation.

Lucie
I love how easily The Block theme works with the Gutenberg editor! It’s so intuitive, and I don’t need any extra plugins to get the look I want. Customizing my site has been a breeze, and it’s so responsive on different devices. Definitely a great modern theme.

Marco
As someone who values speed and efficiency, The Block theme has been a game-changer. It’s incredibly lightweight, which has noticeably improved my website’s loading times. Plus, the SEO optimization is a huge bonus.

Cloe
The Block theme is fantastic for creating a professional-looking website without needing to be a tech expert. Although I am new to website creation, the theme’s adaptability and clear design have made the process smooth and enjoyable.
FAQ Accordion Pattern
The FAQ Accordion Pattern is a user interface design commonly used to organize frequently asked questions in a compact, interactive format. It consists of a vertically stacked list of questions, each serving as a clickable header. When a user clicks on a question, the corresponding answer smoothly expands below it, while other answers remain hidden, keeping the layout tidy and easy to navigate. This approach allows users to quickly scan questions and reveal only the information they need, reducing clutter and improving readability, especially on mobile devices where screen space is limited.
What are the requirements?
To use our theme, you need a minimum version of WordPress 5.9, which was released in January 2022. This version offers extensive support for creating and utilizing themes that are fully built with blocks. The Block Theme works best on the latest version of WordPress 6.7+
I have a question, where can I get help?
We’d love to help! Email support@thethemefoundry.com and we’ll have an answer to you as quickly as we can.
Will the themes work with my plugins?
Most likely! We try really hard to make sure our themes work with all your favourite plugins. If something isn’t working, let us know and we’ll see what we can do to help you.
Do I need plugins to use the theme?
Our themes are plugin free. They work natively with all the WordPress features, giving you the best experience and performance out of the box. No plugins or external editors required.