Skip to content

WordPress themes

Theme audits before you submit

I’ve been on the WordPress Themes Team since 2020 and review themes for the directory most days. I can help you prepare yours for the directory: a well-built theme, with the most common mistakes already fixed.

Theme Moderator, listed on the Themes Team members page · WordPress.org profile

Audit report

example-theme 1.0.0

  • Required

    inc/template-tags.php:42

    Post meta is printed without escaping. Wrap it in esc_html().

  • Required

    assets/fonts/

    Bundled font has no licence listed in readme.txt.

  • Recommended

    theme.json

    Colour palette lives in CSS. Move it to theme.json so users can edit it.

  • Passed

    header.php

    Skip link and keyboard navigation work as expected.

An example of how a report is laid out. Yours lists what I find in your theme.

What I can do

Audit before you submit

I go through your theme against the directory requirements and send you a written report. Each issue comes with the file it’s in, why it matters and how to fix it, with the blocking ones first.

Fixes

If you’d rather not work through the report yourself, I can make the changes with you and explain each one, so the next theme needs fewer.

Moving to a block theme

I can help you turn a classic theme into a block theme with theme.json, templates, patterns and style variations. Trama, my own Full Site Editing theme, is built this way.

A typical fix: escaping what the theme prints, one of the most common reasons a theme is sent back.
WordPress Site Editor showing the style variations of the Trama block theme
Trama, my block theme, in the Site Editor with its style variations.

What I check

The areas where themes are most often sent back to their authors.

  • Licences and credits for bundled fonts, images and scripts
  • Escaping, sanitisation and safe handling of user input
  • Prefixes, text domain and translation readiness
  • theme.json, templates, template parts and patterns
  • Keyboard navigation, skip links, focus styles and contrast
  • Features that belong in a plugin, not in a theme
  • Readme, screenshot, tags and the other required files

How it works

  1. 1

    Send me the theme

    A zip or a repository link, with a note on where you are: first submission, a ticket that came back with issues, or an update.

  2. 2

    I review it

    I test the theme on a clean WordPress install and read the code against the current directory requirements.

  3. 3

    You get a report

    A list of issues in order of priority. You fix them, or we agree on what I fix for you.

What this service is

Private help to prepare a well-built theme, offered in my own name. I work with you on the theme before you submit it.

The review on WordPress.org is a separate process, run by the Themes Team. This service isn’t part of it and has no effect on its outcome or its timing.

Have a theme to check?

Tell me about the theme and where it is in the process.

Discuss a theme audit