WordPress Custom Post Types & Taxonomies: Complete Guide

Custom post types and taxonomies in WordPress allow you to create and organize content beyond the default posts and pages. Here’s what they are and how to use them:

Custom Post Types

Define new content types like products, portfolios, events, testimonials, etc.
Have custom fields, templates, and organization
Examples: e-commerce products, creative portfolios, event listings, customer testimonials

Taxonomies

Classification systems to categorize content
Create custom taxonomies like product categories, skill sets, etc.
Hierarchical (categories) or non-hierarchical (tags)

Key Differences	Default Post Types	Custom Post Types	Default Taxonomies	Custom Taxonomies
Content Types	Posts, Pages	Products, Portfolios, Events	–	Product Categories, Skill Sets
Custom Fields	Limited	Customizable	–	–
Templates	Default	Custom	–	–
Organization	Categories, Tags	Custom Taxonomies	Categories, Tags	Custom Classification

Benefits

Better content organization
Tailored content management
Improved user experience
Scalability as your site grows

Using Them Together

Combine post types and taxonomies for complex content structures
Example: "Books" post type with "Authors" taxonomy

By leveraging custom post types and taxonomies, you can create a content structure tailored to your website’s unique needs, making it easier to manage and display specific types of information.

Custom Post Types Explained

Custom post types in WordPress allow you to create and manage different types of content beyond the default posts and pages. They provide flexibility to organize and display content tailored to your website’s needs.

What Are Custom Post Types?

Custom post types are content types you define and create in WordPress. They let you manage content in a way that makes sense for your website. For example, you can create custom post types for products, events, portfolios, testimonials, or any other content requiring specific fields and display options.

Differences From Default Post Types

Custom post types differ from default post and page types in several ways:

Content structure: They can have unique fields, metadata, and display options tailored to the specific content type.
Management: They can be managed separately from default post types, allowing for more organized content management.
Display: They can be displayed differently from default post types, using custom templates, layouts, and styles.

Examples of Custom Post Types

Here are some examples of custom post types:

Custom Post Type	Use Case
Products	An e-commerce website with fields for price, description, and images.
Events	An events website with fields for date, time, location, and ticket information.
Portfolios	A design agency with fields for project description, images, and client information.
Testimonials	A business website with fields for quote, author, and rating.

Creating Custom Post Types

Creating custom post types in WordPress allows you to define and manage unique content types tailored to your website’s needs. This section will guide you through the process of registering and creating custom post types using the register_post_type() function.

Registering Custom Post Types

To register a custom post type, you need to use the register_post_type() function. This function takes two arguments: the post type name and an array of options. Here’s an example:

function create_movie_post_type() {
  register_post_type( 'movies',
    array(
      'labels' => array(
        'name' => __( 'Movies' ),
        'singular_name' => __( 'Movie' )
      ),
      'public' => true,
      'has_archive' => true,
      'rewrite' => array('slug' => 'movies'),
      'show_in_rest' => true,
    )
  );
}
add_action( 'init', 'create_movie_post_type' );

In this example, we’re creating a custom post type called "movies" with labels, public visibility, archive support, and a custom slug.

Customizing Post Type Options

When registering a custom post type, you can customize various options. Here are some common options:

Option	Description
Labels	Define the names and singular names for your post type.
Public	Set whether the post type is publicly accessible or not.
Has Archive	Determine if the post type has an archive page.
Rewrite	Customize the URL slug for the post type.
Show in REST	Decide whether to include the post type in the WordPress REST API.

Linking Post Types to Taxonomies

You can associate custom post types with built-in or custom taxonomies to organize and categorize your content. For example, you can create a custom taxonomy called "genres" and link it to your "movies" post type.

Managing Custom Post Types

Adding Custom Fields and Meta Boxes

Custom fields and meta boxes allow you to extend the functionality of your custom post types. You can add custom fields to store additional data like images, videos, or text. Meta boxes provide a user-friendly interface for editing this data. To add custom fields, you can use plugins like Advanced Custom Fields (ACF) or Meta Box, which offer various field types like text, image, file, and more.

