W
WPInsider
Home / Themes
Themes

How to Convert a Classic Theme to a Block Theme

Move template files into HTML block templates and a theme.json — a migration path that doesn’t break your content.

AO
Aria Okafor
May 15, 2026 · 1 min read
X in f
WP

Move template files into HTML block templates and a theme.json — a migration path that doesn’t break your content. In this themes piece we go past the headline and into what actually matters when you sit down to do the work on a real site.

Why this matters

The WordPress ecosystem moves fast, and it is easy to act on a change before understanding its trade-offs. We tested this on production-scale sites so you do not have to learn the hard way.

Always test major changes on a staging site first. A five-minute clone can save you hours of downtime.

How to get started

Start small and measure. The steps below cover the essentials without turning a quick task into an afternoon.

  • Back up the site (files and database) before you change anything.
  • Apply the change on staging and confirm nothing regresses.
  • Measure the before/after — load time, errors, and Core Web Vitals.

The bottom line

For most sites this is worth doing after a quick staging test. The wins are real, and the risk is manageable when you follow the steps above.

AO
Written by
Aria Okafor

Aria focuses on themes, full-site editing, and design systems for editorial and commerce sites.

Related articles