Create Custom Single Post Templates for Specific Posts or Sections in WordPress: A Comprehensive Guide

In WordPress, the single post template (single.php) controls how individual blog posts are displayed. By default, this template applies to all posts, ensuring consistency across your site. However, not all posts are created equal. A product review might need a star rating, specs table, and author bio; a portfolio piece might require a full-width gallery; a news article might need a featured video and social sharing bar. In such cases, the default template falls short.

Custom single post templates solve this problem by letting you design unique layouts for specific posts, categories, tags, or custom post types (CPTs). Whether you’re a developer comfortable with PHP or a beginner using page builders, this guide will walk you through every method to create, customize, and assign these templates. By the end, you’ll have the tools to tailor your posts’ appearance and functionality to match their content—boosting user engagement, reinforcing branding, and enhancing the overall user experience.

Table of Contents#

  1. Understanding Single Post Templates in WordPress

    • What Are Single Post Templates?
    • The WordPress Template Hierarchy
    • Why Avoid Editing the Parent Theme?

  2. Reasons to Use Custom Single Post Templates

    • Target Specific Post Types (e.g., Reviews, Portfolios)
    • Highlight Unique Content Sections (e.g., Specs, Galleries)
    • Brand Consistency Across Sections
    • Integrate Third-Party Tools (e.g., Maps, Calculators)
    • Improve UX and SEO

  3. Methods to Create Custom Single Post Templates

    • Method 1: Manual Coding (PHP/HTML/CSS)
    • Method 2: Using Page Builders (No-Code)
    • Method 3: Using Dedicated Plugins

  4. Method 1: Manual Coding (For Developers/Intermediate Users)

    • Step 1: Set Up a Child Theme
    • Step 2: Create a Custom Template File
    • Step 3: Add the Template Header Comment
    • Step 4: Copy and Customize Code from single.php
    • Step 5: Target Specific Posts or Sections with Conditional Tags
    • Step 6: Style with Custom CSS
    • Step 7: Test and Deploy

  5. Method 2: Using Page Builders (For Beginners/Visual Editors)

    • Example: Elementor Pro
    • Example: Beaver Builder
    • Pros and Cons of Page Builders

  6. Method 3: Using Dedicated Plugins

    • Plugin 1: Single Post Template by Satrya
    • Plugin 2: Custom Post Type UI + Template Library Plugins
    • How to Assign Templates with Plugins

  7. Advanced Tips for Custom Single Post Templates

    • Integrate Custom Fields (Advanced Custom Fields)
    • Combine with Custom Post Types (CPTs)
    • Add Conditional Logic for Dynamic Content
    • Use Hooks and Filters for Further Customization
    • Ensure Responsiveness

  8. Troubleshooting Common Issues

    • Template Not Loading? Check the File Name/Header
    • Styling Conflicts: CSS Specificity and !important
    • Conditional Tags Not Working? Debugging Tips
    • White Screen of Death (WSOD): Enable Debug Mode
    • Plugin/Builder Conflicts

  9. Conclusion

  10. References

1. Understanding Single Post Templates in WordPress#

What Are Single Post Templates?#

A single post template is a PHP file that defines the layout and structure of individual blog posts in WordPress. When a user visits a post (e.g., yoursite.com/2024/05/my-post), WordPress loads this template to display the post’s title, content, metadata, comments, and other elements.

By default, most themes use single.php as the primary template for all posts. However, WordPress allows you to create custom single post templates to override this default behavior for specific posts, categories, tags, or custom post types.

The WordPress Template Hierarchy#

WordPress follows a strict template hierarchy to determine which file to load for different content types. For single posts, the hierarchy is:

  1. single-{post-type}-{slug}.php (Most specific: e.g., single-product-review.php for a CPT "product-review" with slug "laptop-x")
  2. single-{post-type}.php (Targets all posts of a custom post type: e.g., single-product.php)
  3. single.php (Default for all posts)
  4. index.php (Fallback if no other template exists)

Custom single post templates leverage this hierarchy. For example, creating single-category-reviews.php would target all posts in the "reviews" category.

Why Avoid Editing the Parent Theme?#

Never edit the parent theme’s single.php or other template files directly. When the theme updates, your changes will be overwritten. Instead, use a child theme—a separate theme that inherits styles and functionality from the parent but allows safe customizations.

2. Reasons to Use Custom Single Post Templates#

Target Specific Post Types#

If you run a site with multiple content types (e.g., blog posts, product reviews, portfolio items), custom templates ensure each type has a tailored layout. For example:

  • A review post might need a star rating, pros/cons list, and specs table.
  • A portfolio post might prioritize a full-width image gallery and client testimonials.

Highlight Unique Content Sections#

Default templates often limit you to title, content, and metadata. Custom templates let you add dynamic sections:

  • Event posts: Add a countdown timer or registration form.
  • Recipe posts: Include a ingredients list, prep time, and nutrition facts.