Here’s an example of adding a custom text field using ACF:

function add_custom_field() {
    acf_add_local_field(array(
        'key' => 'field_1234567890abcdef',
        'label' => 'Custom Field',
        'name' => 'custom_field',
        'type' => 'text',
        'instructions' => '',
        'required' => 0,
        'conditional_logic' => 0,
        'wrapper' => array(
            'width' => '',
            'class' => '',
            'id' => '',
        ),
    ));
}
add_action('acf/init', 'add_custom_field');

Customizing the Admin Interface

Customizing the admin interface for your custom post types can improve the user experience and make content management easier. You can add custom columns, filtering options, and bulk actions. For example, you can add a custom column to display custom field data:

function add_custom_column($columns) {
    $columns['custom_field'] = 'Custom Field';
    return $columns;
}
add_filter('manage_movie_posts_columns', 'add_custom_column');

function render_custom_column($column, $post_id) {
    if ($column == 'custom_field') {
        echo get_field('custom_field', $post_id);
    }
}
add_action('manage_movie_posts_custom_column', 'render_custom_column', 10, 2);

User Capabilities for Custom Post Types

Controlling user capabilities for custom post types is crucial for ensuring only authorized users can create, edit, and delete content. You can use the map_meta_cap filter to customize user capabilities. For example, you can restrict the ability to edit custom post types to administrators only:

function restrict_edit_capability($caps, $cap, $user_id, $args) {
    if ($cap == 'edit_post' && get_post_type($args[0]) == 'movie') {
        $caps = array('administrator');
    }
    return $caps;
}
add_filter('map_meta_cap', 'restrict_edit_capability', 10, 4);

Displaying Custom Post Types

Showing custom post types on your WordPress site requires creating custom templates, querying the posts using WP_Query, and including them in navigation menus and archives.

Creating Custom Templates

To create custom templates for single and archive pages of your custom post types, follow WordPress’s template hierarchy. For single posts, create a single-{post_type}.php file, where {post_type} is the slug of your custom post type. For archives, create an archive-{post_type}.php file. These templates allow you to tailor the presentation of your custom post type content.

For example, if you have a custom post type called "Product", create a single-product.php file for individual product pages and an archive-product.php file for the product archive page.

Querying Custom Post Types

To query custom post types using WP_Query, specify the post_type parameter. For example:

$args = array(
    'post_type' => 'product',
    'posts_per_page' => 10,
);
$query = new WP_Query($args);

This code retrieves 10 products and stores them in the $query object. Loop through the results using a while loop:

while ($query->have_posts()) {
    $query->the_post();
    // Display post content here
}

To include custom post types in navigation menus and archives, add them to your menu structure and archive templates. Create a custom link to the archive page of your custom post type and add it to your navigation menu.

For example, if you have a custom post type called "Product", create a custom link to the product archive page by adding the following code to your functions.php file:

function add_product_archive_link() {
    $archive_link = get_post_type_archive_link('product');
    wp_nav_menu_items($archive_link, 'Menu Name');
}
add_action('wp_nav_menu_items', 'add_product_archive_link');

This code adds a link to the product archive page to your navigation menu.

What Are Taxonomies?

Taxonomies in WordPress are ways to organize and categorize content. They help group similar items together, making it easier for users to find what they’re looking for.

Types of Taxonomies

There are two types of taxonomies:

1. Hierarchical Taxonomies

Allow categories and subcategories in a tree-like structure
Example: Categories for blog posts

2. Non-Hierarchical Taxonomies

Flat structure with no subcategories
Example: Tags for blog posts

Taxonomy Type	Structure	Example
Hierarchical	Tree-like with subcategories	Categories for blog posts
Non-Hierarchical	Flat with no subcategories	Tags for blog posts

Built-in Taxonomies

WordPress comes with two built-in taxonomies:

1. Categories

Hierarchical taxonomy
Organizes posts into broad categories and subcategories

2. Tags

Non-hierarchical taxonomy
Labels specific topics or keywords for posts

For example, a travel blog might use:

Categories: Destinations, Activities
- Subcategories: Europe, Hiking
Tags: adventure, beach, city break

