Title: Theme Handbook
Author: Scott Reilly
Published: July 30, 2014
Last modified: February 9, 2026

---

# Theme Handbook

[ Back to top](https://developer.wordpress.org/themes/?output_format=md&swcfpc=1#wp--skip-link--target)

_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](https://developer.wordpress.org/themes/getting-started/what-is-a-theme/),
    learn about [WordPress’ license](https://wordpress.org/about/license/), and [set up your development environment](https://developer.wordpress.org/themes/getting-started/tools-and-setup/).
 2. Once you’re through the introduction, continue with the [Core Concepts](https://developer.wordpress.org/themes/core-concepts/)
    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](https://developer.wordpress.org/theme/advanced-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](https://developer.wordpress.org/themes/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](https://make.wordpress.org/docs) to find
out more about getting involved.

First published

July 30, 2014

Last updated

February 9, 2026

[  Next: Getting Started](https://developer.wordpress.org/themes/getting-started/)