Premium marketplaces have made buying a WordPress theme a five-minute task, but building one from scratch is how you truly understand the platform. This guide walks through the essential concepts for creating a production-ready theme in 2016.
The Required Minimum
A WordPress theme needs exactly two files: style.css (with the file header comment block) and index.php. Everything else is progressive enhancement. The header comment block tells WordPress about your theme:
/*
Theme Name: My Theme
Theme URI: https://example.com
Author: Your Name
Version: 1.0.0
*/Template Hierarchy
WordPress picks which template file to load based on a priority-ordered hierarchy. For a single post WordPress checks (in order): single-{post-type}-{slug}.php, single-{post-type}.php, single.php, singular.php, then index.php. Understanding this hierarchy means you can surgically control exactly which template renders for any URL.
The Hook System
WordPress themes communicate with the core platform via actions and filters. Actions let you run code at specific points (wp_enqueue_scripts, after_setup_theme). Filters let you modify data before it is used (the_content, excerpt_length). Never override core functions directly — hook everything.
// Correct — use a filter
add_filter( 'excerpt_length', function() { return 20; } );
// Enqueue scripts the right way
add_action( 'wp_enqueue_scripts', function() {
wp_enqueue_style( 'theme-style', get_stylesheet_uri() );
wp_enqueue_script( 'theme-js', get_template_directory_uri() . '/assets/js/main.js', [], '1.0', true );
} );Theme Support Features
Declare what your theme supports in after_setup_theme:
add_action( 'after_setup_theme', function() {
add_theme_support( 'post-thumbnails' );
add_theme_support( 'title-tag' );
add_theme_support( 'html5', [ 'search-form', 'comment-form' ] );
register_nav_menus( [ 'primary' => 'Primary Navigation' ] );
} );The Customizer API
The Theme Customizer (introduced in WP 3.4) lets users preview changes in real time. Add your own settings in customize_register:
add_action( 'customize_register', function( $wp_customize ) {
$wp_customize->add_setting( 'brand_color', [ 'default' => '#7c3aed' ] );
$wp_customize->add_control( new WP_Customize_Color_Control( $wp_customize, 'brand_color', [
'label' => 'Brand Color',
'section' => 'colors',
] ) );
} );Child Themes
If you are extending an existing theme, always use a child theme. It inherits the parent’s templates and lets you override only what you need, so parent theme updates do not destroy your customisations.
Building themes from scratch is the fastest path to WordPress mastery. The skills you learn — hooks, template hierarchy, the Customizer — apply everywhere in the WordPress ecosystem.