Creating Custom Taxonomies

Custom taxonomies in WordPress allow you to categorize and organize your content in a way that makes sense for your website. Here’s how to create and manage custom taxonomies:

Registering a Custom Taxonomy

To create a custom taxonomy, you’ll use the register_taxonomy() function. This function requires three arguments:

The taxonomy name
The post type(s) the taxonomy applies to
An array of options defining the taxonomy’s properties

Here’s an example of registering a custom taxonomy called "Courses" for the "post" post type:

function register_course_taxonomy() {
    $labels = array(
        'name' => __( 'Courses' ),
        'singular_name' => __( 'Course' ),
        // ...
    );
    $args = array(
        'labels' => $labels,
        'hierarchical' => true,
        'show_ui' => true,
        'show_admin_column' => true,
        'query_var' => true,
        'rewrite' => array( 'slug' => 'course' ),
    );
    register_taxonomy( 'course', array( 'post' ), $args );
}
add_action( 'init', 'register_course_taxonomy' );

Customizing Taxonomy Options

When registering a custom taxonomy, you can customize various options to fit your needs:

Option	Description
`labels`	An array of labels for the taxonomy, like name, singular name, and plural name.
`hierarchical`	Whether the taxonomy is hierarchical (true) or non-hierarchical (false).
`show_ui`	Display the taxonomy in the WordPress admin interface.
`show_admin_column`	Display the taxonomy in the WordPress admin column.
`query_var`	Enable querying of the taxonomy using `WP_Query`.
`rewrite`	Rewrite rules for the taxonomy.

Linking Taxonomies to Post Types

Once you’ve registered a custom taxonomy, you can link it to a custom or built-in post type using the register_taxonomy() function. This allows you to associate the taxonomy with specific post types and enable filtering and querying of posts by taxonomy terms.

For example, to link the "Courses" taxonomy to the "post" post type:

register_taxonomy( 'course', array( 'post' ), $args );

This code registers the "Courses" taxonomy and associates it with the "post" post type, enabling you to filter and query posts by course terms.

Managing Custom Taxonomies

Adding Custom Taxonomy Terms

To add terms to a custom taxonomy:

Go to Posts > Categories (or Tags) in the WordPress admin area.
Click on the custom taxonomy you want to manage.
From here, you can add, edit, and delete terms.

You can also add custom taxonomy terms to the post editor screen:

Go to Posts > All Posts in the WordPress admin area.
Click on the post you want to edit.
Scroll down to the post editor screen and click Screen Options.
Check the box next to the custom taxonomy to display it.
The custom taxonomy will now be available in the post editor, allowing you to assign terms to the post.

Customizing the Admin Interface

You can customize how taxonomies are displayed and interacted with in the WordPress admin area. Use plugins or custom code to modify the taxonomy screens.

For example, the Custom Taxonomies Menu Widget plugin lets you add custom taxonomy terms to the sidebar or other widget areas. This allows you to easily display terms from any custom taxonomy in your sidebar.

User Capabilities for Custom Taxonomies

Control which users can manage custom taxonomies by assigning specific permissions to users or roles.

You can use plugins like Capability Manager to manage user capabilities for custom taxonomies. For example:

Capability	Description
`manage_terms`	Allows users to manage custom taxonomy terms.
`edit_terms`	Allows users to edit custom taxonomy terms.

Assign these capabilities to specific roles or users to control who can manage and edit custom taxonomy terms.

Displaying Custom Taxonomies

This section covers how to display custom taxonomies in WordPress. It explains creating custom taxonomy templates, querying posts by taxonomy terms, and displaying taxonomy terms in navigation menus and archives.

Creating Custom Taxonomy Templates

To create a custom template for a taxonomy archive, follow these steps:

Create a new file in your theme directory with the name taxonomy-{taxonomy slug}.php. Replace {taxonomy slug} with the slug of your custom taxonomy. For example, if your taxonomy is called "topics," the file name would be taxonomy-topics.php.
In this file, use the get_terms function to retrieve a list of terms for your custom taxonomy. Loop through these terms and display them as desired.

