For the complete documentation index, see llms.txt. This page is also available as Markdown.

Troubleshooting

1. Speed Optimizer by SiteGround blocks the WhatsApp Widget from displaying on the website.

If you are using the Speed Optimizer plugin on your website, then you might face this issue, because the plugin has got some added features which block the WhatsApp scripts from rendering properly.

Solution: Exclude the WhatsApp plugin's script from these three locations as shown in the screenshots below:

A screenshot showing SG Optimizer features

If you are using the WhatsApp PRO version, add the following scripts to each of the three sections of the SG Optimizer plugin;

If you are using the WhatsApp free version, then this is how the path looks like for you, hence you should add this and not the one above;

A screenshot showing WhatsApp plugin's scripts excluded in SG Optimizer settings

2. LiteSpeed Cache plugin breaks the WhatsApp Widget format on the website.

When you are using the LiteSpeed Cache plugin and the WhatsApp floating widget appears broken on the site, please exclude the CSS as shown below to ensure it functions correctly.

/wp-content/plugins/wp-whatsapp/assets/dist/css/style.css

Excluding CSS in Page Optimization setting for reference

3. WP Rocket plugin hides the WhatsApp Widget on the website.

If you are using WP Rocket and the floating widget does not show up, please try adding these following CSS to fix the issue.

  • CSS Files

In the Minify CSS files option, please add the following CSS to the Excluded CSS Files field: /plugins/wp-whatsapp/assets/dist/css/style.css /plugins/whatsapp-for-wordpress/assets/dist/css/style.css In the Optimize CSS delivery option, please add the following CSS to the CSS safelist field: /plugins/wp-whatsapp/assets/dist/css/style.css /plugins/whatsapp-for-wordpress/assets/dist/css/style.css #wa .wa__widget_container

  • JavaScript Files

In the Minify JavaScript files and Delay JavaScrips execution option, please add the following CSS to the Excluded JavaScript Files field: /plugins/wp-whatsapp/assets/dist/js/njt-whatsapp.js /plugins/wp-whatsapp/assets/js/whatsapp-button.js /plugins/whatsapp-for-wordpress/assets/dist/js/njt-whatsapp.js /plugins/whatsapp-for-wordpress/assets/js/whatsapp-button.js

Last updated

Was this helpful?