Brand Consistency Across Sections#

Different sections of your site (e.g., "News" vs. "Case Studies") may require distinct branding. Custom templates let you adjust colors, fonts, and layouts to match section-specific brand guidelines.

Integrate Third-Party Tools#

Embed tools like Google Maps (for location-based posts), Calendly (for booking), or interactive calculators (for financial posts) directly into templates, ensuring they appear consistently for targeted content.

Improve UX and SEO#

A well-designed template reduces bounce rates by making content easier to digest. For SEO, you can optimize templates to include schema markup (e.g., review schema for product posts) or highlight key keywords in prominent sections.

3. Methods to Create Custom Single Post Templates#

There are three primary methods to create custom single post templates, each suited to different skill levels:

MethodSkill LevelBest ForProsCons
Manual CodingIntermediate/AdvancedFull control, no plugin dependenciesHighly customizable, lightweightRequires PHP/CSS knowledge
Page BuildersBeginner/VisualNo coding, drag-and-drop editingVisual, fast, no technical skillsMay slow down site; dependent on plugins
Dedicated PluginsBeginner/IntermediateSimple template assignmentEasy to use, minimal setupLimited customization; plugin reliance

4. Method 1: Manual Coding (For Developers/Intermediate Users)#

This method involves creating a custom PHP file in your child theme and using conditional logic to target specific posts or sections.

Step 1: Set Up a Child Theme#

If you don’t already have a child theme, create one:

  1. In wp-content/themes/, create a new folder (e.g., twentytwentyfour-child).
  2. Inside it, create style.css with the following header: 
    /*  
Theme Name: Twenty Twenty-Four Child  
Theme URI: https://yoursite.com/  
Description: Child theme for Twenty Twenty-Four  
Author: Your Name  
Author URI: https://yoursite.com/  
Template: twentytwentyfour  
Version: 1.0  
*/
  3. Create functions.php and enqueue the parent theme’s styles: 
    <?php  
add_action( 'wp_enqueue_scripts', 'enqueue_parent_styles' );  
function enqueue_parent_styles() {  
    wp_enqueue_style( 'parent-style', get_template_directory_uri().'/style.css' );  
}  
?>
  4. Activate the child theme via Appearance > Themes.

Step 2: Create a Custom Template File#

In your child theme folder, create a new PHP file. Name it based on what it targets:

  • single-review.php (for "reviews" category)
  • single-postid-123.php (for post with ID 123)
  • single-featured.php (for posts with a "featured" custom field)

Step 3: Add the Template Header Comment#

At the top of your new file, add a comment to register it as a template. This is required for WordPress to recognize it:

<?php  
/**  
 * Template Name: Custom Review Template  
 * Template Post Type: post, product-review (if using CPTs)  
 */  
?>
  • Template Name: A human-readable name (appears in the post editor if using plugins).
  • Template Post Type: Specify post types this template applies to (default: post).

Step 4: Copy and Customize Code from single.php#

Copy the contents of the parent theme’s single.php into your new template file. This ensures core functionality (e.g., post title, content, comments) is preserved. Then customize:

Example: Adding a Review Section
Original single.php might have:

<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>  
    <header class="entry-header">  
        <?php the_title( '<h1 class="entry-title">', '</h1>' ); ?>  
    </header><!-- .entry-header -->  
 
    <div class="entry-content">  
        <?php the_content(); ?>  
    </div><!-- .entry-content -->  
</article><!-- #post-<?php the_ID(); ?> -->

Customize it to add a review-specific section:

<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>  
    <header class="entry-header">  
        <?php the_title( '<h1 class="entry-title">', '</h1>' ); ?>  
        <!-- Add Star Rating -->  
        <div class="review-rating">  
            <?php echo get_post_meta( get_the_ID(), 'star_rating', true ); ?>/5 Stars  
        </div>  
    </header><!-- .entry-header -->  
 
    <div class="entry-content">  
        <!-- Add Pros/Cons List -->  
        <div class="pros-cons">  
            <h3>Pros</h3>  
            <ul><?php echo get_post_meta( get_the_ID(), 'pros', true ); ?></ul>  
            <h3>Cons</h3>  
            <ul><?php echo get_post_meta( get_the_ID(), 'cons', true ); ?></ul>  
        </div>  
 
        <?php the_content(); ?>  
 
        <!-- Add Specs Table -->  
        <div class="review-specs">  
            <h3>Specifications</h3>  
            <?php echo get_post_meta( get_the_ID(), 'specs_table', true ); ?>  
        </div>  
    </div><!-- .entry-content -->  
</article><!-- #post-<?php the_ID(); ?> -->

Step 5: Target Specific Posts or Sections with Conditional Tags#

