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_template 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 | ⛌ | ✓ | ✓ | ✓ |
Post limit | Sets the maximum number of posts that can appear in 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 | ✓ | ✓ | ✓ | ✓ |
Filters | Add filter dropdown lists above the table | ✓ | ✓ | ✓ | ✓ |
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, hides or positions 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 | ⛌ | ⛌ | ✓ | ✓ |
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 | ⛌ | ⛌ | ⛌ | ✓ |
Peformance
Option | Description | Add Table | Edit Table | Settings Page | Shortcode |
Lazy load | Improves performance by loading the overall page before the table, and loading 1 page of posts at a time | ✓ | ✓ | ✓ | ✓ |
Cache | Whether to use caching to speed up table load time | ⛌ | ⛌ | ✓ | ✓ |
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 | ⛌ | ⛌ | ⛌ | ✓ |
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.