Example code:

<?php
$terms = get_terms( array(
    'taxonomy' => 'topics',
    'hide_empty' => false,
) );

foreach ( $terms as $term ) {
    echo '<h2>'. $term->name. '</h2>';
    echo '<ul>';
    foreach ( get_posts( array(
        'post_type' => 'post',
        'tax_query' => array(
            array(
                'taxonomy' => 'topics',
                'field' => 'slug',
                'terms' => $term->slug,
            ),
        ),
    ) ) as $post ) {
        echo '<li><a href="'. get_permalink( $post->ID ). '">'. $post->post_title. '</a></li>';
    }
    echo '</ul>';
}
?>

This code retrieves a list of terms for the "topics" taxonomy and loops through them, displaying each term’s name and a list of associated posts.

Querying Posts by Taxonomy Terms

To query posts by custom taxonomy terms, use the WP_Query class and pass an array of arguments, including a tax_query argument that specifies the taxonomy terms to retrieve.

Example code:

$args = array(
    'post_type' => 'post',
    'tax_query' => array(
        array(
            'taxonomy' => 'topics',
            'field' => 'slug',
            'terms' => 'technology',
        ),
    ),
);
$query = new WP_Query( $args );

This code retrieves all posts associated with the "technology" term in the "topics" taxonomy and stores them in the $query object. You can then loop through the posts using a foreach loop.

To display custom taxonomy terms in navigation menus and archives, use the wp_list_categories function. This function generates a list of categories (or taxonomy terms) and can display custom taxonomy terms in navigation menus.

Example code:

$args = array(
    'taxonomy' => 'topics',
    'title_li' => '',
);
echo '<ul>';
wp_list_categories( $args );
echo '</ul>';

This code generates a list of terms for the "topics" taxonomy and displays them in an unordered list. You can customize the appearance of the list by modifying the $args array.

Combining Post Types and Taxonomies

You can use custom post types and taxonomies together to create complex content structures. This allows for better organization and flexibility with your content. For example, you could create a custom post type for "Books" and a taxonomy for "Authors." This way, you can associate books with specific authors and display them in a hierarchical structure.

To combine post types and taxonomies:

Register the custom post type using the register_post_type function.
Register the custom taxonomy using the register_taxonomy function.
Link the post type to the taxonomy using the add_post_type_support function.

Here’s an example:

// Register custom post type
register_post_type( 'book',
    array(
        'labels' => array(
            'name_admin_bar' => 'Book',
        ),
        'public' => true,
    )
);

// Register custom taxonomy
register_taxonomy( 'author',
    array( 'book' ),
    array(
        'labels' => array(
            'name' => 'Authors',
        ),
        'hierarchical' => true,
    )
);

// Link post type to taxonomy
add_post_type_support( 'book', 'author' );

This code registers a custom post type for "Books" and a taxonomy for "Authors." It then links the post type to the taxonomy, allowing you to associate books with specific authors.

Integrating with Third-Party Plugins

You can integrate custom post types and taxonomies with third-party plugins to add extra functionality. For example, you can use the Advanced Custom Fields (ACF) plugin to add custom fields to your custom post types. This lets you store and display additional metadata for your content.

To integrate with third-party plugins:

Install and activate the plugin.
Configure the plugin to work with your custom post types and taxonomies.

Here’s an example for integrating ACF with a custom post type:

// Add custom field to custom post type
add_filter( 'acf/get_post_types', 'add_acf_support' );
function add_acf_support( $post_types ) {
    $post_types[] = 'book';
    return $post_types;
}

This code adds support for the ACF plugin to the custom post type "Book." You can then use ACF to add custom fields to your book posts and display them.

Performance Considerations

Custom post types and taxonomies can impact your WordPress site’s performance, especially if you have a lot of content. To optimize performance, follow these best practices:

Use caching plugins to reduce the load on your database.
Optimize your database queries to retrieve less data.
Use efficient code snippets to reduce the load on your server.
Avoid using too many custom post types and taxonomies, as this can lead to database bloat.

Conclusion

