Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Setup & site building · Explainer

What Is WordPress Theme Development? Explained

What Is WordPress Theme Development? Explained

Short answer

WordPress theme development is building the files that control a site's design and layout. Modern block themes use HTML templates, theme.json and CSS, while classic themes use PHP templates. Developers create templates, styles and patterns and keep the theme accessible and up to date.

Key takeaways

  • A theme controls design; content and features live elsewhere.
  • Block themes use HTML templates and theme.json.
  • Classic themes use PHP templates and the Customizer.
  • HTML and CSS come first, then theme.json, PHP and JavaScript.
  • Child themes are best for small changes to an existing theme.
  • Directory themes must meet GPL and review requirements.

What is WordPress theme development?

WordPress theme development is the work of building the files that control how a WordPress site looks and lays out its content, using templates, styles, theme.json settings and sometimes PHP and JavaScript.

A theme decides the design of your site: the header, footer, colours, fonts, page layouts and how posts and archives are displayed. Theme development is the process of creating or customizing that layer.

It is separate from content and mostly separate from features. Content lives in the database, and site features usually belong in plugins. The theme is the presentation.

If you are new to the idea of themes, read what a WordPress theme is first.

What does a WordPress theme developer actually do?

A theme developer designs and codes templates, sets up global styles, builds reusable patterns, makes the theme responsive and accessible, and keeps it working with new WordPress versions.

Typical tasks include:

  • Turning a design mockup into working templates.
  • Setting colour palettes, typography and spacing in theme.json.
  • Creating block patterns and template parts such as headers and footers.
  • Styling the block editor so it matches the front end.
  • Adding theme support for features like custom logos or wide alignments.
  • Testing across browsers, devices and screen readers.
  • Updating the theme when WordPress releases new features or changes.

Some developers build themes for one client site. Others build themes to sell or give away in the theme directory.

What are the two main types of WordPress themes?

Themes today are either block themes, built from HTML templates and theme.json and edited in the Site Editor, or classic themes, built from PHP template files and customized with the Customizer.

AreaBlock themeClassic theme
TemplatesHTML files made of block markupPHP template files
Global design settingstheme.jsonstyle.css, Customizer, PHP
Editing by site ownersSite EditorCustomizer and widgets
Headers and footersTemplate partsheader.php and footer.php
Main skillsBlocks, theme.json, CSSPHP, the Loop, hooks, CSS
Direction of WordPressCurrent focusStill supported

The Theme Handbook covers both types in depth. Our comparison of block themes vs classic themes helps you choose.

New default themes have been block themes since Twenty Twenty-Two, and most new WordPress features target block themes first.

What files make up a WordPress theme?

The minimum is a style.css file with a header comment plus an index template; real themes add theme.json, templates, template parts, patterns, a functions.php file and assets.

A simple block theme folder might look like this:

my-theme/
  style.css
  theme.json
  functions.php
  templates/
    index.html
    single.html
    page.html
    archive.html
  parts/
    header.html
    footer.html
  patterns/
    hero.php
  assets/
    fonts/
    images/

A classic theme uses PHP files such as index.php, single.php, header.php and footer.php instead of the templates and parts folders.

The style.css header tells WordPress the theme's name, author, version and other details. Without it, WordPress will not recognize the folder as a theme.

What skills do you need for theme development?

You need solid HTML and CSS, a working knowledge of WordPress blocks and theme.json, and for classic themes or advanced features, some PHP and JavaScript.

The skills stack up roughly like this:

  1. HTML and CSS. The foundation of every theme. The MDN CSS reference is a reliable resource.
  2. WordPress blocks and theme.json. Needed for block themes. See our guide on how to use theme.json.
  3. PHP basics. Needed for classic themes, functions.php and pattern files. The PHP manual is the official reference.
  4. WordPress hooks. Actions and filters let you change behaviour without editing core.
  5. JavaScript. Optional for most themes, but needed for custom blocks and interactive features.
  6. Accessibility and performance. Good themes work for keyboard and screen reader users and load quickly.

You do not need all of these on day one. Many people start by building a block theme with mostly HTML, CSS and theme.json.

How does the template hierarchy fit in?

The template hierarchy is the set of rules WordPress uses to pick which template file displays a given page, and theme developers rely on it to control layouts for posts, pages, archives and more.

For example, when someone views a single blog post, WordPress looks for the most specific template first, such as single-post, then falls back to single, then singular, then index.

