Back to Community
Home / Community / Plugin → Click to chat – holithemes

Troubleshooting Common 'Click to Chat' Issues: WhatsApp Not Opening Correctly

47 threads Sep 9, 2025 Plugin → Click to chat – holithemes

Content

Many users of the 'Click to Chat – HoliThemes' plugin encounter a common frustration: the WhatsApp button doesn't open the chat as expected. Instead, it might open a web browser, display an error, or show source code. This guide will help you diagnose and fix the most frequent causes of these issues.

Why This Happens

The plugin works by generating a special link based on your device. Problems usually stem from a few key areas: incorrect plugin settings, conflicts with other site elements (like themes or caching plugins), or external factors like browser behavior or changes made by WhatsApp itself.

Common Solutions

1. Check Your WhatsApp Number Format

An incorrectly formatted number is a leading cause of problems. The WhatsApp number field in the plugin settings should contain only digits, with no plus signs (+) or spaces.

  • Incorrect: +1 555 123 4567
  • Correct: 15551234567

After correcting the number, save your settings and clear any site and browser caches.

2. Configure the 'URL Structure' for Mobile

If the chat opens a web browser on mobile instead of the WhatsApp app, the URL structure might be misconfigured.

  1. Go to the 'Click to Chat' plugin settings.
  2. Find the 'URL Structure' section for 'mobile'.
  3. Try switching the option to 'WhatsApp://'.
  4. Save changes and clear your cache.

3. Enable the 'App First' Option

This setting tells the plugin to prioritize opening the native WhatsApp app on mobile devices. It's especially important if you use a caching plugin, as some cache plugins may not properly detect mobile devices.

  1. In the plugin's main settings, locate and check the 'App First' option.
  2. Save your changes.
  3. Crucially, clear your site's cache (from your caching plugin) and your browser's cache before testing again.

4. Address Cache Plugin Conflicts

Caching plugins are a very common source of device detection issues. If a page is cached for a desktop user, a mobile visitor might see that same cached version, causing the wrong link to be generated.

  • After making any changes in the 'Click to Chat' settings, always clear your site's cache.
  • Check your caching plugin's settings for an option to 'Create cache files based on device' or something similar, and enable it if available.

5. Browser-Specific Issues

Some browsers handle links differently.

  • Firefox for Android: By default, Firefox may not open links in external apps. Users must change their Firefox settings to allow opening links in supported apps.
  • Safari: Ensure your WhatsApp number is formatted correctly (no spaces or +), as this has been known to cause issues in Safari.

6. Check for Plugin or Theme Conflicts

If the WhatsApp icon is not visible or has styling issues, it may be due to a conflict.

  • A theme or other plugin might be applying CSS that hides the button (e.g., opacity: 0;).
  • As a test, temporarily switch to a default WordPress theme (like Twenty Twenty-Four) and disable other plugins to see if the issue resolves. If it does, reactivate them one by one to find the culprit.

When the Issue is External

Sometimes, the problem is not with the plugin but with WhatsApp's service. There have been historical instances where links to web.whatsapp.com would display page source code instead of the chat interface. These issues are resolved on WhatsApp's end, and plugin users must wait for them to deploy a fix.

Need More Help?

If you've tried all these steps and are still experiencing issues, sharing your website address can help others provide more specific advice. For detailed documentation, you can visit the HoliThemes website.

Related Support Threads Support