Theme Handbook

Welcome to the WordPress Theme Developer Handbook, your resource for learning all about the exciting world of WordPress themes. 

The Theme Developer Handbook is a repository for all things WordPress themes. Whether you’re new to WordPress themes, or you’re an experienced theme developer, you should be able to find the answer to many of your theme-related questions right here.

In this handbook, you can learn how to build block themes or classic themes.

  • A block theme is a new theme that you can use from WordPress version 5.9. It is built mainly using HTML and a theme configuration file. The block theme is composed entirely of blocks, allowing you to edit all parts of your site in the Site Editor.
  • A classic theme is the original theme, without version limitations, that primarily uses PHP, JavaScript and CSS. Classic themes take advantage of WordPress PHP functions, hooks and filters.

  1. If you’re new to developing WordPress themes, start with section 1, where you can find out what a theme is, learn about WordPress’ license, and set up your development environment.
  2. Once you’re through the introduction, continue with the Theme Basics section.

It is recommended to read through both the block theme section and the classic theme sections.
This will give you an understanding of the differences between the two types of themes, and help you choose what type of theme to build.

If you’ve got to grips with the basics of themes, check out the Advanced Theme Topics to learn about child themes, best UI practices, theme testing and more.

Once you’ve got your theme ready for the world, the final section will cover releasing your theme, teaching you some best practices for theme distribution, and for getting it ready for the WordPress.org theme directory.


The WordPress Theme Developer Handbook is created by the WordPress community, for the WordPress community. We are always looking for more contributors; if you’re interested stop by the docs team blog to find out more about getting involved.