Posts Table Pro – Full list of options
This is a complete list of all the options available in Posts Table Pro, with links to full instructions for each option. You can use these to configure the [posts_table]
shortcode in many different ways.
Table columns
columns
– sets the columns in the table. There are options to customize or remove the column headers
Choosing which posts appear in the table
There are lots of ways to create a table listing specific posts only:
category
– lists posts from a specific categorytag
– lists posts with a specific tagpost_type
- lists posts with a specific post type (e.g. products, events, or projects)term
– lists posts with a specific custom taxonomy termcf
– lists posts with a specific custom field valueyear
– lists posts published in a specific yearmonth
– lists posts published in a specific monthday
– lists posts published on a specific day of the monthauthor
- lists posts by a specific author/userstatus
– lists posts with a specific status (e.g. Published)exclude
– excludes specific posts from the table based on IDinclude
– lists specific posts in the table based on IDexclude_category
– excludes entire categories of posts from the tableexclude_term
- excludes posts with specific taxonomy terms from the tablerows_per_page
– sets the number of posts on each page of the tablepost_limit
– sets the maximum number of posts that can appear in the table
Sorting & ordering
sort_by
– controls how the posts are sorted when the table first loadssort_order
– sorts the table in ascending or descending orderfilters
– add filter dropdown lists above the tablesearch_term
- filter by search term when the table first loads
Control elements above & below the table
search_box
– shows, hides or positions the keyword search boxreset_button
– shows, hides or positions the reset linkpage_length
– shows, hides or positions the “Show <x> posts” dropdown listtotals
– shows, hides or positions the post totals (e.g. “Showing 1 to 10 of 50 posts”)pagination
– shows, hides or positions the pagination buttons (previous, next etc)paging_type
– sets the pagination styleshow_footer
– shows or hides the footer row of the tablescroll_offset
– changes the height that the page scrolls to when you move between pages in the table
Sizing & styling
widths
– sets the width of each columncontent_length
- sets the number of characters in the 'content' columnexcerpt_length
- sets the number of characters in the 'excerpt' column
Images
image_size
– sets the size of featured images in the tablelightbox
- control whether your images open in a lightbox
Mobile visibility & responsive options
wrap
– controls whether or not content is wrapped onto multiple linespriorities
– controls which columns are hidden on screen sizes when there are too many to fit on the pagecolumn_breakpoints
– provides fine-grained control over the breakpoints for each column when viewed on smaller screen sizesresponsive_control
– controls the + icon which shows hidden rowsresponsive_display
– sets whether hidden rows are visible or hidden, or open in a modal window
Performance
lazy_load
– improves performance by loading the overall page before the table, and loading 1 page of posts at a timecache
– whether to use caching to speed up table load time
Miscellaneous options
button_text
- changes the text of the button column, for example if you want this to appear as 'Read More' rather than 'View'.shortcodes
– displays content generated by other shortcodes in the table (e.g. buttons or embedded audio or video players)links
– sets which columns in the table are clickablesearch_on_click
– controls whether clicking on a category, tag or custom taxonomy will filter the table or link to the relevant archive pagedate_format
– sets the date format for any date columnsdate_columns
– specifies which columns contain dates, so that the column can be sorted by date correctlyno_posts_message
– controls the text that appears if no posts are found when the table first loadsno_posts_filtered_message
– controls the text that appears if no results are found when a user searches or filters the tablenumeric_terms
- fixes any issues if you're using numeric slugs for your categories or taxonomies
Posts table shortcode examples
To get you started, here are some popular examples of different ways to use Posts Table Pro.
Basic usage displaying all posts (see below for full list of columns):
[posts_table columns="image,title,content,date,author"]
Display posts from a single category (use the category slug or ID):
[posts_table columns="title,excerpt,tags" category="news"]
Display posts from several categories. This example shows posts in the “ebooks” category or the “audiobooks” category:
[posts_table category="ebooks,audiobooks"]
Display posts that belong to several categories. This example shows posts that are in the “featured”, “course”, and “health” categories:
[posts_table category="featured+course+health"]
Exclude posts from a category. This example excludes posts in the “clients” category:
[posts_table exclude_category="clients"]
Display featured image. Defaults to 50 by 50 pixels, but you can specify a custom image size if you wish:
[posts_table columns="image,title,content" image_size="80x80"]
Choosing custom column headings:
[posts_table columns="title:Post Name,content:Description,Author:Written By"]
What else can I do?
Please also see our articles on advanced usage, which include advice on adding tables to category archive or search results pages, translating the posts table into other languages, developer documentation, and more. We've also published a list of compatible third party plugins that you can use with Posts Table Pro.