BugWP logo BugWP
Back to Community
Home / Community / Plugin → Joinchat

Why Your Join.chat WhatsApp Button Isn't Showing: Common Causes and Fixes

35 threads Sep 17, 2025 Plugin → Joinchat

Content

If you've installed the Join.chat plugin for WhatsApp and the iconic green button is nowhere to be found, you're not alone. This is one of the most common issues users face. Based on community troubleshooting, here are the most frequent reasons and their solutions.

1. Check Your Basic Configuration

Before diving into complex troubleshooting, always verify the basics. The most common reason the button doesn't appear is an incorrectly formatted phone number in the plugin's settings. Ensure you have entered a complete, valid international number (e.g., +34 699 999 999). Also, double-check the plugin's visibility settings. If 'Only Mobile' is enabled, the button will not appear on desktop computers.

2. JavaScript Conflicts: The Invisible Culprit

This is arguably the leading cause of the button not appearing. If your theme or another plugin has a JavaScript error, it can stop the Join.chat script from running entirely.

  • How to Diagnose: Open your browser's developer console (F12 on most browsers, then go to the 'Console' tab). If you see any red error messages, you have a JS conflict.
  • How to Fix:
    1. Temporarily deactivate all other plugins.
    2. Switch to a default WordPress theme (like Twenty Twenty-One).
    3. If the button appears, reactivate your plugins and theme one by one to identify the conflict. Common culprits are optimization plugins (even without minification enabled), lightbox scripts, or custom theme code that overrides functions like window.open().

3. Caching Issues

Caching plugins (e.g., W3 Total Cache) or server-level cache can serve an old version of your site that doesn't include the Join.chat button or its styles.

  • How to Fix: After making any changes to Join.chat's settings, always clear your website's cache completely. Also, try viewing your site in an incognito/private browser window to bypass your local browser cache.

4. CSS and Z-Index Conflicts

Sometimes the button is loading but is being hidden by another element on the page, such as a header, footer, or a notification bar from another plugin.

  • How to Diagnose: Right-click where the button should be and select 'Inspect'. Look through the HTML structure to see if a div with the class whatsappme or joinchat exists but is out of view or behind another element.
  • How to Fix: Add custom CSS to your theme (Appearance > Customize > Additional CSS) to adjust its position or stacking order. Common solutions include:
    • To bring it to the front: .whatsappme { z-index: 1000000 !important; }
    • To adjust its position: .whatsappme { bottom: 120px !important; }
    • To fix a floating conflict: .whatsappme__header { float: none !important; }

5. Special Characters in Messages

Using straight double quotes ("") in your call-to-action message can sometimes break the plugin's settings.

  • How to Fix: Replace any standard double quotes in your message with curly quotes (“ ”) or other characters.

6. Incompatible Page Builders

The plugin relies on standard WordPress hooks to load. If your homepage is built entirely with an external landing page builder (like Landingi) or a theme that doesn't use standard footer hooks, the button may not load on that page.

Summary: Your Troubleshooting Checklist

  1. Verify your phone number is correctly entered.
  2. Ensure 'Only Mobile' is disabled if you want it on desktop.
  3. Check the browser console for JavaScript errors.
  4. Clear all caching (plugin, server, and browser).
  5. Test with all other plugins disabled and a default theme.
  6. Inspect the element to check for CSS conflicts and adjust the z-index if needed.
  7. Remove any double quotes from your message text.

Following these steps will resolve the vast majority of issues where the Join.chat button fails to appear.

Related Support Threads Support