Mobile visibility & responsive options
WooCommerce Product Table comes with several options for controlling how the tables behave on different screen sizes, for example mobiles and tablets.
The options on this page are controlled individually in the shortcode for each product table, and do not appear on the plugin settings page.
wrap option tells the table whether to wrap long content onto multiple lines, or to keep everything on a single line and hide the rest. The default is
true which means longer content will “wrap” onto extra lines as needed. Setting this to
false will ensure that each row is exactly one line high.
[product_table columns="name,stock,price,add-to-cart" wrap="false"]
priorities option is only relevant when displaying the table on smaller screen sizes (mobiles, tablets, etc) or when you have a lot of columns in your table and the plugin can’t fit everything in. When the screen size gets too small, the plugin will collapse certain columns down so they are no longer visible, and a “+” icon will appear at the left of each row. This allows the user to expand the row to show its full contents.
Priorities are used to determine the order in which columns are “collapsed” on smaller screens. WooCommerce Product Table has some default priorities are used and this option lets you override them. The lower the number, the higher priority that column has. So a column with a priority of “1” would have the highest priority and be collapsed last.
You need to set one priority for each column, separated by commas, for example:
[product_table columns="name,categories,tags,price,add-to-cart" priorities="1,4,5,3,2"]
column_breakpoints option gives you fine-grained control over the breakpoints for each column when viewed at smaller screen sizes.
By default, WooCommerce Product Table will show or hide columns on smaller screens based on the
priorities option described above (or the default priorities if none are set). If you wish to set more specific breakpoints, you can set one of the following options for each column:
default. For example, setting a breakpoint of tablet for a column means it will display on tablet devices, but not on mobiles or desktop screens.
all option means the column will always be visible, regardless of screen size. The
none option means it will not be shown in the table, but the column will still show in the child row (or modal window) when expanded. The
default option will let the plugin decide when it is hidden (using the
priorities option if set).
You should set one option for each column in the table, for example:
[product_table columns="name,categories,tags,price" column_breakpoints="default,desktop,mobile,all"]
- You do not need to list column names in the column_breakpoints option. You just need to list the visibility for each column in the correct order. In the above example, the 4 columns are
name,categories,tags,pricein this order. To set column breakpoints for these columns, you need to list the visibility for 4 columns in the same order, e.g.
default,desktop,mobile,all. WooCommerce Product Table will use the order of this list to set the visibility for each column – so in this example, the 3rd column is ‘tags’ and will be visible on ‘mobile’, and the 4th column is ‘price’ and will be visible on all devices.
- WooCommerce Product Table can only display columns that physically fit into each screen size. The column_breakpoints option will be ignored if the columns that are set to visible will not fit on a specific screen size. For example, if you have 20 columns and set them all to ‘all’ then some of them will still be hidden. We have coded the plugin this way to prevent it from ever looking broken on any screen size.
I’ve hidden the first column and it’s not working!
By default, it’s not possible to hide the first column in your table because the expandable + plus icon is contained within the first column. If you need to hide the first column, then you’ll also need to use the responsive_control option to put the + plus icon in its own column of the table.
[product_table columns="name,categories,tags,price" responsive_control="column" column_breakpoints="none,desktop,mobile,all"]
WooCommerce Product Table is built on the jQuery DataTables library. In addition to the options listed above, you can also use any of the options listed on this page of the DataTables documentation. These options are more than most of our users will need, but are useful if you want even more fine-grained control over which columns appear on each device.
[product_table columns="name,categories,tags,price" column_breakpoints="all,not-mobile,desktop,tablet"]
When the plugin can’t fit all the data within the space available (for example, on mobile devices), a “plus” icon appears to the left of each row to allow the user to show or expand the full content. The responsive_control option sets whether the “+” icon control is displayed inside the first column (
responsive_control="inline") or within its own separate column (
responsive_control="column"). Defaults to
[product_table columns="name,short-description,price,add-to-cart" responsive_control="column"]
responsive_display option determines 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). By default, the extra columns are displayed inside a child row which can be shown by clicking the “+” icon at the start of each row. You can also choose from the following options:
child_row– the default option. Extra data will be displayed in a hidden child row.
child_row_visible– Extra data is displayed in a child row which is expanded automatically when the table is first viewed.
modal– 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.)
[product_table columns="name,stock,price,add-to-cart" responsive_display="modal"]
Warning: The ‘checkbox’ add to cart button style is not compatible with the modal window option. This is because multi-select checkboxes can only appear on a single page, and not within separate modal windows. If you’re using the ‘modal’ option then we recommend using the ‘button’ or ‘button_checkbox’ options so that mobile users can still add your products to the cart.
Troubleshooting – Why can’t I hide the first column of my table?
If the above options aren’t working when you try to hide the first column of your table on smaller screens, then this is because the first column also contains the + icon. This is needed to let users reveal the hidden child row, so you can’t hide the first column in this case.
To fix the problem, add
responsive_control="column" to your product table shortcode. This will put the + icon in its own column so that you can successfully hide the first column.
FAQ – Can users click on the first column to open the hidden child row instead of the + icon?
Yes, you can do this by disabling the link to the single product page in the first column. If the first column does not link to the single product page, then users can click on it or the plus icon to open up the hidden child row.
Please note that this will only work if the responsive_control option is set to
inline (the default) and not