haloafan.
LEARN JOURNEY/2026-05-20T06:55:00· 0 MIN READ

Understanding Block Theme Structure & theme.json

After spending time learning Gutenberg and block-based workflows, I finally reached a point where modern WordPress started feeling completely different from traditional WordPress.

Understanding Block Theme Structure & theme.json

Why I started exploring

Gutenberg is no longer just a content editor. With block themes and full site editing, the entire site — header, footer, templates — is composed from the same building blocks you use to write a post. That changes everything about how you approach layout.

The block-based mindset

Instead of thinking in pages, you start thinking in patterns. A hero section, a callout, a pricing grid — each one is a reusable block you can register, style, and drop anywhere. Combined with theme.json, design tokens live in one place instead of being scattered across a builder's hidden style controls.

theme.json
{
  "version": 2,
  "settings": {
    "color": { "palette": [...] },
    "typography": { "fontFamilies": [...] }
  }
}

What changed for me

Faster sites — no builder CSS bloat, no forty enqueued scripts
Design tokens in one file instead of buried in a drag-and-drop UI
Content that's portable — a block can move anywhere

It's not about abandoning tools — it's about understanding the architecture underneath them. The deeper I go, the more I believe Gutenberg has huge potential for the future of modern WordPress workflows.

Ahmad Afan Affaidin
WRITTEN BYAhmad Afan AffaidinWordPress Developer & AI-Driven — documenting my journey through code.
View Profile
(02) — KEEP READING

Keep Reading