To ensure your template only loads for specific posts/sections, use WordPress conditional tags. Add these at the top of your template file (before the HTML output).

Example 1: Target a Specific Post by ID#

<?php  
/**  
 * Template Name: Custom Post ID Template  
 */  
// Check if the post ID is 123  
if ( get_the_ID() == 123 ) {  
    // Load the custom template  
} else {  
    // Fallback to default single.php  
    get_template_part( 'single' );  
    exit;  
}  
?>

Example 2: Target a Category#

<?php  
/**  
 * Template Name: Reviews Category Template  
 */  
// Check if post is in the "reviews" category  
if ( in_category( 'reviews' ) ) {  
    // Proceed with custom template  
} else {  
    get_template_part( 'single' );  
    exit;  
}  
?>

Example 3: Target a Custom Post Type (CPT)#

If you have a CPT called "portfolio", create single-portfolio.php (WordPress auto-detects this via the hierarchy). No conditional tags needed!

Example 4: Target Posts with a Custom Field#

Use get_post_meta() to check for a custom field (e.g., "is_featured" set to "yes"):

<?php  
/**  
 * Template Name: Featured Post Template  
 */  
$is_featured = get_post_meta( get_the_ID(), 'is_featured', true );  
if ( $is_featured === 'yes' ) {  
    // Load custom template  
} else {  
    get_template_part( 'single' );  
    exit;  
}  
?>

Step 6: Style with Custom CSS#

Add custom CSS to your child theme’s style.css to style the new sections:

/* Review Rating */  
.review-rating {  
    color: #ffc107;  
    font-size: 1.5rem;  
    margin: 1rem 0;  
}  
 
/* Pros/Cons List */  
.pros-cons {  
    display: flex;  
    gap: 2rem;  
    margin: 2rem 0;  
}  
.pros-cons h3 {  
    color: #2c3e50;  
}  
.pros-cons ul {  
    list-style-type: none;  
    padding: 0;  
}  
.pros-cons li {  
    padding: 0.5rem 0;  
}  
 
/* Specs Table */  
.review-specs table {  
    width: 100%;  
    border-collapse: collapse;  
    margin: 2rem 0;  
}  
.review-specs th, .review-specs td {  
    padding: 1rem;  
    border: 1px solid #ddd;  
}

Step 7: Test and Deploy#

  1. Save your template file and CSS changes.
  2. Visit the target post(s) to ensure the template loads correctly.
  3. Test responsiveness (mobile, tablet, desktop) and cross-browser compatibility.

5. Method 2: Using Page Builders (For Beginners/Visual Editors)#

Page builders like Elementor, Beaver Builder, or Divi let you create custom templates visually, with no coding required. We’ll use Elementor Pro as an example.

Example: Elementor Pro#

Step 1: Install Elementor Pro#

  1. Purchase Elementor Pro (required for theme builder features).
  2. Install and activate the plugin via Plugins > Add New.

Step 2: Create a Single Post Template#

  1. Go to Templates > Theme Builder in the WordPress dashboard.
  2. Click Add New Template and select "Single Post" from the dropdown. Name it (e.g., "Review Template").
  3. Click Create Template to launch the Elementor editor.

Step 3: Design the Template Visually#

Use Elementor’s drag-and-drop widgets to build your layout:

  • Add a "Post Title" widget for the title.
  • Add a "Star Rating" widget (Elementor Pro) for reviews.
  • Use "Text Editor" or "Custom HTML" widgets for pros/cons.
  • Add a "Table" widget for specs.
  • Include dynamic widgets like "Post Content" to pull the main post body.

Step 4: Assign the Template to Specific Posts/Sections#

  1. Click the Conditions tab (bottom-left of the editor).
  2. Under "Include", select:
    • "Singular" > "Post" > "Specific Posts" (to target by ID).
    • "Category" > "Reviews" (to target a category).
    • "Custom Post Type" > "Portfolio" (to target a CPT).
  3. Click Save & Close.

Example: Beaver Builder#

Similar to Elementor, Beaver Builder lets you create templates via Beaver Builder > Templates > Add New. Use the "Themer" add-on to assign templates to posts/categories.

Pros and Cons of Page Builders#

Pros:

  • No coding required; visual, intuitive design.
  • Fast setup for beginners.
  • Built-in dynamic content support.

Cons:

  • Can slow down your site (extra CSS/JS files).
  • Dependent on the plugin; deactivating it breaks templates.
  • Limited control over PHP logic compared to manual coding.

6. Method 3: Using Dedicated Plugins#

Plugins simplify template creation and assignment, making them ideal for users who want a balance of ease and control.

Plugin 1: Single Post Template by Satrya#

This lightweight plugin lets you create custom templates and assign them to posts via the post editor.

Step 1: Install the Plugin#

  1. Go to Plugins > Add New and search for "Single Post Template".
  2. Install and activate the plugin by Satrya.

