WPBeginner

Beginner's Guide for WordPress

  • Blog
    • Beginners Guide
    • News
    • Opinion
    • Showcase
    • Themes
    • Tutorials
    • WordPress Plugins
  • Start Here
    • How to Start a Blog
    • Create a Website
    • Start an Online Store
    • Best Website Builder
    • Email Marketing
    • WordPress Hosting
    • Business Name Ideas
  • Deals
    • Bluehost Coupon
    • SiteGround Coupon
    • WP Engine Coupon
    • HostGator Coupon
    • Domain.com Coupon
    • Constant Contact
    • View All Deals »
  • Glossary
  • Videos
  • Products
X
☰
Beginner's Guide for WordPress / Start your WordPress Blog in minutes
Choosing the Best
WordPress Hosting
How to Easily
Install WordPress
Recommended
WordPress Plugins
View all Guides

WPBeginner» Blog» Themes» Beginner’s Guide to WordPress Template Hierarchy (Cheat Sheet)

Beginner’s Guide to WordPress Template Hierarchy (Cheat Sheet)

Last updated on December 1st, 2020 by Editorial Staff
232 Shares
Share
Tweet
Share
Pin
Free WordPress Video Tutorials on YouTube by WPBeginner
Beginner’s Guide to WordPress Template Hierarchy (Cheat Sheet)

After our infographic on how WordPress works behind the scenes, several users asked us to cover how a WordPress theme works behind the scenes.

In this article, we will explain the WordPress template hierarchy for beginners. This cheat sheet is extremely useful when customizing a template or creating a custom WordPress theme.

WordPress template hierarchy explained for beginners

Pro Tip: Want to create custom landing pages without changing your WordPress theme? Try SeedProd, it is the #1 ranked drag & drop WordPress page builder.

Why Learn About WordPress Template Hierarchy?

All modern WordPress themes consist of templates, stylesheets, javascript, and images. Together these files control how your site looks to the users.

Related: 9 things you must look for when selecting the perfect WordPress theme for your site.

WordPress has a standard template hierarchy. This means that templates with certain filenames affect specific areas on your website. It also tells you what template name to use for a specific item.

Most modern WordPress themes come with templates to display category, date, archives, single posts, custom pages, and more. As a user, you can create more templates by creating a child theme.

Having said that, let’s take a look at how this WordPress template hierarchy works behind the scenes.

Visualizing WordPress Template Hierarchy (Cheat Sheet)

WordPress uses an easy to understand and meaningful pattern for template names. The visual cheat sheet below explains which template files are used to display different pages on a WordPress site.

Here is a breakdown of which WordPress template files to edit for different pages in a typical WordPress site.

Which template files are used by home page?

Site front page

Out of the box, WordPress displays your blog posts on the home page of your website. You can also set it to use a custom home page (also known as front page) by visiting Settings » Reading page in WordPress admin area.

1. front-page.php – If you are using a static front page, then WordPress will first look for this template file and use it to display front page.

2. home.php – If you are using static front page, and you don’t have front-page.php template in your theme, then WordPress will look for home.php template. It is also used to display default blog posts on homepage.

3. index.php – If front-page.php or home.php do not exist, then WordPress falls back to index.php template to display homepage. This template is the default fallback template in WordPress to display any page.

Which template files are used by single post?

Single post page template

WordPress looks for these files to display a single post.

1. single-{post-type}-{slug}.php – Use this template to modify the display of a specific individual post in any post type. For example, if post type is ‘review’ and the post slug is acme-phone, then WordPress would look for single-review-acme-phone.php.

2. single-{post-type}.php – WordPress will then check if there is a template to display this specific post type. For example, if the post type is review, then WordPress would look for single-review.php.

3. single.php – WordPress will then fall back to single.php.

4. singular.php – This template adds another fallback to display a single item from any post type.

5. index.php – Finally, as mentioned above, WordPress ultimately falls back to index.php.

Which template files are used by single page?

Static page template

WordPress pages are one of the default post types. They allow you to create static pages in your website instead of posts. See our guide on the difference between posts vs pages.

1. Custom Page Template – The page template assigned to the page. See how to create a custom page template in WordPress.

2. page-{slug}.php – If the page slug is contact-us, WordPress will look to use page-contact-us.php.

3. page-{id}.php – If the page ID is 17, then WordPress will look for a template file named page-17.php.

4. page.php – The template to display all static pages.

5. singular.php – This template is a default fallback to all single post type items.

6. index.php – The default fallback template.

Which template files are used by category archives?

Category archive template

WordPress uses these files to display category related pages in WordPress.

1. category-{slug}.php – This template is used to display category archive page for a specific category. For example, if category slug is reviews, then WordPress will look for category-reviews.php template.

