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

Troubleshooting Common Joinchat Issues: Popups, Z-Index, and JavaScript Conflicts

15 threads Sep 10, 2025 Plugin → Joinchat

Content

Joinchat is a popular plugin for adding WhatsApp chat functionality to WordPress sites. However, like any plugin, it can sometimes conflict with other elements of your website. Based on community reports, here are some of the most common issues and their potential solutions.

1. Popups or Menus Not Opening When Joinchat is Active

The Problem: A frequent issue is that popups (such as those from Elementor) or mobile menus fail to open when Joinchat is enabled. The console may show a JavaScript error like Uncaught TypeError: Cannot read properties of null.

Why It Happens: This is almost always caused by a conflict with optimization or caching tools. Specifically, Cloudflare's Rocket Loader feature is a common culprit. Rocket Loader modifies how JavaScript files load and can break the scripts that control both Joinchat and your popups.

How to Fix It:

  • Disable Rocket Loader: The most effective solution is to log in to your Cloudflare dashboard, navigate to the Speed > Optimization section, and disable Rocket Loader.
  • Exclude Scripts: If you prefer to keep Rocket Loader active, you can try configuring it to ignore specific scripts. You may need to add exceptions for both Joinchat and your page builder (e.g., Elementor) scripts. Consult Cloudflare's documentation for instructions on adding exceptions.

2. The Joinchat Button Is Not Visible

The Problem: The WhatsApp button is configured but does not appear on the page.

Why It Happens: The most common reason is that another element on the page is covering the button. This is typically a CSS z-index issue, where a different element has a higher stack order.

How to Fix It:

  • Increase the Z-Index: Add the following CSS code to your theme's "Additional CSS" section in the WordPress Customizer. Start with a very high value: 
    .joinchat { z-index: 9999999999 !important; }
    If that doesn't work, ensure you have entered a valid phone number in the Joinchat settings and that the button's visibility is not being controlled by a custom conditional rule.

3. The Joinchat Button Is Not Clickable

The Problem: The button is visible on the page, but nothing happens when you click it.

Why It Happens: This is typically caused by a JavaScript error originating from another plugin or theme feature, which halts all scripts on the page. One specific cause noted in the community is a conflict with the WP Rocket plugin related to Google Analytics optimization.

How to Fix It:

  • Find the Conflicting Script: Open your browser's console (F12) and look for any red error messages. This can help identify the problematic script.
  • Disable Optimizations: If you use a caching/optimization plugin like WP Rocket, try temporarily disabling its JavaScript optimization features. If the button becomes clickable, re-enable the optimizations one by one to identify the specific setting causing the conflict.
  • Check Analytics Settings: If the error mentions Google Analytics, ensure your Universal Analytics ID is correctly configured in your optimization plugin's settings.

4. Extra Text in Meta Titles or Page Content

The Problem: Unwanted text like "Joinchat" or "join.chat" appears in meta titles or on the page itself.

Why It Happens: The Joinchat plugin does not add text to meta titles. This issue is usually the result of malformed HTML on the page, which can cause browsers or SEO toolbars to misread the page structure.

How to Fix It:

  • Validate your page's HTML using a tool like the W3C Markup Validation Service. Fix any errors related to unclosed tags or improper nesting, as these are often the root cause.

General Troubleshooting Steps

If you encounter an issue not listed above, try these universal steps:

  1. Conflict Test: Temporarily switch to a default WordPress theme (like Twenty Twenty-Four) and disable all other plugins except Joinchat. If the problem resolves, reactivate your plugins one by one to find the conflict.
  2. Clear All Caches: Clear your browser cache, any server-side caching, and your CDN cache (like Cloudflare) to ensure you are viewing the most recent version of your site.

By methodically working through these common problems, most issues with the Joinchat plugin can be resolved efficiently.

Related Support Threads Support