Key Points in Brief

In this guide, we covered how to create and use custom post types and taxonomies in WordPress. You learned:

What custom post types and taxonomies are
How to register custom post types and taxonomies
Ways to customize and manage them
Displaying custom post types and taxonomies on your site

More Resources

To keep learning, check out:

Resource	Description
WordPress Codex	Documentation on WordPress functions and APIs
Plugin Directory	Plugins to extend WordPress functionality
Advanced Custom Fields (ACF)	Popular plugin for adding custom fields

Next Steps

Now that you understand custom post types and taxonomies, it’s time to put this knowledge into practice:

Identify areas of your WordPress site that could benefit from better content organization.
Experiment with registering custom post types and taxonomies.
Explore plugins like ACF to add custom fields.
Optimize your site’s performance by following best practices.

Start improving your content structure today!

FAQs

What are custom post types and taxonomies in WordPress?

Custom Post Types

Post types are how WordPress categorizes different types of content. By default, WordPress has a few post types like posts, pages, attachments, and navigation menus. Custom post types allow you to create your own content types tailored to your website’s needs, such as:

Products (for an e-commerce site)
Portfolios (for showcasing creative work)
Events (for event management)
Testimonials
Team member profiles

Custom post types can have their own custom fields, labels, and templates, making it easier to manage and display specific content.

Taxonomies

Taxonomies are a way to group and classify content in WordPress. The default taxonomies are categories and tags, used to organize posts. Custom taxonomies let you create your own classification systems for custom post types or even default post types.

For example, you could create a custom taxonomy called "Product Categories" to organize your products, or a "Skill Set" taxonomy to categorize team members based on their expertise.

Key Differences

Feature	Default Post Types	Custom Post Types
Content Types	Posts, Pages, Attachments, Navigation Menus	Products, Portfolios, Events, Testimonials, Team Members, etc.
Custom Fields	Limited	Customizable fields specific to the content type
Templates	Default templates	Custom templates for display and management
Organization	Categories and Tags	Custom taxonomies for classification

Feature	Default Taxonomies	Custom Taxonomies
Types	Categories and Tags	Product Categories, Skill Sets, etc.
Structure	Categories (hierarchical), Tags (non-hierarchical)	Hierarchical or non-hierarchical
Usage	For organizing posts	For organizing custom post types or default post types

Custom post types and taxonomies provide flexibility to create and organize content in a way that suits your website’s needs, making it easier to manage and display specific types of information.

WordPress Custom Post Types & Taxonomies: Complete Guide

Related video from YouTube

Custom Post Types Explained

What Are Custom Post Types?

Differences From Default Post Types

Examples of Custom Post Types

Creating Custom Post Types

Registering Custom Post Types

Customizing Post Type Options

Linking Post Types to Taxonomies

Managing Custom Post Types

Adding Custom Fields and Meta Boxes

Customizing the Admin Interface

User Capabilities for Custom Post Types

Displaying Custom Post Types

Creating Custom Templates

Querying Custom Post Types

Displaying in Navigation and Archives

What Are Taxonomies?

Types of Taxonomies

Built-in Taxonomies

sbb-itb-77ae9a4

Creating Custom Taxonomies

Registering a Custom Taxonomy

Customizing Taxonomy Options

Linking Taxonomies to Post Types

Managing Custom Taxonomies

Adding Custom Taxonomy Terms

Customizing the Admin Interface

User Capabilities for Custom Taxonomies

Displaying Custom Taxonomies

Creating Custom Taxonomy Templates

Querying Posts by Taxonomy Terms

Displaying Taxonomy Terms in Navigation

Combining Post Types and Taxonomies

Integrating with Third-Party Plugins

Performance Considerations

Conclusion

Key Points in Brief

More Resources

Next Steps

FAQs

What are custom post types and taxonomies in WordPress?

Key Differences

Related posts

More WorDPRESS Tips, tutorials and Guides

Best Practices for Multisite Update Management

How to Create Custom Page Templates in WordPress

10 Best WordPress Migration Tools Compared

How to Optimize WordPress Meta Tags for SEO