2. category-{id}.php – WordPress then looks for a template with category ID. For example, if category ID is 17, then WordPress will look for category-17.php.

3. category.php – This is the default template to display all category archive pages in WordPress.

4. archive.php – This is the default template used by WordPress to display any archive pages.

5. index.php – The default fallback template.

Which template files are used by tag archives?

Tag archive template

WordPress uses these files to display tag archive pages.

1. tag-{slug}.php – If the tag’s slug is fruits, WordPress will look for tag-fruits.php.

2. tag-{id}.php – If the tag’s ID is 17, WordPress will look for tag-17.php template.

3. tag.php – The default template for tag archives.

4. archive.php – The default template for any achive page.

5. index.php – The default fallback template.

Which template files are used by custom taxonomy archives?

Custom taxonomy archive

Categories and tags are two default WordPress taxonomies. Users can also create their own custom taxonomies as well. Here is how WordPress looks for templates to display custom taxonomy pages.

1. taxonomy-{taxonomy}-{term}.php – If you have a custom taxonomy called genre, and there is a term ‘thriller’, then WordPress will look for taxonomy-genre-thriller.php.

2. taxonomy-{taxonomy}.php – If the taxonomy were genre, WordPress would look for taxonomy-genre.php.

3. taxonomy.php – The default template to display any custom taxonomy archives.

4. archive.php – The default fallback for all archive pages in WordPress.

5. index.php– The default fallback template in WordPress.

Which template files are used by custom post types?

Custom post type archive

Here is how WordPress looks for templates to display custom post type archives.

1. archive-{post_type}.php – If you have a post type is review, WordPress will look for archive-review.php.

2. archive.php – The default template to display all archive pages in WordPress.

3. index.php – The default fallback template in WordPress.

Which template files are used to display author archives?

Author archive

WordPress generates archive pages for each author on your WordPress site. Here is how it looks for author archive template.

1. author-{nicename}.php – If the author’s nice name is matt, WordPress will look for author-matt.php.

2. author-{id}.php – If the author’s user ID is 6, then WordPress will look for author-6.php.

3. author.php – The default template used to display author archive pages in WordPress.

4. archive.php – The default template to display all archive pages in WordPress.

5. index.php – The default fallback template in WordPress.

Which template files are used to display date based archives?

Date based archive

WordPress also displays your posts on date based archive pages for months and years. Here is how it looks for templates for these pages.

1. date.php – The default template for date based archives.

2. archive.php – The default template used to display author archive pages in WordPress.

3. index.php – The default fallback template in WordPress.

Which template files are used to display search pages?

Search result page

1. search.php – The default page to display search results in WordPress.

2. searchform.php – The template to display a search form in WordPress.

3. index.php – The default fallback template in WordPress.

Which template files are used to display 404 error pages?

404 Error page

The 404 error page is displayed when WordPress is unable to find the requested content. See our guide on how to improve your 404 page template.

1. 404.php – The default template to display 404 error page in WordPress.

2. index.php – The default fallback template in WordPress.

Which template files are used to display attachment pages?

Attachment pages

1. MIME_type.php – Mime_type stands for file type. For example, image.php, video.php, application.php.

2. attachment.php – The default template to display attachment pages.

3. single-attachment.php – To display a single attachment.

4. single.php – The default template to display single post type items.

5. index.php – The default fallback template in WordPress.

Which template files are used to display embeds?

Embeds

Since WordPress 4.5, you can use templates to render a post embedded into WordPress.

1. embed-{post-type}-{post_format}.php – WordPress will look for a post type and post format template first. For example, if you have a review with video, then WordPress will look for embed-review-video.php.

2. embed-{post-type}.php – If the post type is review, WordPress would look for embed-review.php.

3. embed.php – The default fallback for all embeds.

We hope this tutorial helped you learn about the WordPress template hierarchy. You may also want to see our list of the best drag & drop WordPress page builders.

If you liked this article, then please subscribe to our YouTube Channel for WordPress video tutorials. You can also find us on Twitter and Facebook.

232 Shares
Share
Tweet
Share
Pin
Popular on WPBeginner Right Now!
  • How to Fix the Error Establishing a Database Connection in WordPress

    How to Fix the Error Establishing a Database Connection in WordPress

  • How to Start Your Own Podcast (Step by Step)

    How to Start Your Own Podcast (Step by Step)

  • Google Analytics in WordPress

    How to Install Google Analytics in WordPress for Beginners

  • How to Properly Move Your Blog from WordPress.com to WordPress.org

About the Editorial Staff

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi. Trusted by over 1.3 million readers worldwide.

The Ultimate WordPress Toolkit

2 Comments

Leave a Reply
  1. Connie says:
    May 13, 2019 at 8:16 am

    what about language files in children themes?
    This is one of the big mysteries in WP because there are still some people (the majority!) who need translation files to get their installation in their language ;=)

    Reply
    • WPBeginner Support says:
      May 13, 2019 at 2:23 pm

      That would be a subject for a different guide :)

      Reply

