Back to Community
Home / Community / Plugin → Joinchat

Why Your Joinchat Tooltip Isn't Showing (And How to Fix It)

25 threads Sep 9, 2025 Plugin → Joinchat

Content

One of the most common issues users report with the Joinchat plugin is the tooltip not displaying as expected. The tooltip is the short text message that appears next to the WhatsApp button, designed to engage visitors. If it's not showing up, appearing in the wrong language, or disappearing too quickly, it can be frustrating.

Based on community reports and solutions, here are the most frequent causes and their fixes.

1. Caching Issues (The Most Common Culprit)

If your tooltip text changes aren't visible, the problem is almost always related to caching. This can be your browser cache, a server-side cache, or a caching/optimization plugin.

How to Fix It:

  • Clear All Caches: After making any changes in the Joinchat settings, clear your browser cache and any caching plugin cache (e.g., LiteSpeed, WP Rocket, W3 Total Cache).
  • Check the Un-cached Version: Some optimization plugins can conflict with Joinchat. Try appending ?nonitro (or a similar parameter) to your URL to view a non-optimized version of the site and see if the tooltip appears correctly.

2. Multilingual Translation Conflicts

If you're using a translation plugin like WPML or Polylang and your tooltip text reverts to a previous message or doesn't change, the issue likely lies in the translation string management.

How to Fix It:

  • Do not just change the text in the main Joinchat settings. You must also update the corresponding string for each language within your translation plugin's interface (e.g., the WPML String Translation module).
  • Ensure you have not accidentally translated an empty setting, which can cause old text to persist.

3. The Tooltip is Working, But You Expect Different Behavior

By default, the tooltip is designed to be a hover-triggered or briefly displayed call-to-action. It is not meant to be permanently visible to avoid being intrusive.

How to Change This Behavior:

  • For Permanent Display: If you want the tooltip to be always visible, you can add this CSS code in Appearance > Customize > Additional CSS:
    .joinchat__tooltip { opacity: 1 !important; }
  • To Re-show the Tooltip: The default behavior is to show the tooltip once per session. To make it reappear more frequently, you would need to add custom JavaScript.

4. Plugin or Theme Conflicts

In rare cases, another plugin can cause a conflict that breaks the tooltip's functionality.

How to Fix It:

  • Perform a standard conflict test. Temporarily deactivate all other plugins and switch to a default WordPress theme (like Twenty Twenty-Four). If the tooltip works, reactivate your plugins one by one to identify the culprit.

5. Incorrect Configuration

Sometimes, the issue is a simple misconfiguration.

Things to Double-Check:

  • Ensure you have actually entered text in the Tooltip field in the Joinchat settings. The gray placeholder text is just an example and will not be displayed on the front end.
  • Verify the plugin's visibility settings. The tooltip might be configured to only show on specific pages (e.g., only on product pages).

If you've worked through these steps and your issue persists, it can be helpful to search the WordPress support forums for similar reports or share your site URL when asking for help so others can see the problem firsthand.

Related Support Threads Support