Child Theme Support

I have just added a draft section to the Theme Review Guidelines, to cover requirements for Child Theme support/facilitation for hosted Themes:


  • Themes are required to facilitate the use of Child Themes. A “basic” Child ThemeChild theme A Child Theme is a customized theme based upon a Parent Theme. It’s considered best practice to create a child theme if you want to modify the CSS of your theme. (i.e. a style.css with Template headerHeader The header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes. tag and @import() of the Template style.css), when activated, should function exactly as the Theme itself functions.
  • Themes are required to include functional and resource files in a manner that facilitates the use of Child Themes:


Based on discussion on the mail-list, consensus appears to be that facilitating end user use of Child Themes is beneficial, so this discussion is the first step in incorporating Child Theme support into the Guidelines.

Please discuss. Do you agree/disagree that Child Theme support should be added to the Guidelines? Are the above Guidelines sufficient? What should be added/removed/changed? What about pluggable/filterable functions?

#child-theme, #child-themes, #guidelines

Child Themes will now be considered for inclusion…

Child-Themes will now be considered for inclusion into the WordPress Extend Themes repository.

Note: Child Themes are not currently being considered for inclusion in WordPress Extend.

Please be sure to read the Theme Review process and guidelines; also, please note the additional Child-Theme guidelines before submitting a Child-Theme for consideration.

Please note, although at the time of this writing the upload script may note the Child-Theme “fails” as the criteria used for Child-Themes is slightly different. If the Child-Theme did actually pass you would see at the bottom of the upload acknowledgement page a reference to the new Themes TracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub. ticket as well as receiving an email referencing the ticket as well.

You will also be able to check the open status of the Child-Theme in this Trac report:

#child-theme, #child-themes, #guidelines

Discussion – Child Themes on the Repository – Guidelines

1) Parent themes of child themes that are developed need to be made child-theme ready; proper use of where to find files with get_template_part, get_stylesheet_ and get_template_ functions.
2) documentation is applied as part of the theme review process when checking child themes, all information is to be considered good practice and required, with addition to the theme review representation of license information.
3) Parent themes of child themes submitted must have passed the current theme review guidelines for the current revision of WordPress, not if they have passed before, but specifically with the current revision of WordPress.
4) Child themes are reviewed with the parent theme; must pass current theme review guidelines and associated child themeChild theme A Child Theme is a customized theme based upon a Parent Theme. It’s considered best practice to create a child theme if you want to modify the CSS of your theme. documentation.
5) Recommendation to use the parent themes repository slug as the prefix to the child theme’s name. ex. easel-highsociety, atahualpa-wired, this is only the name of the theme & directory name of theme in the zip, not where to find the theme; even as found in the being part of the review process, this naming convention will stay a recommendation; however, declared best-practice.
6) Description in the style.css must clearly state that it is a child theme example: “This is a child theme for the Easel theme.” – This is for redundancy of recognition that it is a child theme, even though other things will be noted on the repository that it is a child theme, this is for the wp-admin -> themes page for the end user.

Additional For Developers:
1) It is the responsibility of the developer of child themes to keep their child themes up to date with the current revision of their theme that is updated. If a developer make changes to the parent theme, it is the developers responsibility to keep the child themes updated as well.

Changes, word usage, additional guidelines and protocols, as well as information regarding use of child-theme tag requested as part of this discussion.

#child-theme, #discussion, #guidelines