Step 2: Create a Template File#

  1. In your child theme, create a new template file (e.g., single-template-reviews.php) with the header comment: 
    <?php  
/*  
Template Name: Reviews Template  
Template Post Type: post  
*/  
// Copy code from single.php and customize (as in Method 1)  
?>

Step 3: Assign the Template to Posts#

  1. Edit a post and scroll to the "Post Attributes" meta box.
  2. Select your custom template from the "Template" dropdown.
  3. Update the post.

Plugin 2: Custom Post Type UI + Template Library Plugins#

For custom post types, use "Custom Post Type UI" to register a CPT (e.g., "product"), then use a template library plugin like "Elementor" or "Divi" to design and assign templates.

7. Advanced Tips for Custom Single Post Templates#

Integrate Custom Fields (Advanced Custom Fields)#

Use the Advanced Custom Fields (ACF) plugin to add dynamic, editable fields to your templates. For example:

  1. Create a "Star Rating" field in ACF.
  2. In your template, display it with: 
    <?php the_field( 'star_rating' ); ?>

Combine with Custom Post Types (CPTs)#

Register a CPT (e.g., "recipe") using Custom Post Type UI, then create a template single-recipe.php to target all recipe posts automatically (via the template hierarchy).

Add Conditional Logic for Dynamic Content#

Use PHP or plugins like Conditional Fields for ACF to show/hide sections based on user input. For example:

<?php if ( get_field( 'has_video' ) == 'yes' ): ?>  
    <div class="post-video">  
        <?php the_field( 'video_url' ); ?>  
    </div>  
<?php endif; ?>

Use Hooks and Filters for Further Customization#

WordPress hooks let you modify templates without editing files directly. For example, add a custom section after the post content:

add_action( 'after_entry_content', 'add_custom_section' );  
function add_custom_section() {  
    if ( in_category( 'reviews' ) ) {  
        echo '<div class="custom-section">This is a review-specific section!</div>';  
    }  
}

Ensure Responsiveness#

Test templates on mobile devices and use CSS media queries to adjust layouts:

@media (max-width: 768px) {  
    .pros-cons {  
        flex-direction: column; /* Stack pros/cons on mobile */  
    }  
}

8. Troubleshooting Common Issues#

Template Not Loading?#

  • Check the file name: Ensure it follows the hierarchy (e.g., single-category-reviews.php for categories).
  • Verify the header comment: Missing Template Name or Template Post Type can cause issues.
  • Child theme active?: Templates must be in the child theme, not the parent.

Styling Conflicts#

  • Use browser dev tools (F12) to inspect elements and identify conflicting CSS.
  • Increase specificity (e.g., .review-template .entry-title instead of .entry-title).
  • Avoid overusing !important—it can make future changes harder.

Conditional Tags Not Working?#

  • Use var_dump( get_the_ID() ); or var_dump( in_category( 'reviews' ) ); to debug tag values.
  • Ensure tags are placed inside the loop or use global $post; to access the post object.

White Screen of Death (WSOD)#

  • Enable WordPress debug mode by adding define( 'WP_DEBUG', true ); to wp-config.php to see errors.
  • Check for syntax errors in PHP code (e.g., missing ; or }).

Plugin/Builder Conflicts#

  • Deactivate other plugins temporarily to identify conflicts.
  • Ensure page builders/plugins are updated to the latest version.

9. Conclusion#

Custom single post templates empower you to tailor WordPress posts to your unique needs, whether you’re a developer coding manually, a beginner using page builders, or someone relying on plugins. By following the methods outlined above, you can create targeted layouts that enhance user experience, reinforce branding, and make your content stand out.

Remember: Always use a child theme, test changes in a staging environment, and back up your site before making customizations. With the right approach, custom templates will transform your site from generic to professional and personalized.

10. References#

Introduction#

In the world of WordPress, flexibility is key. While default themes offer a solid foundation for displaying content, they often fall short when you need to tailor the look and feel of specific posts or sections. Whether you run a review site, a portfolio, a news portal, or a multi-category blog, custom single post templates empower you to design unique layouts for different content types—without disrupting your site’s overall design.

Imagine a food blog where recipe posts need ingredient lists and nutrition tables, while travel posts require photo galleries and location maps. Or a business site where case studies demand client testimonials and ROI metrics, separate from standard blog posts. Custom single post templates make these scenarios possible, enhancing user experience (UX), reinforcing branding, and even boosting SEO by highlighting key content.

This guide will walk you through everything you need to know to create custom single post templates in WordPress, from understanding the basics to advanced customization techniques. Whether you’re a developer comfortable with code or a beginner using visual tools, we’ve got you covered.

