1. Home
  2. Knowledge Base
  3. Posts Table Pro
  4. Posts Table Pro Options

Posts Table Pro – Full list of options

The Posts Table Pro plugin comes with over 50 options for customizing your tables. This article describes all the options available for your tables, and how to use them.

Where to manage your table options

You can configure the most popular options directly in the table builder, whereas the more advanced options are managed on the plugin settings page and/or as shortcode options:

  • Add Table - These options are available when you use the table builder to create a new table (Post Tables → Add New).
  • Edit Table - These options are available when you edit a table (Post Tables → Edit).
  • Settings Page - You can set defaults for these options on the settings page (Post Tables → Settings). These will be used for all your new tables, and you can override the defaults for each individual table. 
  • Shortcode - Available as shortcode options so that you can configure them directly in the [posts_table] or [posts_table id=""] shortcode.

The list of options below indicates where you can manage each one.

Full list of options

Table columns

Option Description Add Table Edit Table Settings Page Shortcode
Columns Sets the columns in the table. You can also customize or remove the column headers ✓ ✓ ✓ ✓

Choosing which posts appear in the table

Option Description Add Table Edit Table Settings Page Shortcode
Category Lists posts from a specific category ✓ ✓ ⛌ ✓
Tag Lists posts with a specific tag ✓ ✓ ⛌ ✓
Term Lists posts with a specific custom taxonomy term ✓ ✓ ⛌ ✓
Custom field Lists posts with a specific custom field value ✓ ✓ ⛌ ✓
Post type Lists posts with a specific post type (e.g. products, events, or projects) ✓ ✓ ⛌ ✓
Status Lists posts with a specific status (e.g. publish) ✓ ✓ ⛌ ✓
Year Lists posts published in a specific year ⛌ ⛌ ⛌ ✓
Month Lists posts published in a specific month ⛌ ⛌ ⛌ ✓
Day Lists posts published on a specific day of the month ⛌ ⛌ ⛌ ✓
Author Lists posts by a specific author/user ✓ ✓ ⛌ ✓
Include Lists specific posts in the table based on ID ✓ ✓ ⛌ ✓
Exclude Excludes specific posts from the table based on ID ⛌ ⛌ ⛌ ✓
Exclude category Excludes entire categories of posts from the table ⛌ ⛌ ⛌ ✓
Exclude term Excludes posts with specific taxonomy terms from the table ⛌ ⛌ ⛌ ✓
MIME type Lists media library files with a specific file extension ✓ ✓ ⛌ ⛌

Table content

Option Description Add Table Edit Table Settings Page Shortcode
Rows per page Sets the number of posts on each page of the table ⛌ ✓ ✓ ✓
Links Sets which columns in the table are clickable ✓ ✓ ✓ ✓
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) ⛌ ⛌ ✓ ✓

Sorting & ordering

Option Description Add Table Edit Table Settings Page Shortcode
Sort by Controls how the posts are sorted when the table first loads ✓ ✓ ✓ ✓
Sort order Sorts the table in ascending or descending order ✓ ✓ ✓ ✓
Multi-column sorting Allow the table to be sorted by more than one column at once ⛌ ⛌ ✓ ✓
Filters Add filters above the table or in the column headers ✓ ✓ ✓ ✓
Filter locations Choose whether filters appear above the table and/or inside the column headers ✓ ✓ ✓ ✓
Multi-select filters Allow visitors to select multiple values from each filter ⛌ ⛌ ✓ ✓
Active filters Display the currently applied filters above the table ⛌ ⛌ ✓ ✓
Filter counts Show the number of matching posts next to each filter option ⛌ ⛌ ✓ ✓
Search term Filter by search term when the table first loads ⛌ ⛌ ⛌ ✓
Search on click Controls whether clicking on a category, tag or custom taxonomy will filter the table or link to the relevant archive page ⛌ ⛌ ⛌ ✓

Control elements above & below the table

Option Description Add Table Edit Table Settings Page Shortcode
Search box Shows, hides or positions the keyword search box ⛌ ✓ ✓ ✓
Reset button Shows or hides the reset link ⛌ ⛌ ⛌ ✓
Page length Shows, hides or positions the “Show <x> posts” dropdown list ⛌ ⛌ ✓ ✓
Totals 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 style ⛌ ⛌ ✓ ✓
Infinite scroll Load more rows automatically as the visitor scrolls, instead of numbered pagination ⛌ ⛌ ✓ ✓
Container height Sets the height of the scrolling area when infinite scroll is enabled ⛌ ⛌ ✓ ✓
Sticky header Keep the table header visible after scrolling down ⛌ ⛌ ✓ ✓
Hide header Remove the table header row ⛌ ⛌ ✓ ✓
Show footer Shows or hides the footer row of the table ⛌ ⛌ ⛌ ✓
Scroll offset Changes the height that the page scrolls to when you move between pages in the table ⛌ ⛌ ✓ ✓

Sizing & styling

Option Description Add Table Edit Table Settings Page Shortcode
Widths Forces each column to a certain width ⛌ ⛌ ⛌ ✓
Content length Sets the number of characters in the 'content' column ⛌ ⛌ ✓ ✓
Excerpt length Sets the number of characters in the 'excerpt' column ⛌ ⛌ ✓ ✓

Images

Option Description Add Table Edit Table Settings Page Shortcode
Image size Sets the size of featured images in the table ⛌ ⛌ ✓ ✓
Lightbox Control whether your images open in a lightbox ⛌ ⛌ ✓ ✓

Mobile visibility & responsive options

Your tables will automatically adjust to suit mobiles and different screen sizes. There are shortcode options to give you more fine-grained control over this.

Option Description Add Table Edit Table Settings Page Shortcode
Wrap Controls whether or not content is wrapped onto multiple lines ⛌ ⛌  ⛌ ✓
Responsive priority Controls which columns are hidden on screen sizes when there are too many to fit on the page ✓ ✓ ⛌ ✓
Responsive visibility Provides fine-grained control over the breakpoints for each column when viewed on smaller screen sizes ✓ ✓ ⛌ ✓
Responsive control Controls the + icon which shows hidden rows ⛌ ⛌ ⛌ ✓
Responsive display Sets whether hidden rows are visible or hidden, or open in a modal window ⛌ ⛌ ⛌ ✓

Performance

Option Description Add Table Edit Table Settings Page Shortcode
Cache Whether to use caching to speed up table load time ⛌ ⛌ ✓ ✓
Frontend library Switch to the legacy jQuery DataTables frontend for compatibility ⛌ ⛌ ✓ ✓

Miscellaneous options

Option Description Add Table Edit Table Settings Page Shortcode
Date format Sets the date format for any date columns ⛌ ⛌  ⛌ ✓
Date columns Specifies which columns contain dates, so that the column can be sorted by date correctly ⛌ ⛌ ⛌ ✓
No posts message Controls the text that appears if no posts are found when the table first loads ⛌ ⛌ ⛌ ✓
No posts filtered message Controls the text that appears if no results are found when a user searches or filters the table ⛌ ⛌ ⛌ ✓
Numeric terms Fixes any issues if you're using numeric slugs for your categories or taxonomies ⛌ ⛌ ⛌ ✓
Unique URLs Give the table a unique URL reflecting its current search, filters, sorting and pagination, so visitors can link to a specific view ⛌ ⛌ ✓ ✓

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.

Related Articles

If searching the knowledge base hasn't answered your question, please contact support.