{"id":126254,"date":"2025-03-31T08:42:53","date_gmt":"2025-03-31T08:42:53","guid":{"rendered":"\/tutorials\/?p=126254"},"modified":"2025-04-23T08:30:14","modified_gmt":"2025-04-23T08:30:14","slug":"get_template_part","status":"publish","type":"post","link":"\/in\/tutorials\/get_template_part","title":{"rendered":"What is the get_template_part function and how to use it in WordPress\u00a0"},"content":{"rendered":"

Knowing how to customize your WordPress theme is a crucial step in shaping your site to match your vision. Key to helping you achieve this is the get_template_part()<\/strong> function, which allows you to embed parts of your template in various locations without duplicating code.<\/p>

This article will cover everything you need to know about get_template_part()<\/strong> ‒ what it is, how it works, and how to use it effectively. We’ll also highlight common mistakes to avoid along the way.<\/p>

\n\n\n\n\n\n\n<\/p>

What is get_template_part()<\/strong><\/h2>

The get_template_part()<\/strong> function loads reusable sections of your theme template.<\/p>

Using this WordPress function<\/a> helps keep your theme’s code clean and organized. Updates also become simpler ‒ make changes in one file, and they automatically update everywhere the template part is used.<\/p>

In a team environment, this allows developers to work on different parts of a theme at the same time without overwriting each others’ work. Plus, this function works with child themes, allowing for customization without modifying the parent theme’s files.<\/p>

\"\"<\/a><\/figure>

Understanding the relationship between themes and template parts<\/strong><\/h3>

In WordPress, themes control your site’s design and overall structure, while template parts are smaller PHP files<\/a> containing reusable sections of code.<\/p>

A theme will include various templates that display content, but most pages share common elements like headers and footers. These elements are called template parts.<\/p>

Instead of duplicating code across multiple files, you can move template parts into a separate file and use get_template_part() <\/strong>to call them whenever needed.<\/p>

How to use the get_template_part() function<\/strong><\/h2>

Here are various ways of using the WordPress template tag, depending on your theme’s structure.<\/p>

Using the get_template_part() function to call template parts<\/strong><\/h3>

The most basic way to use get_template_part()<\/strong> is to include a file name, like this:<\/p>

get_template_part( 'file-name' );<\/pre>
This method works best for incorporating template parts like headers, footers, and sidebars that are used often and don’t need customization for specific conditions.<\/p>
For example, if you include the following syntax in a page, it will include header.php<\/strong> from your theme’s root directory.<\/p>
get_template_part( 'header' );<\/pre>
Calling template parts within a directory using the get_template_part() function<\/strong><\/h3>
If the template part is stored in one of your theme’s subdirectories, add a parameter to the function as follows:<\/p>
get_template_part( 'folder-name\/file-name' );<\/pre>
For example, the syntax below tells WordPress to look for a file named content.php<\/strong> inside the template-parts<\/strong> directory of your theme.<\/p>
get_template_part( 'template-parts\/content' );<\/pre>
Calling fallback files using the get_template_part() function<\/strong><\/h3>
This method is useful when you want to call a preferred version of a template part, but you also want a backup version in case the first one doesn’t exist.<\/p>
Simply add parameters to the core function like this:<\/p>
get_template_part( 'default-file', 'target-file' );<\/pre>
The first parameter (‘default-file<\/strong>‘) specifies the base name of the template part to load, while the second parameter (‘target-file<\/strong>‘) serves as the suffix. WordPress will combine these two parameters and look for a file named default-file-target-file.php<\/strong>.<\/p>
If that file is missing, WordPress will fall back to the base name file instead of returning nothing.<\/p>
Here’s an example:<\/p>
get_template_part( 'template-parts\/content', 'post' );<\/pre>
WordPress first looks for content-post.php<\/strong> in the template-parts <\/strong>folder. If it doesn’t exist, WordPress automatically falls back and loads template-parts\/content.php<\/strong> from the same folder.<\/p>
Common mistakes in using the get_template_part() function<\/strong><\/h2>
The get_template_part()<\/strong> function is a powerful tool in WordPress, but it can present challenges. Here are some common issues users often face when working with this function:<\/p>
Incorrect file path<\/strong><\/p>
Misplacing template parts or failing to specify the correct file path can cause WordPress to think the file doesn’t exist. This usually happens when fetching template parts in folders.<\/p>
Check whether your code points to the right directory.<\/p>
Incorrect file naming conventions<\/strong><\/p>
If you don’t name your files correctly, WordPress won’t be able to find them. Make sure your file names match exactly, especially when using additional parameters like ‘post’ or ‘page.’<\/p>
Not using fallback files when needed<\/strong><\/p>
Your site can break if a template part is missing, so it’s crucial to have a backup file in place. For example, using content.php<\/strong> as a fallback ensures WordPress has a default option if it can’t locate content-post.php<\/strong>.<\/p>
Fetching non-reusable code<\/strong><\/p>
If you’re only using something once, don’t overcomplicate it by creating a template part. Only use the function for major sections like headers and footers.<\/p>
Not considering child themes<\/strong><\/p>
When using get_template_part()<\/strong> in the parent theme, WordPress will first look for the template part in the child theme.<\/p>
If you want to override a template part, do so in the child theme’s PHP file and leave the default version in the parent theme as is. This way, you can easily roll back if you change your mind or things don’t work out.<\/p>
Check out our article on creating a WordPress child theme<\/a> to learn how child themes work, and to find out how to set one up properly.<\/p>
Conclusion<\/strong><\/h2>
Using the get_template_part()<\/strong> function makes WordPress theme development easier. It’s also helpful for keeping your code lean and organized, which could benefit site performance.<\/p>
It’s easy to use and quite flexible, so give it a try in your next project and see how it enhances your workflow.<\/p>
We hope this article helped you understand how to make the most out of get_template_part()<\/strong>. Got any questions? Drop us a comment below.<\/p>
get_template_part() function FAQ<\/strong><\/h2>
What are the benefits of using get_template_part?<\/strong><\/h3> 
The get_template_part()<\/strong> function keeps your theme organized by avoiding duplicated code. Changes made in one template part will be up to date wherever it’s used. Additionally, it makes it easier for developers to work on different sections at the same time, and lets you customize child themes without changing the parent theme.<\/p> <\/div> 
How do I load multiple template parts using this function?<\/strong><\/h3> 
The simplest way to load multiple template parts with get_template_part()<\/strong> is to use the function multiple times in your template file, each time for a different section. WordPress will then load the appropriate part for each call.<\/p> <\/div> 
Is there a performance impact when using get_template_part?<\/strong><\/h3> 
Using get_template_part()<\/strong> doesn’t impact performance much since it helps organize your theme into smaller parts. However, it’s best to avoid overusing it – or misusing it on template parts that will only be used once – and keep your template parts simple. And don’t forget to enable caching<\/a> to optimize loading speed.<\/p> <\/div> <\/div>\n","protected":false},"excerpt":{"rendered":"
Knowing how to customize your WordPress theme is a crucial step in shaping your site to match your vision. Key to helping you achieve this is the get_template_part() function, which allows you to embed parts of your template in various locations without duplicating code. This article will cover everything you need to know about get_template_part() […]<\/p>\n
Read More…<\/a><\/p>\n","protected":false},"author":115,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"rank_math_title":"","rank_math_description":"","rank_math_focus_keyword":"","footnotes":""},"categories":[],"tags":[],"class_list":["post-126254","post","type-post","status-publish","format-standard","hentry"],"hreflangs":[{"locale":"en-US","link":"https:\/\/www.hostinger.com\/tutorials\/how-to-use-get-template-part-wordpress-function","default":0},{"locale":"en-UK","link":"https:\/\/www.hostinger.com\/uk\/tutorials\/get_template_part","default":0},{"locale":"en-IN","link":"https:\/\/www.hostinger.com\/in\/tutorials\/get_template_part","default":0},{"locale":"en-CA","link":"https:\/\/www.hostinger.com\/ca\/tutorials\/how-to-use-get-template-part-wordpress-function","default":0},{"locale":"en-PH","link":"https:\/\/www.hostinger.com\/ph\/tutorials\/how-to-use-get-template-part-wordpress-function","default":0},{"locale":"en-MY","link":"https:\/\/www.hostinger.com\/my\/tutorials\/how-to-use-get-template-part-wordpress-function","default":0},{"locale":"en-AU","link":"https:\/\/www.hostinger.com\/au\/tutorials\/how-to-use-get-template-part-wordpress-function","default":0},{"locale":"en-NG","link":"https:\/\/www.hostinger.com\/ng\/tutorials\/how-to-use-get-template-part-wordpress-function","default":0}],"_links":{"self":[{"href":"https:\/\/www.hostinger.com\/in\/tutorials\/wp-json\/wp\/v2\/posts\/126254","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hostinger.com\/in\/tutorials\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.hostinger.com\/in\/tutorials\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/in\/tutorials\/wp-json\/wp\/v2\/users\/115"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/in\/tutorials\/wp-json\/wp\/v2\/comments?post=126254"}],"version-history":[{"count":3,"href":"https:\/\/www.hostinger.com\/in\/tutorials\/wp-json\/wp\/v2\/posts\/126254\/revisions"}],"predecessor-version":[{"id":126276,"href":"https:\/\/www.hostinger.com\/in\/tutorials\/wp-json\/wp\/v2\/posts\/126254\/revisions\/126276"}],"wp:attachment":[{"href":"https:\/\/www.hostinger.com\/in\/tutorials\/wp-json\/wp\/v2\/media?parent=126254"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.hostinger.com\/in\/tutorials\/wp-json\/wp\/v2\/categories?post=126254"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.hostinger.com\/in\/tutorials\/wp-json\/wp\/v2\/tags?post=126254"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}