Table of Contents#

  1. Understanding Single Post Templates in WordPress

    • What Are Single Post Templates?
    • The WordPress Template Hierarchy
    • Why Avoid Editing the Parent Theme?

  2. Reasons to Use Custom Single Post Templates

    • Target Specific Post Types (e.g., Reviews, Portfolios)
    • Highlight Unique Content Sections (e.g., Specs, Galleries)
    • Brand Consistency Across Sections
    • Integrate Third-Party Tools (e.g., Maps, Calculators)
    • Improve UX and SEO

  3. Methods to Create Custom Single Post Templates

    • Method 1: Manual Coding (PHP/HTML/CSS)
    • Method 2: Using Page Builders (No-Code)
    • Method 3: Using Dedicated Plugins

  4. Method 1: Manual Coding (For Developers/Intermediate Users)

    • Step 1: Set Up a Child Theme
    • Step 2: Create a New Template File
    • Step 3: Add the Template Header Comment
    • Step 4: Copy and Customize Code from single.php
    • Step 5: Target Specific Posts/Sections with Conditional Tags
    • Step 6: Style with Custom CSS
    • Step 7: Test and Deploy

  5. Method 2: Using Page Builders (For Beginners/Visual Editors)

    • Example: Elementor Pro
    • Example: Beaver Builder
    • Pros and Cons of Page Builders

  6. Method 3: Using Dedicated Plugins

    • Plugin 1: Single Post Template by Satrya
    • Plugin 2: Custom Post Type UI + Template Library Plugins
    • Assigning Templates with Plugins

  7. Advanced Tips for Custom Single Post Templates

    • Integrate Custom Fields (Advanced Custom Fields)
    • Combine with Custom Post Types (CPTs)
    • Add Conditional Logic for Dynamic Content
    • Use Hooks and Filters for Further Customization
    • Ensure Responsiveness

  8. Troubleshooting Common Issues

    • Template Not Loading? Check File Names/Headers
    • Styling Conflicts: CSS Specificity and !important
    • Conditional Tags Not Working? Debugging Tips
    • White Screen of Death (WSOD): Enable Debug Mode
    • Plugin/Builder Conflicts

  9. Conclusion

  10. References

1. Understanding Single Post Templates in WordPress#

What Are Single Post Templates?#

A single post template is a PHP file that defines the structure and design of individual blog posts (e.g., yoursite.com/blog/my-first-post). It controls elements like the post title, content, metadata (date, author), comments, and any additional sections (e.g., related posts).

By default, WordPress uses single.php (located in your theme folder) as the template for all single posts. However, you can create custom single post templates to override this default for specific posts, categories, tags, or custom post types (CPTs).

The WordPress Template Hierarchy#

WordPress follows a strict template hierarchy to determine which file to load for different content types. For single posts, the hierarchy is:

  1. single-{post-type}-{slug}.php (Most specific: e.g., single-product-laptop-x.php for a CPT "product" with slug "laptop-x")
  2. single-{post-type}.php (Targets all posts of a custom post type: e.g., single-portfolio.php)
  3. single.php (Default for all standard posts)
  4. index.php (Fallback if no other template exists)

This hierarchy lets you create highly specific templates. For example, single-category-reviews.php will automatically load for all posts in the "reviews" category, bypassing single.php.

Why Avoid Editing the Parent Theme?#

Never modify the parent theme’s single.php or other template files directly. When the theme updates, your changes will be overwritten. Instead, use a child theme—a separate theme that inherits styles and functionality from the parent while allowing safe customizations.

2. Reasons to Use Custom Single Post Templates#

Target Specific Post Types#

If your site includes diverse content (e.g., blog posts, product reviews, portfolio items), custom templates ensure each type has a tailored layout:

  • Reviews: Star ratings, pros/cons lists, and specs tables.
  • Portfolio: Full-width image galleries and client testimonials.
  • Events: Countdown timers, location maps, and registration forms.

Highlight Unique Content Sections#

Default templates limit you to basic title-content-metadata structures. Custom templates let you add dynamic sections:

  • Recipes: Ingredients lists, prep time, and nutrition facts.
  • Tutorials: Step-by-step instructions with screenshots.
  • News: Breaking news banners or author bios with social links.

Brand Consistency Across Sections#

Different site sections (e.g., "Case Studies" vs. "Blog") may require distinct branding. Custom templates let you adjust colors, fonts, and layouts to match section-specific guidelines. For example, a "Press Releases" section might use a more formal font and muted color scheme, while "Success Stories" use vibrant accents.

Integrate Third-Party Tools#

Embed tools like Google Maps (for travel posts), Calendly (for booking), or interactive calculators (for financial posts) directly into templates, ensuring they appear consistently for targeted content.

Improve UX and SEO#

A well-designed template reduces bounce rates by making content easier to digest. For SEO, you can optimize templates to include schema markup (e.g., review schema for product posts) or highlight key keywords in prominent sections (e.g., H2 headings for "best laptop 2024").

