Ahmad Awais



Introducing _Child – A WordPress Child Theme Boilerplate

Ahmad AwaisAhmad Awais

“I found out there was no child theme included. Dang! Now I have to create one!”

β€” #my_reaction_when

This is how we all sound when we have to create a child theme. There is really no rocket science to the process of creating child themes, but as a front-end fanatic, I always look for the best practices.

Today when I had to create a child theme, I thought of creating a boilerplate first, by DRY (Don’t Repeat Yourself) philosophy. So, there you go, a WordPress child theme boilerplate was born, and the only parent (me) chose to call it _child.


How to Stuff?#

There are only two files in _child. Which are


Inside _child’s style.css, there is nothing but a comment for WP to read it as a theme. At line #7Β there is a template tag, which you need to replace with the folder’s name of your parent theme.


This file is a bit interesting. There’s a function called aa_enqueue_styles() which is responsible for enqueuing two style sheets.

If you have any questions, let me know.

_Child WP Child Theme Boilerplate#

It lives at GitHubΒ under a tree called GPL license.Β Start it, fork it. Pull requests are welcomed!

Download v1.0.0 β€” Star or Fork

P.S. _child is an open-source theme, which means anyone can send pull requests to enhance it and make it better. My friend Matt CromwellΒ recently contributed to _child in the form of a branch called cleanup, _child in this branch dequeues and deregisters parent theme’s sidebars, widgets, post_types, and scripts (JS & CSS). Thus the name is cleanup.

P.P.S. AΒ few beginner developers requested this gif on how to clone the _child boilerplate.



Helping businesses understand developers. Head of Developer Relations RapidAPI.

πŸ“Ÿ Edutainer at Node.js CLI Automation course (100 videos Β· 22 Projects) & VSCode.pro course (over 20K devs). 🎩 Award-winning Open Source Engineer & Dev Advocate 🦊 Google Developers Expert Web DevRel πŸš€ Mars Ingenuity Helicopter code contributor πŸ† 8th GitHub Stars Award recipient 🌳 Node.js foundation Community Committee Outreach Lead, Member Linux Foundation, OpenAPI Business Governing Board, and DigitalOcean Navigator.

✌️ Author of various open-source dev-tools and software libraries used by millions of developers worldwide ⓦ WordPress Core Developer πŸ“£ TEDx Speaker with 100+ international talks.

πŸ”₯ Satya Nadella Β· CEO of Microsoft, said β€” Awais is an awesome example for developers.
πŸ™Œ Leading developers and publishing technical content for over a decade πŸ’œ Loves his wife (Maedah) ❯ Read more about Ahmad Awais.

πŸ‘‹β€¦ Awais is mostly active on Twitter @MrAhmadAwais


Developers Takeaway

Takeaway my professional opinion on open-source, developer relations, growing your business with family, and everything in between! Delivered to your inbox a couple of times every year. I'm even funny at times. I hate spam β€” pinky-promise!

πŸ‘¨β€πŸ’»πŸ‘©β€πŸ’» 118,947 Developers Already Subscribed
Comments 2
  • Fahad
    Posted on

    Fahad Fahad

    Reply Author

    Thanks for the post.
    Q. What if I have made tons of changes (that go way beyond style.css) in my theme without making a child theme? Now the developer is offering an update because its a premium theme but I can’t do it.
    Any solution other than doing the whole stuff again.

    • Ahmad Awais
      Posted on

      Ahmad Awais Ahmad Awais

      Reply Author

      Nope there is no solution, except fo you stripping out those changes and making them work with a child theme.