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 section, you can learn how to build the classic or block themes. The classic theme is the original theme that primarily uses PHP. The block theme is a newer theme that is built mainly using HTML. The block theme is composed entirely of blocks allowing users to take full advantage of the full site editor.

Head over to the Block Editor Handbook if you are interested in learning about the block theme.

Continue reading if you are interested in building the classic theme.

  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, set up your development environment, and build your first theme.
  2. Once you’re through the introduction, the Theme Basics section will introduce you to the building blocks of a WordPress theme.
  3. The Theme Functionality section will show you all of the different types of functionality you can make use of in your theme.
  4. If you’re looking to give flexibility and yet protect your users, head over to the Customizer and Security sections
  5. 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.
  6. 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 theme directory.

Tip: If you want to learn about block themes go to the Block Editor Handbook.

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.