3. Methods to Create Custom Single Post Templates#

There are three primary methods to create custom single post templates, each suited to different skill levels:

MethodSkill LevelBest ForProsCons
Manual CodingIntermediate/AdvancedFull control, no plugin dependenciesHighly customizable, lightweightRequires PHP/CSS knowledge
Page BuildersBeginner/VisualNo coding, drag-and-drop editingIntuitive, fast, visual designPotential performance issues; plugin reliance
Dedicated PluginsBeginner/IntermediateSimple template assignmentEasy setup, minimal technical skillLimited customization; dependent on plugins

4. Method 1: Manual Coding (For Developers/Intermediate Users)#

This method involves creating a custom PHP file in your child theme and using conditional logic to target specific posts or sections. It offers full control and is lightweight (no plugin bloat).

Step 1: Set Up a Child Theme#

If you don’t have a child theme, create one:

  1. Create a child theme folder: In wp-content/themes/, make a new folder (e.g., twentytwentyfour-child).

  2. Add style.css: Inside the folder, create style.css with this header (replace placeholders):

    /*  
Theme Name: Twenty Twenty-Four Child  
Theme URI: https://yoursite.com/  
Description: Child theme for Twenty Twenty-Four  
Author: Your Name  
Author URI: https://yoursite.com/  
Template: twentytwentyfour  
Version: 1.0  
*/

  3. Add functions.php: Create functions.php to enqueue the parent theme’s styles:

    <?php  
add_action( 'wp_enqueue_scripts', 'enqueue_parent_styles' );  
function enqueue_parent_styles() {  
    wp_enqueue_style( 'parent-style', get_template_directory_uri().'/style.css' );  
}  
?>

  4. Activate the child theme: Go to Appearance > Themes and activate your child theme.

Step 2: Create a New Template File#

In your child theme folder, create a new PHP file. Name it based on what it targets:

  • single-review.php (for "reviews" category)
  • single-postid-123.php (for post with ID 123)
  • single-featured.php (for posts with a "featured" custom field)

Step 3: Add the Template Header Comment#

At the top of your new file, add a comment to register it as a template. This tells WordPress the template’s name and which post types it applies to:

<?php  
/**  
 * Template Name: Custom Review Template  
 * Template Post Type: post, review (add CPTs here if needed)  
 */  
?>
  • Template Name: A human-readable name (appears in the post editor if using plugins).
  • Template Post Type: Specify post types (e.g., post, review, portfolio).

Step 4: Copy and Customize Code from single.php#

To build your custom template, start by copying the contents of the parent theme’s single.php (found in wp-content/themes/your-parent-theme/). This ensures you retain core functionality (e.g., post loop, comments).

Example: Customizing for Reviews
Original single.php might look like this:

<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>  
    <header class="entry-header">  
        <?php the_title( '<h1 class="entry-title">', '</h1>' ); ?>  
        <div class="entry-meta">  
            <?php the_date(); ?> by <?php the_author(); ?>  
        </div>  
    </header><!-- .entry-header -->  
 
    <div class="entry-content">  
        <?php the_content(); ?>  
    </div><!-- .entry-content -->  
 
    <footer class="entry-footer">  
        <?php comments_template(); ?>  
    </footer><!-- .entry-footer -->  
</article><!-- #post-<?php the_ID(); ?> -->

Customize it to add review-specific sections:

<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>  
    <header class="entry-header">  
        <?php the_title( '<h1 class="entry-title">', '</h1>' ); ?>  
        <div class="entry-meta">  
            <?php the_date(); ?> by <?php the_author(); ?>  
        </div>  
 
        <!-- Star Rating (from custom field) -->  
        <div class="review-rating">  
            <?php echo get_post_meta( get_the_ID(), 'star_rating', true ); ?>/5 Stars  
        </div>  
    </header><!-- .entry-header -->  
 
    <div class="entry-content">  
        <!-- Pros/Cons List (from custom fields) -->  
        <div class="pros-cons">  
            <div class="pros">  
                <h3>Pros</h3>  
                <ul><?php echo get_post_meta( get_the_ID(), 'pros', true ); ?></ul>  
            </div>  
            <div class="cons">  
                <h3>Cons</h3>  
                <ul><?php echo get_post_meta( get_the_ID(), 'cons', true ); ?></ul>  
            </div>  
        </div>  
 
        <!-- Main Post Content -->  
        <?php the_content(); ?>  
 
        <!-- Specs Table (from custom field) -->  
        <div class="review-specs">  
            <h3>Specifications</h3>  
            <?php echo get_post_meta( get_the_ID(), 'specs_table', true ); ?>  
        </div>  
    </div><!-- .entry-content -->  
 
    <footer class="entry-footer">  
        <?php comments_template(); ?>  
    </footer><!-- .entry-footer -->  
