How to Easily List WordPress Custom Post Types in a Searchable Table

By Updated: October 1, 2019

As WordPress has grown and evolved over time, more and more websites are using custom post types (CPT). You can use them for any type of website content, from documents to events, and from products to portfolios. However, visitors may find it difficult to search for and navigate to your custom posts via WordPress’ typical blog-style layout.

Displaying your WordPress content in a CPT table can help address that problem. Creating a dynamic, searchable list for your custom posts ensures that users can quickly find what they’re looking for. Plus, an easy-to-navigate list of custom post types makes for easy browsing, which encourages users to spend more time on your site.

A list of custom post types on Nova Group's website.

In this article, we’ll discuss custom post types and explain why listing them in a WordPress CPT table is a smart move. Then, we’ll provide steps on how to easily create a searchable list of any WordPress custom post type. Let’s get started!

An introduction to custom post types

Custom post types are used for content that’s similar to a standard WordPress post but has different organization and/or information. For example:

  • Many e-commerce plugins include a ‘products’ custom post type. This is built on top of the familiar WordPress editor, supplemented with additional fields for displaying pricing data, shipping methods, and so on. For example, WooCommerce has a ‘products’ custom post type, and Easy Digital Downloads has a ‘downloads’ custom post type.
  • WordPress events plugins create an ‘events’ CPT. This makes it easy to add upcoming courses and events to your website.
  • Most WordPress themes come with one or more custom post types. This can include post types for portfolios, testimonials, real estate listings, etc.
  • You can also create your own custom post types to store any other type of content. For example, if you want to create your own document library then you’ll want to create a ‘documents’ post type.

With custom post types, you can improve your site’s organization and navigation. For instance, if your e-commerce site had a blog in addition to products, then it would be a nightmare if both were stored as ‘posts’. Your posts and products would be mixed together in one archive, which would be difficult for you to manage, and unintuitive for your users.

The same is true for any kind of content, whether that’s recipes, encyclopedia-style articles, or something completely unique.

By creating separate types of content and listing each one separately on your website, you can help your site’s visitors find information for more easily. Using WordPress custom post types also opens the door to listing each post type in a suitable layout, instead of using the same blog-style layout for everything. You’ll learn how to create WordPress CTP tables in this article.

The benefits of listing custom post types on your WordPress site

The possibilities for custom post types are nearly endless. Listing them in a CPT table makes it easier for users to navigate and browse your site. By quickly searching and filtering your custom posts, visitors can quickly find what they’re looking for.

You can list custom post types with our WordPress CPT plugin, Posts Table Pro:

Posts Table Pro
The easy way to list custom post types in WordPress.

We’ve received a lot of feedback about how Posts Table Pro has helped people to list CPT more effectively:

Impressing capabilityes
By Matteo Mauri
This plugin is well worth the price. We use it to display and sort medical documentation, embedded in Custom Post Types. The display is clean, mobile responsiveness is not an issue, the filtering is nearly instant. Another thing that to me made all the difference: the support is fast and capable. Highly recommended

Case study: How Nova Group list custom post types with Posts Table Pro

Nova Group used Posts Table Pro to make their portfolio project listings accessible and navigable for potential clients. The plugin saves them time by automatically listing the ‘Projects’ custom post type in a readable, searchable format:

List WordPress custom post types on Nova Group website

This site uses a WP custom post type to display the company’s case studies and organize those studies into a searchable table. That helps site visitors find the projects that are most relevant to them.

Keep reading to learn how to list custom post types on your own WordPress site in a CPT table. (Hint: It’s really easy!)

How to easily list WordPress custom post types in a searchable table (in 3 steps)

Another of our customers said it best:

I chose the plugin because I couldn’t find any other plugins on the market that would display a custom post in a table.

Create a WordPress document libraryWith Posts Table Pro, you can:

  • Display any posts, pages, and/or custom post types in a dynamic table.
  • Create custom columns, so your table displays your content’s most important features.
  • Add search, sort, and filter options for easy navigation.

Without further ado, let’s find out how to list custom post types with Posts Table Pro!

Step 1: Install and activate Posts Table Pro

To start, you’ll need to purchase, download, and install the plugin:

Get Posts Table Pro!

Once your purchase is complete, download the .zip file and head over to your WordPress dashboard. There, you should navigate to Plugins → Add New and click on Upload Plugin at the top of the page. Then you can select the .zip file and upload it.

