← Back to Blog

Classic Themes vs Block Themes

Browse manual On this page × Wordpress Manual WordPress Fundamentals Toggle WordPress Fundamentals section What Is WordPress? WordPress.org vs WordPress.com What Can You Build with WordPress? How WordPress Works WordPress Core, Themes, Plugins and Content Essential WordPress Terminology How to Plan a WordPress Website Domains, Hosting, DNS and HTTPS Explained How to Choose WordPress Hosting…

Veyra Admin

4 min read

  • Article
  • Beginner
  • 4 minutes read
  • Reviewed August 3, 2026

WordPress supports two principal theme architectures: classic themes and block themes.

Both can produce professional websites, but they organize templates, styles and customization differently. Choosing between them affects the files developers work with and the tools site administrators use to edit the website.

Classic Themes

Classic themes are the original WordPress theme model. They primarily use PHP template files, CSS, JavaScript and WordPress template functions.

Common files include:

  • index.php as the final template fallback.
  • single.php for individual posts.
  • page.php for pages.
  • archive.php for archives.
  • header.php and footer.php for repeated regions.
  • functions.php for setup and theme-specific code.
  • style.css for theme metadata and styles.

Classic themes often expose design settings through the Customizer, widget areas, menu screens or proprietary options panels.

They remain fully supported and are widely used, especially on established websites and projects with mature PHP template systems.

Block Themes

Block themes use blocks for the full site structure, not only for post content.

Their templates are primarily HTML files containing block markup. Repeated regions are represented by block template parts, while theme.json defines settings and styles. Authorized users can edit these elements through the Site Editor.

A block theme commonly contains:

  • A templates directory.
  • A parts directory.
  • theme.json.
  • style.css.
  • Optional patterns, styles, PHP and assets.

Block themes make headers, footers, archives and other template-level layouts editable with the same block system used for content.

The Main Difference Is the Editing Model

The difference is not simply that one theme is old and the other is new.

Classic themes usually place more layout authority in theme files and developer-defined controls. Block themes expose more of the site structure through the Site Editor.

That can make block themes faster for visual iteration, but it also requires governance. A team may need roles, review processes and design restrictions to prevent accidental changes to global templates.

Classic themes can offer tighter file-based control, but a poorly designed classic theme may depend on proprietary panels or page builders just as heavily as any other system.

Hybrid Themes

Some classic themes adopt selected block features such as theme.json, block template parts, appearance tools or the Template Editor.

These are commonly called hybrid themes. The term is useful descriptively, but WordPress still treats them as classic themes technically.

Hybrid approaches can provide a gradual migration path. They can also produce confusing interfaces when users are unsure whether a setting belongs in the Customizer, Site Editor, post editor or a theme options page.

Feature Comparison

Templates

Classic themes use PHP templates. Block themes use block HTML templates, with PHP still available for supporting code.

Global design

Classic themes generally rely on CSS, the Customizer and theme options. Block themes use Global Styles and theme.json as central design systems.

Site editing

The full Site Editor requires a block theme. A classic theme may enable the narrower Template Editor or selected block features.

Portability

Both types can be portable when they follow WordPress standards. Portability problems usually come from proprietary blocks, shortcodes, bundled content models or theme-specific data.

Development workflow

Classic themes fit established PHP workflows. Block themes allow more layout work in HTML block markup and JSON configuration, while still benefiting from version control and build tools.

Which Type Should You Choose?

Choose based on the project, not on novelty.

A block theme is a strong option when:

  • Editors need controlled access to templates and styles.
  • The design can be represented effectively with blocks.
  • The team wants native full-site editing.
  • The project is starting without legacy theme dependencies.

A classic or hybrid theme may be appropriate when:

  • The project already has a reliable custom PHP theme.
  • Complex server-rendered templates are central to the design.
  • Existing plugins or workflows depend on classic interfaces.
  • The team needs a gradual transition rather than a rebuild.

Frequently Asked Questions

Are classic themes deprecated?

No. Classic themes remain supported. WordPress continues to provide classic theme APIs and compatibility.

Can a classic theme use theme.json?

Yes. theme.json works with classic themes as well as block themes, although the full editing experience differs.

Is a block theme automatically faster?

No. Performance depends on implementation, assets, plugins, hosting and content. Theme architecture alone does not guarantee speed.

Continue Learning

Previous: What Is a WordPress Theme?

Next: How to Choose a WordPress Theme