</article><!-- #post-<?php the_ID(); ?> -->

Step 5: Target Specific Posts/Sections with Conditional Tags#

To ensure your template loads only for the intended posts/sections, use WordPress conditional tags at the top of your template file (before the HTML output).

Example 1: Target a Specific Post by ID#

<?php  
/**  
 * Template Name: Custom Post ID Template  
 */  
// Get the current post ID  
global $post;  
$post_id = $post->ID;  
 
// Load template only for post ID 123  
if ( $post_id == 123 ) {  
    // Proceed with custom template code (from Step 4)  
} else {  
    // Fallback to default single.php  
    get_template_part( 'single' );  
    exit;  
}  
?>

Example 2: Target a Category#

<?php  
/**  
 * Template Name: Reviews Category Template  
 */  
// Load template only for posts in "reviews" category  
if ( in_category( 'reviews' ) ) {  
    // Custom template code here  
} else {  
    get_template_part( 'single' );  
    exit;  
}  
?>

Example 3: Target a Custom Post Type (CPT)#

If you have a CPT named "portfolio", create single-portfolio.php (WordPress auto-detects this via the hierarchy, no conditional tags needed!).

Step 6: Style with Custom CSS#

Add CSS to your child theme’s style.css to style new sections:

/* Review Rating */  
.review-rating {  
    color: #ffc107; /* Gold */  
    font-size: 1.8rem;  
    margin: 1rem 0;  
}  
 
/* Pros/Cons Layout */  
.pros-cons {  
    display: flex;  
    gap: 2rem;  
    margin: 2rem 0;  
    padding: 1rem;  
    background: #f8f9fa;  
    border-radius: 8px;  
}  
.pros, .cons {  
    flex: 1;  
}  
.pros h3, .cons h3 {  
    color: #2c3e50;  
    margin-top: 0;  
}  
.pros ul, .cons ul {  
    list-style-type: none;  
    padding: 0;  
}  
.pros li, .cons li {  
    padding: 0.5rem 0;  
    position: relative;  
    padding-left: 1.5rem;  
}  
.pros li:before {  
    content: "✓";  
    color: #2ecc71;  
    position: absolute;  
    left: 0;  
}  
.cons li:before {  
    content: "✗";  
    color: #e74c3c;  
    position: absolute;  
    left: 0;  
}  
 
/* Specs Table */  
.review-specs table {  
    width: 100%;  
    border-collapse: collapse;  
    margin: 2rem 0;  
}  
.review-specs th, .review-specs td {  
    padding: 1rem;  
    border: 1px solid #ddd;  
}  
.review-specs th {  
    background: #f8f9fa;  
    font-weight: bold;  
}

Step 7: Test and Deploy#

  1. Save your template file and CSS changes.
  2. Visit the target post(s) to confirm the template loads correctly.
  3. Test responsiveness (mobile/tablet) using browser dev tools (F12).
  4. Check for errors (e.g., missing custom fields) and refine as needed.

5. Method 2: Using Page Builders (For Beginners/Visual Editors)#

Page builders like Elementor, Beaver Builder, or Divi let you create custom templates visually, with no coding required. We’ll use Elementor Pro as an example (the free version lacks theme builder features).

Example: Elementor Pro#

Step 1: Install Elementor Pro#

  1. Purchase Elementor Pro (required for theme builder access).
  2. Install and activate the plugin via Plugins > Add New.

Step 2: Create a Single Post Template#

  1. Go to Templates > Theme Builder in the WordPress dashboard.
  2. Click Add New Template and select "Single Post" from the dropdown. Name it (e.g., "Review Template").
  3. Click Create Template to launch the Elementor editor.

Step 3: Design the Template Visually#

Use Elementor’s drag-and-drop widgets to build your layout:

  • Post Title: Add a "Post Title" widget for the title.
  • Star Rating: Use the "Star Rating" widget (Elementor Pro) and set it to pull from a custom field.
  • Pros/Cons: Use "Text Editor" widgets with bullet lists, styled with Elementor’s design settings.
  • Specs Table: Add a "Table" widget and input headers (e.g., "Feature", "Details").
  • Post Content: Add a "Post Content" widget to pull the main post body.

Step 4: Assign the Template to Specific Posts/Sections#

  1. Click the Conditions tab (bottom-left of the editor).
  2. Under "Include", select:
    • Specific Posts: Target by post ID (e.g., posts 123, 456).
    • Category: Target all posts in the "reviews" category.
    • Custom Post Type: Target a CPT like "portfolio".
  3. Click Save & Close.

Example: Beaver Builder#

