Product Table settings
The WooCommerce Product Table plugin settings page can be found at Products → Product Tables → Settings. It contains options which can only be configured globally and are therefore not available in the table builder.
Note: While most people only use these settings globally, most of them have shortcode options which you can use to configure them for individual tables.
License key
Enter your license key in the box. This is essential for the plugin to work and for you to receive automatic plugin updates. Click 'Activate' or save the settings to activate your license.
Add to cart
Add to cart button
Use this option to change the text of the add to cart button for each product. This is only used for tables that have add to cart buttons visible.
(Tip: Use the free WooCommerce Custom Add to Cart Button plugin to add an icon to the button.)
Multi add to cart button
This option allows you to change the text in the multi add to cart button which appears above and/or below tables that display add to cart checkboxes. This text will only be used when no products are selected in the table.
Multi add to cart button - products selected
Enter singular and plural text which will appear in the multi add to cart button when one or more products are selected in the table. You can add whatever you like here, either as static text or using the following placeholders:
{items}- Displays the number of selected items.{total}- Displays the exact total price of the selected items (e.g. $149.75).{total_rounded}- Displays the total price of the selected items either rounded up or down (e.g. $149.75 would round up to $150, so $150 would be displayed).
Multi add to cart location
This option lets you choose whether the 'Add to Cart' button appears above and/or below the table.
Table content
Description length
If you are using the description column, then this option controls the number of words that will appear in the table. Enter a whole number.
More information
Show hidden products
By default, WooCommerce Product Table respects the visibility settings of each product. This means that if you have used the 'Catalog visibility' settings for a product to hide it from the shop, then it will not appear in the product table either.
You can change this by enabling the 'show hidden products' option. Hidden products will then appear in the table.
Show table footer
Enable this to repeat the header row of the table underneath the bottom row of the table. This is useful for long tables as it allows customers to see the name of each column without having to scroll back up.
Product search
Search box
Positions, shows or hides the keyword search box.
Number of products found
Positions, shows or hides the total number of products in the table.
Reset search
Allows you to display a search reset link.
Pagination
Products per page
Enter a whole number to control how many products appear on each page of the table. If there are more products than the number of rows per page then pagination links will appear linking to the other pages.
The default is 20 rows. Setting it to -1 will show all products on one page.
Products per page control
Positions, shows or hides the 'Show [x] per page' dropdown.
Pagination buttons
Positions, shows or hides the pagination buttons.
Pagination type
Choose a style for the pagination buttons.
-
- paging_type="numbers" (default)
-
- paging_type="simple"
-
- paging_type="simple_numbers"
-
- paging_type="full"
-
- paging_type="full_numbers"
Responsive options
Responsive display
Control how the "child rows" are displayed when viewing the table on smaller screen sizes (or when there is too much data to fit in the table). Choose from the following options:
- Click a plus icon to display a child row (the default option) - Extra data will be displayed in a hidden child row which can be shown by clicking the "+" icon at the start of each row.
- Expand all child rows automatically – Extra data is displayed in a child row which is expanded automatically when the table is first viewed.
- Click a plus icon to open a modal window – Extra data is displayed in a modal window when the “+” icon is clicked. (Note: Not compatible with the 'checkbox' add to cart option - see further information below.)
More information & screenshots
Design
Default
The ecommerce Product Table styles (e.g. font size and color) will automatically be inherited from your theme.
Custom
Select this option to override the default styling. You can change the styling of the following elements of the product tables:
- Border color and line widths
- Header background color
- Cell background color
- Header font color and size
- Cell font color and size
To change the color, select from the color picker or add any hexadecimal color value (e.g. #757575). To change the size, use the up/down arrows or enter the size in pixels. Tip: If you want to add an RGB color then you can use a color convertor to get the right value.
You can add more styling using additional CSS.
Advanced
AJAX
Use this option to choose whether to instantly add products to the cart using AJAX, or whether to reload the page. AJAX is enabled by default.
Tip: If you are adding multiple product tables to the same page and are using the add to cart checkboxes, then we recommend disabling AJAX add to cart. When AJAX add to cart is disabled, customers can select products from multiple tables on the same page and use any of the 'Add Selected to Cart' buttons to add ALL the selected products to the cart at once. This isn't possible when AJAX add to cart is enabled.
Shortcodes
Tick this box if you want content added by other shortcodes to appear in the product table. For example, you might be adding a button shortcode to add other types of button; embedded audio or media players; icon shortcodes; etc.
More information
Caching
Choose whether or not to cache the table contents to improve page load times.
Date format
Control how the 'Date' column is formatted in the product table. It is also used for any other column you have specified as a date.
If you don’t set this option, the default format in your WordPress settings will be used (see 'Date Format' under Settings → General in WordPress).
You can set the date format to any valid date/time format string. For example: F j, Y will format the dates in this format: “August 24, 2016”. See the WordPress Codex for more information.
No products message
Customize the text that will display if no products are found when the table first loads. For example, this message will appear if you have no products on your site, or if you're showing a category with no products.
Note: this option will have no effect if you have set a custom language using the wc_product_table_supported_languages filter.
No products filtered message
Customize the text that will display if no results are found when the user tries to search or filter the table.
Note: this option will have no effect if you have set a custom language using the wc_product_table_supported_languages filter.
Scroll offset
When paging between multiple pages of results in your table, Woocommerce Product Table will automatically “jump” back to the top each time. This is particularly useful if you are displaying a large number of products on each page. The plugin attempts to scroll to the correct position on the page but sometimes it doesn’t quite calculate this correctly. This is because each website and WordPress theme is different and some can have features which interfere with the scroll position – e.g. sticky navigation menus.
The Scroll Offset option lets you override the scroll amount or disable this behavior altogether. The default scroll amount is 15. If you find that the top of your table is “chopped off” when moving between pages, try increasing this to a larger number (e.g. 50). If you’d like to disable automatic scrolling, then enter "false".
Quick View Pro
The 'Product links' option will only appear if you're using our Quick View Pro plugin alongside Product Table.
Product Addons
These settings will only appear if you're using the official WooCommerce Product Add-Ons plugin with Product Table. These options may be removed at some point because we now have our own WooCommerce Product Options plugin, which works with WooCommerce Product Table without requiring any options.