This works the same way in block and classic themes. Only the file format differs. Our explainer on the WordPress template hierarchy walks through the full order.

Should you build a theme from scratch or use a child theme?

Build from scratch when you need a fully custom design or a reusable product; use a child theme when an existing theme is close and you only need targeted changes.

ApproachBest forTrade-off
Child themeSmall changes to a theme you likeDepends on the parent theme's updates
Starter themeCustom design with a head startNeed to understand the starter's structure
From scratchFull control or a theme to distributeMost time and skill needed
Site Editor onlyLight design changes with no codeLimited to what blocks and styles allow

A child theme inherits everything from a parent and overrides only what you change, so updates to the parent do not wipe your work. See what a child theme is.

For block themes, the free Create Block Theme plugin can export your Site Editor changes into a new theme or child theme. That is a handy way to start without writing every file by hand.

If you want the manual route, follow how to create a block theme from scratch.

What tools do theme developers use?

Most theme developers use a local WordPress environment, a code editor, version control with Git, browser developer tools and a standards checker such as the Theme Check plugin.

A common toolkit:

  • Local environment. Tools like Local, wp-env or WordPress Studio run WordPress on your computer. See our guide to setting up a local WordPress development environment.
  • Code editor. Visual Studio Code, PhpStorm or similar.
  • Git. Tracks changes and lets you roll back mistakes.
  • Browser developer tools. For inspecting layouts and debugging CSS.
  • Theme Unit Test data. Sample content that shows how your theme handles edge cases.
  • Debug mode. Turning on WP_DEBUG shows PHP notices and warnings while you work.

What rules apply if you publish a theme?

Themes submitted to the WordPress.org directory must meet review requirements on licensing, security, accessibility basics and coding standards, and must be released under a GPL-compatible licence.

The theme review requirements list everything reviewers check. Highlights include:

  • GPL-compatible licensing for code, images and fonts.
  • Proper escaping and sanitizing of data.
  • No plugin territory features such as custom post types or SEO tools.
  • Translation-ready text.
  • No obfuscated code or hidden links.

Commercial themes sold on your own site are not reviewed, but following these rules still makes a better, safer theme.

How long does it take and what does it cost?

A simple custom theme can take a few days for an experienced developer, while a complex theme with many templates and patterns can take weeks; costs vary widely by scope.

Time depends on the number of templates, the complexity of the design, and how much testing and documentation you need.

If you are hiring rather than building, our guide on how much a custom WordPress theme costs breaks down typical price ranges.

Is WordPress theme development worth learning?

Yes, it is a useful skill for freelancers, agencies and site owners, especially now that block themes let you build a lot with HTML, CSS and theme.json before touching PHP.

WordPress powers a very large share of websites, so demand for theme work stays steady. Block themes have also lowered the barrier to entry.

Start small.

Build a block theme for your own site, publish a child theme for a project, then work up to fully custom builds. Keep features in plugins and design in themes, and your work will be easier to maintain. Our explainer on themes vs plugins explains where that line sits.

Frequently asked questions

Do I need to know PHP to develop a WordPress theme?

Not always. A basic block theme can be built mostly with HTML templates, CSS and a theme.json file. PHP becomes necessary for classic themes, the functions file, dynamic patterns and more advanced features, so learning the basics is still worthwhile.

What is the difference between theme development and plugin development?

Theme development focuses on design and layout, while plugin development adds features and functionality. A good rule is that anything users would want to keep after switching themes, such as custom post types or forms, belongs in a plugin rather than a theme.

Can I develop a WordPress theme without coding?

Partly. The Site Editor lets you change templates and styles visually, and the Create Block Theme plugin can export those changes as a theme. For a polished, reusable or distributable theme, you will still need to edit files and write some CSS.

What is a starter theme?

A starter theme is a minimal theme with the basic files and structure in place but little or no design. Developers use it as a clean foundation, adding their own templates and styles instead of starting from an empty folder.

How do I test a WordPress theme?

Install it on a local or staging site, import the Theme Unit Test sample content, and check every template on desktop and mobile. Turn on debug mode, test with a keyboard and screen reader, and try it with common plugins before release.

Sources

  1. Theme Handbook WordPress Developer Resources
  2. Required theme review requirements Make WordPress Themes
  3. Create Block Theme WordPress.org
  4. CSS reference MDN Web Docs
  5. PHP Manual PHP Group

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.