Similar to Elementor, Beaver Builder’s "Themer" add-on lets you create templates:

  1. Go to Beaver Builder > Themer Layouts > Add New.
  2. Select "Single Post" as the layout type.
  3. Design with Beaver Builder’s modules, then assign via "Location" settings (categories, posts, etc.).

Pros and Cons of Page Builders#

Pros:

  • No coding required; ideal for beginners.
  • Visual, real-time editing.
  • Built-in dynamic content support (e.g., post title, custom fields).

Cons:

  • Can slow down your site (extra CSS/JS files).
  • Dependent on the plugin; deactivating it breaks templates.
  • Less control over PHP logic compared to manual coding.

6. Method 3: Using Dedicated Plugins#

Plugins simplify template creation and assignment, making them ideal for users who want a balance of ease and control.

Plugin 1: Single Post Template by Satrya#

This lightweight plugin lets you create custom templates and assign them to posts via the post editor.

Step 1: Install the Plugin#

  1. Go to Plugins > Add New and search for "Single Post Template" by Satrya.
  2. Install and activate the plugin.

Step 2: Create a Template File#

  1. In your child theme, create a new template file (e.g., single-template-reviews.php) with the header comment: 
    <?php  
/*  
Template Name: Reviews Template  
Template Post Type: post  
*/  
// Copy code from single.php and customize (as in Method 1)  
?>

Step 3: Assign the Template to Posts#

  1. Edit a post and scroll to the "Post Attributes" meta box (right sidebar).
  2. Select your custom template from the "Template" dropdown.
  3. Update the post.

Plugin 2: Custom Post Type UI + Template Library Plugins#

For custom post types, use "Custom Post Type UI" to register a CPT (e.g., "product"), then design a template with a plugin like "Elementor" or "Divi" and assign it via the builder’s conditions.

7. Advanced Tips for Custom Single Post Templates#

Integrate Custom Fields (Advanced Custom Fields)#

Use the Advanced Custom Fields (ACF) plugin to add editable fields (e.g., star ratings, pros/cons) to your templates. For example:

  1. Create a "Star Rating" field in ACF.
  2. Display it in your template with: 
    <?php the_field( 'star_rating' ); ?>

Combine with Custom Post Types (CPTs)#

Register a CPT (e.g., "recipe") using Custom Post Type UI, then create single-recipe.php to automatically target all recipe posts (via the template hierarchy).

Add Conditional Logic for Dynamic Content#

Use PHP or ACF’s "Conditional Logic" feature to show/hide sections based on user input:

<?php if ( get_field( 'has_video' ) == 'yes' ): ?>  
    <div class="post-video">  
        <?php the_field( 'video_url' ); ?>  
    </div>  
<?php endif; ?>

Use Hooks and Filters for Further Customization#

WordPress hooks let you modify templates without editing files directly. For example, add a section after the post content:

add_action( 'after_entry_content', 'add_custom_section' );  
function add_custom_section() {  
    if ( in_category( 'reviews' ) ) {  
        echo '<div class="custom-section">This post contains affiliate links.</div>';  
    }  
}

Ensure Responsiveness#

Test templates on mobile devices and use CSS media queries:

@media (max-width: 768px) {  
    .pros-cons {  
        flex-direction: column; /* Stack pros/cons on mobile */  
        gap: 1rem;  
    }  
}

8. Troubleshooting Common Issues#

Template Not Loading?#

  • Check the file name: Ensure it follows the hierarchy (e.g., single-category-reviews.php for categories).
  • Verify the header comment: Missing Template Name or Template Post Type causes WordPress to ignore the file.
  • Child theme active?: Templates must reside in the child theme, not the parent.

Styling Conflicts#

  • Use browser dev tools (F12) to inspect elements and identify conflicting CSS.
  • Increase specificity: Target elements with .review-template .entry-title instead of .entry-title.
  • Avoid overusing !important—it makes future changes harder.

Conditional Tags Not Working?#

  • Debug with var_dump(): 
    var_dump( get_the_ID() ); // Check post ID  
var_dump( in_category( 'reviews' ) ); // Check category membership
  • Ensure tags are inside the loop or use global $post; to access the post object.

White Screen of Death (WSOD)#

  • Enable debug mode by adding define( 'WP_DEBUG', true ); to wp-config.php to see errors.
  • Check for syntax errors (e.g., missing ; or } in PHP).

Plugin/Builder Conflicts#

  • Deactivate other plugins temporarily to isolate conflicts.
  • Update page builders/plugins to the latest version.

9. Conclusion#

Custom single post templates transform your WordPress site from generic to personalized, ensuring each content type shines. Whether you code manually, use a page builder, or rely on plugins, the key is to align the template with your content’s unique needs—whether that’s a review, portfolio, or event post.

Always use a child theme, test changes in staging, and back up your site. With the methods in this guide, you’ll unlock endless possibilities to enhance UX, reinforce branding, and make your content stand out.

10. References#

2025-10