Leave a Reply Cancel reply

Thanks for choosing to leave a comment. Please keep in mind that all comments are moderated according to our comment policy, and your email address will NOT be published. Please Do NOT use keywords in the name field. Let's have a personal and meaningful conversation.

Over 1,320,000+ Readers

Get fresh content from WPBeginner

Featured WordPress Plugin
All in One SEO
Improve website SEO rankings with AIOSEO plugin. Learn More »
How to Start a Blog How to Start a Blog
I need help with ...
Starting a
Blog
WordPress
Performance
WordPress
Security
WordPress
SEO
WordPress
Errors
Building an
Online Store
Useful WordPress Guides
    • 7 Best WordPress Backup Plugins Compared (Pros and Cons)
    • How to Fix the Error Establishing a Database Connection in WordPress
    • Why You Need a CDN for your WordPress Blog? [Infographic]
    • 30 Legit Ways to Make Money Online Blogging with WordPress
    • Self Hosted WordPress.org vs. Free WordPress.com [Infograph]
    • Free Recording: WordPress Workshop for Beginners
    • 24 Must Have WordPress Plugins for Business Websites
    • How to Properly Move Your Blog from WordPress.com to WordPress.org
    • 5 Best Contact Form Plugins for WordPress Compared
    • Which is the Best WordPress Popup Plugin? (Comparison)
    • Best WooCommerce Hosting in 2021 (Comparison)
    • How to Fix the Internal Server Error in WordPress
    • How to Install WordPress - Complete WordPress Installation Tutorial
    • Why You Should Start Building an Email List Right Away
    • How to Properly Move WordPress to a New Domain Without Losing SEO
    • How to Choose the Best WordPress Hosting for Your Website
    • How to Choose the Best Blogging Platform (Comparison)
    • WordPress Tutorials - 200+ Step by Step WordPress Tutorials
    • 5 Best WordPress Ecommerce Plugins Compared
    • 5 Best WordPress Membership Plugins (Compared)
    • 7 Best Email Marketing Services for Small Business (2021)
    • How to Choose the Best Domain Registrar (Compared)
    • The Truth About Shared WordPress Web Hosting
    • When Do You Really Need Managed WordPress Hosting?
    • 5 Best Drag and Drop WordPress Page Builders Compared
    • How to Switch from Blogger to WordPress without Losing Google Rankings
    • How to Properly Switch From Wix to WordPress (Step by Step)
    • How to Properly Move from Weebly to WordPress (Step by Step)
    • Do You Really Need a VPS? Best WordPress VPS Hosting Compared
    • How to Properly Move from Squarespace to WordPress
    • How to Register a Domain Name (+ tip to get it for FREE)
    • HostGator Review - An Honest Look at Speed & Uptime (2021)
    • SiteGround Reviews from 4464 Users & Our Experts (2021)
    • Bluehost Review from Real Users + Performance Stats (2021)
    • How Much Does It Really Cost to Build a WordPress Website?
    • How to Create an Email Newsletter the RIGHT WAY (Step by Step)
    • Free Business Name Generator (A.I Powered)
    • How to Create a Free Business Email Address in 5 Minutes (Step by Step)
    • How to Install Google Analytics in WordPress for Beginners
    • How to Move WordPress to a New Host or Server With No Downtime
    • Why is WordPress Free? What are the Costs? What is the Catch?
    • How to Make a Website in 2021 – Step by Step Guide
Deals & Coupons (view all)
ProfilePress
ProfilePress Coupon
Get 20% OFF on ProfilePress WordPress ultimate user and profile plugin.
SendinBlue Coupon Code
Sendinblue Coupon
Get Sendinblue, a powerful marketing automation toolkit for small businesses, for FREE.
Featured In
About WPBeginner®

WPBeginner is a free WordPress resource site for Beginners. WPBeginner was founded in July 2009 by Syed Balkhi. The main goal of this site is to provide quality tips, tricks, hacks, and other WordPress resources that allows WordPress beginners to improve their site(s).

Join our team: We are Hiring!

Site Links
  • About Us
  • Contact Us
  • FTC Disclosure
  • Privacy Policy
  • Terms of Service
  • Free Blog Setup
  • Free Business Tools
  • Growth Fund
Our Sites
  • OptinMonster
  • MonsterInsights
  • WPForms
  • SeedProd
  • Nameboy
  • RafflePress
  • Smash Balloon
  • AIOSEO

Copyright © 2009 - 2021 WPBeginner LLC. All Rights Reserved. WPBeginner® is a registered trademark.

Managed by Awesome Motive | WordPress hosting by SiteGround | WordPress Security by Sucuri.