Home / Lede WordPress theme

Lede: a lightweight WordPress block theme

Lede is the free block theme I build my sites on, this one included. It ships no theme JavaScript and one self-hosted font, and its design lives in theme.json, so you can change it in the Site Editor. Use it as it is, or as the parent for your own child themes.

Free · GPLv2 or later · No theme JavaScript

Version 2.0.1 · Requires WordPress 6.9 and PHP 8.0 · In the WordPress.org theme directory since November 2026

A post on dhirenpatel.me, which runs on a Lede child theme: navy header with the post title, readable body text, a code block and an “On this page” sidebar

Why I built Lede

Each site I build with blocks starts as a child theme of Lede. The child theme holds the brand: colours, fonts and a few templates. Lede holds what stays the same from site to site: templates, patterns, breakpoints and clean markup. This site and exivontech.com both run that way.

I kept Lede to presentation only. Security hardening, SEO tags and caching belong in plugins, because theme code switches off the day you change themes.

For developers

A parent theme that stays out of the way

What you get when you build a child theme on Lede.

No theme JavaScript

Lede adds no scripts of its own. Core blocks load theirs only on pages that use them.

One preloaded variable font

Inter, self-hosted as WOFF2 with font-display: swap. A child theme with another font changes the preload list with the lede_preload_fonts filter.

theme.json first

Colours, type, spacing and block styles live in theme.json, so Global Styles can change them. Two small stylesheets cover what theme.json can’t express, and core inlines both.

Fixed breakpoints

600, 768, 1024 and 1280px, defined once in one stylesheet. Content is 760px wide and wide blocks are 1200px.

Child-theme ready

A child theme needs a style.css and only the theme.json tokens it changes. Override any template, part or pattern with a file at the same path.

WPCS clean and translatable

All PHP passes the WordPress Coding Standards. Every string is translatable, and a .pot file ships with the theme.

Measured in Lighthouse

Mobile profile, median of three runs, on a local WordPress Playground server. A cached production host responds faster, so real pages should load sooner.

PagePerformanceAccessibilityBest practicesLayout shift (CLS)Blocking time (TBT)
Landing page9910010000ms
Blog index9910010000ms
Single post9810010000ms
Post with Sidebar9810010000ms

For writers and publishers

Ready to write with

Install it, add your logo and start publishing.

  • A blog grid of up to three columns, plus text-first archive and search pages.
  • Every post shows its category, author, date and reading time, with tags, previous and next links and comments below.
  • A Post with Sidebar template: a 300px sidebar from 1024px that moves below the article on smaller screens.
  • A Wide Page template, and a Page (No Title) template for landing pages that start with a hero.
  • 13 patterns: two heroes, features, stats, testimonials, pricing, FAQ, team, logo cloud, a call-to-action banner, contact, an about introduction and latest posts.
  • Block styles for cards, highlighted boxes, checkmark lists, image shadows and thick separators.
  • Colours and fonts you can change in the Site Editor, with no code.

What Lede leaves to plugins

These jobs need to keep working when you change themes, so the theme doesn’t do them.

You needUse
SEO tags, sitemaps, schema and breadcrumbsAn SEO plugin. Lede outputs no meta tags, so it never clashes with one.
Security hardeningA security plugin, or a small must-use plugin for the site.
Page caching and asset clean-upYour host’s cache or a caching plugin.
FormsA form plugin.

Frequently asked questions

Is Lede free?

Yes. Lede is free and licensed GPLv2 or later, like WordPress itself.

What do I need to run it?

WordPress 6.9 or later and PHP 8.0 or later. I’ve tested it up to WordPress 7.1.

Can I use Lede as a parent theme?

Yes, that’s what I built it for. Create a child theme whose style.css has Template: lede, then add only the theme.json tokens, templates and patterns you want to change.

How do I show a sidebar on posts?

Edit a post and choose the Post with Sidebar template. To make it the default, edit the Single Posts template in the Site Editor, or copy single-with-sidebar.html to single.html in a child theme.

Why does my page have two main headings?

The hero patterns include the page’s main heading. Use them with the Page (No Title) template, so the page title isn’t shown as well.

Does Lede add SEO tags or security features?

No. Those belong in plugins, so they keep working if you change themes. Lede’s markup works with any SEO plugin.

Where do I report a bug?

Open an issue on GitHub. Include your WordPress version and the steps to reproduce it.

Build your next site on Lede

Free, with no theme JavaScript and ready for your child theme.