[Skip to content](#main)

[→](/)

[![Avunu](/brand/avunu-logo.svg)![Avunu](/brand/avunu-logo-light.svg)](/)[Services](/services/)[Consulting](/services/consulting/)[ERP](/services/erp/)[Odoo](/services/erp/odoo/)[ERPNext](/services/erp/erpnext/)[Custom software](/services/custom-software/)[Devices & IoT](/services/devices-iot/)[Websites](/services/websites/)[Infrastructure](/services/infrastructure/)[Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

[About Avunu](/about/)[Team](/about/team/)[Insights](/insights/)[Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

- [Services](/services/)[Consulting](/services/consulting/)
- [ERP](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)
- [Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

- [About Avunu](/about/)
- [Team](/about/team/)
- [Insights](/insights/)
- [Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

[Knowledge base](/kb/)[WordPress](/kb/wordpress/)Split a child theme's functions.php into included files

Search the knowledge basePress/

ESC

Jump to

[Browse the knowledge base](/kb/)[Frappe](/kb/frappe/)[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[WordPress](/kb/wordpress/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Linux](/kb/linux/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

↵select↑↓navigateescclose

Search the knowledge base

[Skip to the article](#kb-article)[WordPress](/kb/wordpress/)10 articles

- [Overview](/kb/wordpress/)
- [Admin-only custom post types with custom list columns](/kb/wordpress/custom-post-type-admin/)
- [Docket Cache baseline configuration](/kb/wordpress/docket-cache-configuration/)
- [Gravity Forms](/kb/wordpress/gravity-forms/)
- [Populate Gravity Forms image choices from an ACF image field](/kb/wordpress/gravity-forms-image-choices-acf/)
- [Register custom block styles in a classic theme](/kb/wordpress/block-styles-classic-themes/)
- [Run WordPress cron from the system scheduler](/kb/wordpress/wordpress-cron/)
- [Split a child theme's functions.php into included files](/kb/wordpress/child-theme-file-includes/)
- [WordPress database optimization queries](/kb/wordpress/database-optimization-queries/)
- [WordPress debugging snippets](/kb/wordpress/debugging-snippets/)
- [WP-CLI cookbook](/kb/wordpress/wp-cli-cookbook/)
- [wp-config.php reference](/kb/wordpress/wp-config-reference/)

Other sections[Frappe](/kb/frappe/)[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Linux](/kb/linux/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

In WordPress: 10 articles

[Overview](/kb/wordpress/)[Admin-only custom post types with custom list columns](/kb/wordpress/custom-post-type-admin/)[Docket Cache baseline configuration](/kb/wordpress/docket-cache-configuration/)[Gravity Forms](/kb/wordpress/gravity-forms/)[Populate Gravity Forms image choices from an ACF image field](/kb/wordpress/gravity-forms-image-choices-acf/)[Register custom block styles in a classic theme](/kb/wordpress/block-styles-classic-themes/)[Run WordPress cron from the system scheduler](/kb/wordpress/wordpress-cron/)[Split a child theme's functions.php into included files](/kb/wordpress/child-theme-file-includes/)[WordPress database optimization queries](/kb/wordpress/database-optimization-queries/)[WordPress debugging snippets](/kb/wordpress/debugging-snippets/)[WP-CLI cookbook](/kb/wordpress/wp-cli-cookbook/)[wp-config.php reference](/kb/wordpress/wp-config-reference/)

Other sections[Frappe](/kb/frappe/)[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Linux](/kb/linux/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

WordPressSplit a child theme's functions.php into included files

Keep functions.php short by loading feature files and whole folders of post type and taxonomy definitions from the child theme.

UpdatedOct 1, 2026

Applies toWordPress 6.x

Tagswordpressthemesphp

Reading time2 min

On this page[Pick the Right Path Function](#pick-the-right-path-function)[Loader Pattern](#loader-pattern)

A `functions.php` that grows past a few hundred lines is hard to review. This pattern keeps it as a short loader that pulls in one file per feature, plus every file in a folder for things like custom post types and taxonomies.

## Pick the Right Path Function

The most common bug in child themes is loading files from the wrong theme. Use the function that matches where the file lives:

| Function                            | Returns                                                      |
| ----------------------------------- | ------------------------------------------------------------ |
| `get_stylesheet_directory()`        | The active (child) theme's folder.                           |
| `get_template_directory()`          | The parent theme's folder.                                   |
| `get_theme_file_path( 'file.php' )` | The child theme's copy if it exists, otherwise the parent's. |

In a child theme, `get_template_directory()` points at the parent, so files you add to the child theme won't be found.

## Loader Pattern

Put this in the child theme's `functions.php`:

```
<span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E"><?</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">php</span>
<span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">/**</span>
<span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"> * Child theme loader.</span>
<span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"> */</span>

<span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Single feature files.</span>
<span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">require_once</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_stylesheet_directory</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">.</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">'/inc/block-styles.php'</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>
<span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">require_once</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_stylesheet_directory</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">.</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">'/inc/woocommerce.php'</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>

<span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Every file in a folder (loaded in alphabetical order).</span>
<span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">foreach</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> ( [ </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">'post-types'</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">'taxonomies'</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> ] </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">as</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> $folder ) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">	</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">foreach</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> ( </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">glob</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">( </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_stylesheet_directory</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">.</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"/{</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">$folder</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">}/*.php"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> ) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">?:</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> [] </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">as</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> $file ) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">		</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">require_once</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> $file;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">	}</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">}</span>
```

With a layout like:

```text
my-child-theme/
├── functions.php
├── style.css
├── inc/
│   ├── block-styles.php
│   └── woocommerce.php
├── post-types/
│   └── my-cpt.php
└── taxonomies/
    └── my-taxonomy.php
```

Notes:

`require_once` avoids fatal "cannot redeclare" errors if a file is loaded twice.

`glob()` returns `false` on some systems when it fails, so `?: []` keeps the loop safe.

`glob()` sorts results alphabetically. If one file depends on another, prefix them (`10-base.php`, `20-extra.php`).

Each included file should register its own hooks (for example `add_action( 'init', ... )` to register a post type) rather than running code immediately.

Tip

Custom post types and taxonomies hold content, so they usually belong in a small site plugin or must-use plugin rather than a theme. If they live in the theme, switching themes makes that content disappear from the admin. The same loader works in a plugin. Use `plugin_dir_path( __FILE__ )` in place of `get_stylesheet_directory()`.

See [Custom Post Type Admin](/kb/wordpress/custom-post-type-admin/) for an example post type file.

Sources

- [developer.wordpress.org/themes/advanced-topics/child-themes](https://developer.wordpress.org/themes/advanced-topics/child-themes/)
- [developer.wordpress.org/reference/functions/get_theme_file_path](https://developer.wordpress.org/reference/functions/get_theme_file_path/)

Need help with WordPress?

Our notes can take you a long way, but sometimes you'd rather have someone who's done it before.

[Websites](/services/websites/)

[← PreviousRun WordPress cron from the system scheduler](/kb/wordpress/wordpress-cron/)[Next →WordPress database optimization queries](/kb/wordpress/database-optimization-queries/)

CC0This article is in the public domain ([CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/)), code samples included. Use it however helps you.

On this page

- [Pick the Right Path Function](#pick-the-right-path-function)
- [Loader Pattern](#loader-pattern)

[Back to top↑](#top)

Services

- [ERP implementation](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)

Resources

- [Our work](/work/)
- [Open source](/open-source/)
- [Knowledge base](/kb/)
- [Insights](/insights/)

Company

- [About](/about/)
- [Team](/about/team/)
- [Partners](/partners/)
- [Contact](/contact/)

Clients

- [Project portal](https://erp.avunu.net/projects)
- [Invoices](https://erp.avunu.net/)
- [Support](https://erp.avunu.net/)

[![Avunu](/brand/avunu-logo-light.svg)](/)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M20.400 20.500h-3.600v-5.600c0-1.300 0-3-1.800-3s-2.100 1.400-2.100 2.900v5.700H9.400V9h3.400v1.600c.5-.9 1.600-1.900 3.400-1.900 3.600 0 4.300 2.400 4.300 5.500v6.300zM5.300 7.400a2.100 2.100 0 1 1 0-4.100 2.100 2.100 0 0 1 0 4.100zm1.800 13.100H3.600V9h3.500v11.500zM22.200 0H1.800C.8 0 0 .8 0 1.700v20.600c0 .9.800 1.700 1.800 1.700h20.400c1 0 1.800-.8 1.800-1.700V1.700C24 .8 23.200 0 22.200 0z">\</path>\</svg>\</av-icon>](https://www.linkedin.com/company/avunu)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M12 .3a12 12 0 0 0-3.8 23.4c.6.1.8-.3.8-.6v-2c-3.3.7-4-1.6-4-1.6-.6-1.4-1.4-1.8-1.4-1.8-1-.7.1-.7.1-.7 1.2.1 1.8 1.2 1.8 1.2 1 1.8 2.8 1.3 3.5 1 .1-.8.4-1.3.7-1.6-2.7-.3-5.5-1.3-5.5-5.9 0-1.3.5-2.4 1.2-3.2-.1-.3-.5-1.5.1-3.2 0 0 1-.3 3.3 1.2a11.500 11.500 0 0 1 6 0c2.300-1.500 3.300-1.200 3.300-1.200.6 1.700.2 2.900.1 3.200.8.8 1.200 1.900 1.200 3.200 0 4.600-2.800 5.600-5.500 5.900.4.400.8 1.100.8 2.200v3.300c0 .3.2.7.8.6A12 12 0 0 0 12 .3">\</path>\</svg>\</av-icon>](https://github.com/Avunu)[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

Avunu LLC · 948 East Philadelphia Street, York, PA 17403 · (717) 814-8540Knowledge base articles are in the public domain[Privacy](/privacy/)[Terms](/terms/)