Adding a new plugin to WordPress.

Select Activate Now once the installation is complete. Now you just need to enter your license key, which you should have received during the purchase process.

Navigate to Plugins, and find Posts Table Pro in the list. Select Settings under the plugin’s name, and enter your license key in the corresponding field:

The Posts Table Pro license key field.

Click on Save Changes, and you’ll be all set to start listing your custom post types in a dynamic table.

Step 2: Configure Post Table Pro’s settings

Now, you’ll just need to tweak a few more settings to make your table exactly the way you want it. In this case, the most important option is the very first one:

The custom post type selection to list WordPress custom post types

Under the Posts Selection heading, you’ll see a dropdown selector which automatically lists all the post types on your website. Here you can choose any type of content to display in your CPT table, including posts, pages, and custom post types. This is where you need to choose the custom post type that you want to list. Creating a list of WordPress custom post types is as simple as that!

Tip: Use this option if you just want to list one custom post type. It’s also possible to create multiple tables, each listing a different custom post type. To learn how, check our these instructions in the plugin knowledge base. 

Of course, there are plenty of other useful settings on this page that you may want to configure. Under Table Content, you can determine what data to include by listing information in the Columns field, and then adding in images, shortcodes, and links.

The Columns field.

Tip: If you’re adding a categories column, bear in mind that custom post type categories are actually taxonomies, not categories! This means that you need to add tax: before the taxonomy slug in your list of columns (e.g. tax:download_category). This tells Posts Table Pro that it’s a custom taxonomy. 

You can also enable lazy loading to help your table load faster – ideal if you’re listing a large number of custom posts:

The Table Loading options to list WordPress custom post types

Add search and filters

Finally, in order to make your table easy to navigate, you’ll want to adjust the sort, filter, and search features. Under Sorting, choose the information from the Sort by dropdown menu that best fits your content. You may want to sort the table by title, date, ID, or some other criteria. Then head down to Table Controls, and enable search filters by selecting Show based on columns in table from the first dropdown menu:

The Table Controls section.

The third dropdown menu determines the positioning and visibility of the table’s search bar. Make sure it’s set to the area where you want your search bar to be, and isn’t Hidden.

Your users will now be able to easily navigate through your table. You can finish up by configuring the pagination settings in the last section, and then you’re ready to display the resulting table.

Step 3: Add the posts table shortcode to your site

To add your WordPress custom post types table to your site, all you have to do is use a simple shortcode. Simply add  [posts_table]  to the page where you want your table to appear:

Adding the Posts Table Pro shortcode to a page.

And your list of custom post types will look something like this:

Or maybe your WordPress CPT table will look more like this:

WordPress document library plugin with links

Of course, you may want to use Posts Table Pro to display multiple tables on your site. For example, you might have more than one custom post type, and want to create a separate list for each of them. If that’s the case, don’t worry. Your shortcode just needs a little tweaking.

When you add the shortcode to your page, append [post_type="custom-post-type"]to the end of [[posts_table]]. You should replace “custom-post-type” with the kind of custom content you want to list. For example, you could use  [posts_table post_type="recipes"]  and  [posts_table post_type="portfolio"] to display two different lists, one for your recipes and one for your portfolio.

There are also lots of options to list specific custom posts in the table, instead of all of them. For example, you can list custom posts by category, tag, and more.

Then, your list of custom post types will look more like this:

Separate categories

The sky’s the limit when it comes to the different ways you can list your content types!

The easy way to list custom post types in WordPress

Custom post types help you display your site’s CPT content in a way that makes sense to your users. With Posts Table Pro, you can list your custom content in a way that’s logically organized and clearly navigable.

In this article, we showed you how to easily list WordPress custom post types in a searchable CPT table:

  1. Install and activate Posts Table Pro.
  2. Configure the plugin’s settings.
  3. Add a simple shortcode to your site wherever you want to list custom posts.
Posts Table Pro
Get started with listing custom post types in WordPress.

Do you have questions about how to list WordPress custom post types on your site? Leave them in the comments section below!

Will Morris

Will Morris is a staff writer at WordCandy. When he's not writing about WordPress, he likes to gig his stand-up comedy routine on the local circuit.

Please share your thoughts...

Your email address will not be published.