Back to Community

Understanding and Fixing TablePress Responsive Table Issues

Content

Many WordPress users rely on TablePress to display tabular data on their sites. A common point of confusion and troubleshooting involves making these tables display correctly on mobile devices, often referred to as 'responsive' design. This guide will explain the different responsive options available and help you diagnose and fix common problems.

Why Your TablePress Table Might Not Be Responsive

There are a few primary reasons a TablePress table might not behave responsively on your site:

  1. Feature Not Enabled: The most basic responsive feature, Horizontal Scrolling, is available in the free version but must be enabled on each table's 'Edit' screen under 'Table Features for Site Visitors'.
  2. Extension Changes: The old standalone 'Responsive Tables' extension has been retired. Its functionality has been integrated into the TablePress Premium versions. If you were using this extension and deactivated it, your tables may lose their responsive behavior.
  3. Shortcode Conflicts: If you are migrating from the old extension to a Premium version, the Shortcode parameters may need to be updated. The old extension used parameters like responsive="scroll", while the integrated Premium module uses the same syntax but may require the Premium license to be active on your site to function.
  4. Theme or Plugin Conflict: Occasionally, your WordPress theme or another plugin can apply CSS that interferes with the responsive styles from TablePress.

How to Troubleshoot Responsive Problems

Follow these steps to identify and resolve the issue.

1. Check Your Horizontal Scrolling Setting (Free Version)

For the free version, the 'Horizontal Scrolling' feature is the primary way to make wide tables responsive. Navigate to your table's 'Edit' screen in your WordPress admin dashboard and ensure the 'Horizontal Scrolling' checkbox in the 'Table Features for Site Visitors' section is checked. Save your changes and check your site again.

2. Verify Premium License Status

If you have purchased a TablePress Premium license, ensure it is properly installed and activated. Some users have reported that responsive features do not work until the Premium version is fully active on their site.

3. Combine Shortcode Parameters Correctly

When using multiple features, combine all parameters into a single Shortcode. For example, to use both Automatic URL Conversion and a responsive mode, your Shortcode should look like this:

[table id=1 automatic_url_conversion=true responsive=scroll /]

Using two separate Shortcodes will output two separate tables.

4. Test for Conflicts

To rule out a theme or plugin conflict, temporarily switch to a default WordPress theme (like Twenty Twenty-Four) and deactivate all other plugins. If the responsive feature works now, reactivate your theme and plugins one by one to find the culprit.

5. Understand the Available Responsive Modes

It's important to know which features are available in your version of TablePress:

  • Free Version: Horizontal Scrolling.
  • Premium Versions: Horizontal Scrolling plus four additional modes: Collapse, Stack, Flip, and a more flexible Scroll mode that works with tables containing combined cells.

Conclusion

Most responsive issues in TablePress can be solved by double-checking the settings on the table's 'Edit' screen, ensuring any Premium licenses are active, and using the correct Shortcode syntax. If problems persist after these steps, investigating theme or plugin conflicts is the recommended next step.

Related Support Threads Support