---
title: What is a block-based WordPress theme?
description: Block-based WordPress themes enable full-site editing with Gutenberg blocks—from templates to headers—using HTML templates and theme.json styling.
---
[Skip to content](https://help.imforza.com/knowledge/what-is-a-block-based-wordpress-theme#main-content)
English
Show submenu for translations
[More support](https://help.imforza.com/knowledge/kb-tickets/new?hsLang=en) [View Your Support Tickets](https://help.imforza.com/tickets?hsLang=en)
[](https://www.imforza.com/)
- [Get Support](https://www.imforza.com/support/)
- [Join Our Email List](https://www.imforza.com/internet-marketing-newsletter-signup/)
- [Read Our Blog](https://www.imforza.com/blog/)
Open main navigation
Close main navigation
- [Get Support](https://www.imforza.com/support/)
- [Join Our Email List](https://www.imforza.com/internet-marketing-newsletter-signup/)
- [Read Our Blog](https://www.imforza.com/blog/)
- English
Show submenu for translations
- [More support](https://help.imforza.com/knowledge/kb-tickets/new)
- [View Your Support Tickets](https://help.imforza.com/tickets)
- [Contact us](https://www.imforza.com/contact-us/)
[Contact us](https://www.imforza.com/contact-us/)
You Have Questions, We Have Answers
- There are no suggestions because the search field is empty.
1. [imFORZA Knowledgebase](https://help.imforza.com/knowledge?hsLang=en)
2. [Websites](https://help.imforza.com/knowledge/websites?hsLang=en)
3. [Themes](https://help.imforza.com/knowledge/websites?hsLang=en#themes)
# What is a block-based WordPress theme?
## A block‑based WordPress theme (also known as a "block theme") is a modern theme structure that leverages Gutenberg blocks and Full‑Site Editing (FSE) to enable visual and flexible site design—across headers, footers, content, navigation, and templates—without relying on PHP templates or a theme customizer.
### Origins and Overview
Introduced with WordPress **5.9**, block themes ushered in full-site editing, making block-based layout design a core part of WordPress architecture. The first default block theme was **Twenty Twenty-Two**, launching with FSE capabilities.
---
### Key Features
#### Full-Site Editing via Site Editor
Block themes integrate with the Site Editor, replacing the old Customizer. From there, you can customize everything—templates, template parts, styles—live, visually.
#### HTML Template Files
Instead of PHP templates (`header.php`, `index.php`), block themes use **HTML files** in a `templates` directory. This simplifies theming and aligns with JavaScript and block workflows.
#### theme.json for Styling
All global and block-level styling—typography, color palettes, spacing—is centralized in a **theme.json** file. This enables consistent, efficient use of styles across blocks.
### Reusable Patterns & Template Parts
Block themes support **block patterns** (pre-built layouts) and **template parts** (like header.html or footer.html), allowing designers to compose and reuse layout sections easily.
---
#### Block Themes vs. Classic Themes
| Feature | Classic Themes | Block-Based Themes |
| --- | --- | --- |
| Templating | PHP files | HTML files & blocks |
| Editing Tool | Customizer | Site Editor (FSE) |
| Styling | style.css + CSS overrides | theme.json + block styles |
| PHP Usage | Heavy reliance | Minimal, optional |
| Flexibility | Limited without coding | Full visual control |
---
### Benefits
- **Code-free whole site design**—design using blocks, templates, and patterns.
- **Streamlined performance**—blocks load only what’s needed, improving page speed.
- **Future-ready**—aligned with WordPress’s direction and block editor roadmap.
- **Less dependency on plugins**—eliminate many page builder plugins and custom PHP.
---
### Challenges & Considerations
- **Learning Curve**—transitioning from classic theme development requires learning new tools and file structures.
- **Documentation**—block themes are newer and less documented; developers need to rely on evolving documentation.
- **Legacy Plugin & Theme Compatibility**—some older features or plugins may not fully support FSE.
---
### How to Get Started with a Block Theme
1. **Select a block-capable theme** (look for Full-Site Editing or block theme tags on WordPress.org).
2. **Explore the Site Editor** under Appearance with the theme active.
3. **Edit styles and templates** using the built-in style panel and template layout options.
4. **Explore pattern usage**—inserting, customizing, and saving your own block combinations.
5. For developers—examine block theme folders: `/templates/`, `/parts/`, `/patterns/`, `/styles/`, and configure them via theme.json.
Block-based WordPress themes are a transformative evolution in site design—putting full visual control into the hands of users and aligning WordPress with modern, modular, UI-driven workflows. With HTML templates, theme.json styling, and Full-Site Editing, block themes deliver flexibility, performance, and future-proofing—making website design more intuitive, powerful, and plug-and-play than ever before.
- [Websites](https://help.imforza.com/knowledge/websites?hsLang=en#main-content)
- [Design](https://help.imforza.com/knowledge/websites?hsLang=en#design)
- [HTML/CSS](https://help.imforza.com/knowledge/websites?hsLang=en#html-css)
- [Plugins](https://help.imforza.com/knowledge/websites?hsLang=en#plugins)
- [Themes](https://help.imforza.com/knowledge/websites?hsLang=en#themes)
- [Development](https://help.imforza.com/knowledge/websites?hsLang=en#development)
- [Hosting](https://help.imforza.com/knowledge/hosting?hsLang=en#main-content)
- [File Management](https://help.imforza.com/knowledge/hosting?hsLang=en#file-management)
- [Domains](https://help.imforza.com/knowledge/hosting?hsLang=en#domains)
- [DNS](https://help.imforza.com/knowledge/hosting?hsLang=en#dns)
- [Internet Marketing](https://help.imforza.com/knowledge/internet-marketing?hsLang=en#main-content)
- [Video Marketing](https://help.imforza.com/knowledge/internet-marketing?hsLang=en#video-marketing)
- [Paid Advertising](https://help.imforza.com/knowledge/internet-marketing?hsLang=en#paid-advertising)
- [Content Marketing](https://help.imforza.com/knowledge/internet-marketing?hsLang=en#content-marketing)
- [Conversion Optimization](https://help.imforza.com/knowledge/internet-marketing?hsLang=en#conversion-optimization)
- [AI](https://help.imforza.com/knowledge/internet-marketing?hsLang=en#ai)
- [Social Media](https://help.imforza.com/knowledge/internet-marketing?hsLang=en#social-media)
- [Tracking / Reporting](https://help.imforza.com/knowledge/internet-marketing?hsLang=en#tracking-reporting)
- [SEO](https://help.imforza.com/knowledge/internet-marketing?hsLang=en#seo)
- [Email Marketing](https://help.imforza.com/knowledge/internet-marketing?hsLang=en#email-marketing)
- [Tracking & Reporting](https://help.imforza.com/knowledge/internet-marketing?hsLang=en#tracking-reporting-1)
- [General](https://help.imforza.com/knowledge/general?hsLang=en#main-content)
- [Tutorials](https://help.imforza.com/knowledge/general?hsLang=en#tutorials)
- [Company Info](https://help.imforza.com/knowledge/general?hsLang=en#company-info)
- [IDX Broker](https://help.imforza.com/knowledge/idx-broker?hsLang=en#main-content)
- [Account and Billing](https://help.imforza.com/knowledge/idx-broker?hsLang=en#account-and-billing)
- [Billing](https://help.imforza.com/knowledge/billing?hsLang=en#main-content)
- [Terms](https://help.imforza.com/knowledge/billing?hsLang=en#terms)
- [Payments](https://help.imforza.com/knowledge/billing?hsLang=en#payments)
- [Cancellations](https://help.imforza.com/knowledge/billing?hsLang=en#cancellations)
- [Integrations](https://help.imforza.com/knowledge/integrations?hsLang=en#main-content)
- [IDX](https://help.imforza.com/knowledge/integrations?hsLang=en#idx)
- [CRM](https://help.imforza.com/knowledge/integrations?hsLang=en#crm)
- [AI](https://help.imforza.com/knowledge/ai?hsLang=en)
- [Get Support](https://www.imforza.com/support/)
- [Join Our Email List](https://www.imforza.com/internet-marketing-newsletter-signup/)
- [Read Our Blog](https://www.imforza.com/blog/)
[](https://www.imforza.com)
12130 Millennium Drive
Playa Vista, CA 90094
310.499.2900
[mailto:email@email.com](mailto:email@email.com)
Copyright © 2025, imFORZA