Search results

Create a Child Theme to Customize a WordPress Theme

by Tom Johnson on Jan 10, 2013
categories: technical-writing

If you're customizing a WordPress theme, it's best to create a child theme out of the WordPress theme. With a child theme, you can update the parent theme when updates are available. Any customizations you make to the child theme will be retained.

Here's how it works.

  1. If you'll be creating a child theme for the Twenty Twelve theme (whose folder in wp-content/themes is "twentytwelve"), create a folder called twentytwelve-child and upload it to wp-content/themes.
  2. Create a style.css file and add this to it:Theme Name: Twentytwelve Child
    Description: Child theme for the twentytwelve theme
     Your name here
    Template: twentytwelve
    @import url("../twentytwelve/style.css");
  3. In the Template field, change twentytwelve to whatever folder your parent theme is in. This field is the only really significant field up there.
  4. Change the Theme Name and any other details you want.
  5. For the @import url, change the URL to refer to your parent theme's stylesheet. Then upload your style.css file to the twentytwelve-child folder.
  6. Activate your child theme by going to Appearance > Themes and select the Child theme. If you want a screenshot there as other themes display, add a screenshot.png file to your child theme folder. Now any changes you make to your child theme's stylesheet will overwrite the parent theme's styles. Additionally, any files you add, such as page.php or single.php, will overwrite the parent theme's files. If you add a functions.php file, the functions.php file information will be added to the parent's functions.php file rather than overwriting it.

When the parent theme gets updated, just apply the update to the parent folder and your child theme's customizations will remain in tact.

Here's a video showing the process:

See the Child Themes page on the WordPress Codex for more information.

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.

If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.