Frequently Asked Questions
Find quick answers to common questions about the Click to Chat plugin. If we can’t find what you’re looking for, contact our support team.
Debug & Troubleshoot
Chat Widget appearing on the site?
This can happen for several reasons:
Ensure the plugin is activated.
Clear any caching plugins or CDN cache.
Confirm visibility settings and display rules like device type, post/page ID, etc.
Ensure the plugin is activated.
Clear any caching plugins or CDN cache.
Confirm visibility settings and display rules like device type, post/page ID, etc.
Changes made in plugin settings are not reflecting on the frontend.
This is often due to caching. please clear cache from
Plugin cache (e.g., LiteSpeed, WP Rocket)
CDN cache (if configured) (e.g., Cloudflare)
Server-side cache (if configured)
Browser cache
Plugin cache (e.g., LiteSpeed, WP Rocket)
CDN cache (if configured) (e.g., Cloudflare)
Server-side cache (if configured)
Browser cache
No WhatsApp number found!
This occurs when no number is added in the plugin settings. Go to Settings → Click to Chat, enter our WhatsApp number with the country code, and save the changes.
Why isn’t the WhatsApp number updating after making changes?
Possible Causes & Fixes:
Clear all caches—plugin, CDN and server-side.
If using a multilingual plugin (e.g., WPML, Polylang), update the number in all languages and check for translated strings that may override it.
Clear all caches—plugin, CDN and server-side.
If using a multilingual plugin (e.g., WPML, Polylang), update the number in all languages and check for translated strings that may override it.
The WhatsApp widget is not showing on mobile devices.
Check the Display Rules settings to ensure the widget is enabled for mobile devices. Also, verify that no custom CSS or JavaScript is hiding it on mobile.
Setup
How do I install the Click to Chat plugin?
From WordPress Dashboard under Plugins → Add New, search for “Click to Chat”, then install and activate.
How do I install the Click to Chat Pro version?
Download the Pro ZIP from our account after purchase. Go to Plugins → Add New → Upload Plugin → select zip → Install → Activate. Add the software license and activate the license (No need to deactivate the free version. The Pro plugin is the extension to the free plugin).
Click to Chat Pro Plugin Installation
HoliThemes Shop
Click to Chat Pro Plugin Installation
HoliThemes Shop
Do I need to uninstall the free version before activating the Pro?
No, there’s no need to uninstall or deactivate the free version. The Pro version works as an add-on to the free plugin. Just install and activate the Pro version alongside the free version—our existing settings will remain intact.
How do I enter my license key after installing Pro?
After activating the Pro version, go to the Shop page where the product was purchased. Click on “View Licenses” next to the relevant product. Then click the key icon or “Manage Sites” to find our license key. Once we have the key, go to the plugin settings in our WordPress dashboard, enter the key under “License Key”, and click Save Changes. This will activate the Pro features.
How to get Click to Chat License Key
How to get Click to Chat License Key
My plugin isn’t showing after installation. What now?
Clear any site cache or CDN to reflect changes.
Review display settings:
– Visibility based on post/page rules.
– Device-specific rules or delays may activate later.
Do I need a WhatsApp Business account?
No, We can use Click to Chat with a regular WhatsApp account. However, a WhatsApp Business account provides additional features like business profile, quick replies, and labels which can enhance our customer communication.
Display Settings
Can I show the chat widget only on specific pages?
Yes, in the Display settings, We can choose where the chat button appears. We can include or exclude individual pages, posts, categories, or even custom post types by using the page level settings.
Show only on selected pages
Show only on selected pages
How can I delay the chat widget from appearing immediately?
In the Display Settings section, scroll to the Time Delay option. We can then set the number of seconds to wait before the chat widget appears to our visitors.
Time Delay – Documentation
Time Delay – Documentation
Can we show chat widget only after scrolling?
Yes, in the Display Settings section, use the Scroll Percentage option. Set a percentage (e.g., 50%) so the chat widget only appears once the visitor has scrolled that portion of the page.
Scroll Delay – Documentation
Scroll Delay – Documentation
Show/hide chat widget by device type?
Yes, there are toggles in Display Rules to control visibility on mobile and desktop devices separately. This is useful if we want to show the chat on mobile only, or vice versa.
Show/Hide on Mobile or Desktop – Documentation
Show/Hide on Mobile or Desktop – Documentation
Show/hide the widget on Specific Posts and Categories?
Navigate to the Display Rules settings in the plugin. Scroll to the Post ID and Category sections. Add the specific post IDs or category names where we want to hide or show the widget. The settings will apply only to those selected posts or categories, and the widget will remain visible or hidden as configured on the rest of the site.
Show/Hide Widget by Post ID or Category – Documentation
Show/Hide Widget by Post ID or Category – Documentation
Greetings
How to set up the greeting dialog box?
Go to Click to Chat → Greetings and enable the greeting dialog. From there, we can customize its content, appearance, and colors to match our brand.
How can I add a form before the chat begins?
In the Greetings section, enable the Greeting Form option. We can add fields like name, email, and message. This form appears before the WhatsApp chat starts.
Greeting Form Setup
Greeting Form Setup
Can I use the form data in the WhatsApp message?
Yes, we can pass the form inputs as pre-filled WhatsApp messages. Alternatively, we can use Webhooks to send form data to CRMs, email handlers, or other external tools.
Form Data in Prefilled WhatsApp Message
Form Data in Prefilled WhatsApp Message
How to send greeting form data to webhooks?
In Form Settings, enable the Webhook option and enter the target URL. This sends submitted data like name, email, page URL, WhatsApp number, and UTM parameters to third-party tools.
Webhook Setup
Webhook Setup
What happens if we don’t enable greetings?
If greetings are disabled, only the WhatsApp icon or widget appears. The chat starts directly without any dialog or form.
How can we control the greetings dialog behavior?
We can choose from multiple modes in the Greetings section: Open mode shows the dialog automatically, Closed mode shows it only after clicking the WhatsApp button, and Preset mode opens it on desktop but remains closed on mobile.
Greetings behavior
Greetings behavior
Can we customize the greeting dialog box?
Yes, we can fully customize the greeting dialog box’s appearance, including colors, fonts, and layout. This allows us to match it with our website’s design.
Styling & Appearance
How can we customize the appearance of the Click to Chat widget?
Select any style and navigate to the Customize section. There, we can fully personalize the widget’s appearance—colors, size, shape, and visibility.
Customize styles
Customize styles
How to change the widget’s position on the screen?
Under Click to chat Style, Position section, we can select the position type (fixed/absolute) and position to place (e.g., bottom right, top left), giving us complete control over where the widget appears in the viewport.
Position to place
Position to place
Can we use custom icon instead of default WhatsApp widget?
Yes, by selecting Style 99, we can upload any image to use as the widget icon—ideal for custom branding.
Style 99
Style 99
Change Click to Chat widget color?
Navigate to Click to Chat → Customize, where we can set custom background colors, icon colors, and text colors to match our website’s branding.
Can we display a notification badge on the widget?
Yes, under Click to Chat → Other Settings, we can enable the notification badge option. We can add a custom number (like 1, 3, etc.) and set its background color and text color for better visibility.
Notification Badge
Notification Badge
Is animation available for the chat widget icon?
Yes, under Click to Chat → Other Settings, we can enable animations like bounce or shake to grab attention.
Animations
Animations
Widget Behavior
How to hide the Click to Chat widget when we are offline?
Navigate to Click to Chat and scroll to Business Hours(PRO) then enable the “Hide when offline” checkbox after setting up the Working hours. The widget will automatically hide outside the specified working hours.
Business Hours – Hide When Offline
Business Hours – Hide When Offline
Different WhatsApp number and call-to-action when offline?
In Click to Chat Business Hours(PRO) settings, uncheck the “Hide when offline” box. we’ll then see options to set an offline WhatsApp number and a different call-to-action message, which will display when the team is offline.
Why the Click to Chat widget not showing or hiding based on Business Hours?
This issue typically occurs when the Business Hours setting isn’t enabled or is misconfigured. Make sure the “Enable Business Hours” option is checked under Click to Chat → Business Hours. Also, confirm that the working hours match our desired availability and the server’s time zone. If it’s still not working, clear cache or optimization plugins might delay updates.
Available URL options to open WhatsApp?
We can choose between wa.me, web.whatsapp.com, or any custom URL. Each opens WhatsApp in a different way—mobile, desktop, or a link we set.
URL structure
URL structure
Integrations & Analytics
Is Click to Chat compatible with WPML or Polylang?
Yes, Click to Chat is fully compatible with WPML and Polylang plugins. We can translate all the plugin strings, including the WhatsApp number and pre-filled messages, to match the selected language on the site. This allows us to provide a consistent and localized experience for visitors across different languages.
WPML Polylang
WPML Polylang
Can I customize the WhatsApp number, Pre-filled message, and Call to Action for each language?
Yes, multilingual plugins allow us to translate individual fields like number, message, and call-to-action button text for each language.
Why does the WhatsApp number change when using translation plugins like WPML or Polylang?
When we use WPML or Polylang, the number changes automatically based on the translation settings. It’s updated only through the translation tools—not in the plugin’s admin settings. If a number was changed but not reflecting, clear or update the string translation to apply the new value.
Can I use Click to Chat with any WordPress theme or page builder like Elementor or Divi?
Absolutely. Click to Chat is designed to work seamlessly with all major page builders such as Elementor, Divi, Beaver Builder, and more. It also supports all WordPress themes, so we don’t need to worry about compatibility issues when building or customizing our site.
How can I track the number of users clicking on the WhatsApp widget?
We can track interactions by integrating Click to Chat with Google Analytics 4 (GA4) or Google Tag Manager (GTM). When event tracking is enabled, each click on the WhatsApp widget is logged as an event. This allows us to see how many users clicked the button and which pages triggered those clicks—helping us understand engagement and improve conversions.
Analytics
How to add a webhook in the Click to Chat plugin?
Navigate to Click to Chat → Other settings and scroll to Webhooks, enter the webhook URL where we want to send the data. When a user clicks on the chat, the plugin will send information like WhatsApp number, trigger source, page URL, UTM parameters, and cookies to the given webhook.
Webhooks
Webhooks
Why is the webhook not triggering when a new chat starts?
Ensure the webhook URL is correct and publicly accessible. Also, confirm that the trigger event is enabled in the plugin settings.
Cache & Performance
Plugin changes not showing on site? What to do?
This is often due to cache. Clear plugin cache (like WP Rocket or LiteSpeed). Also, check if a CDN like Cloudflare is caching the old version.
Clear Cache
Clear Cache
How to clear cache when using WP Rocket or LiteSpeed Cache?
In WP Rocket, go to the dashboard and click “Clear Cache.” In LiteSpeed, use the “Purge All” option from the LiteSpeed Cache menu in WordPress.
The translated WhatsApp number isn’t changing in WPML/Polylang. Why?
If a number is changed in one language and not reflected in others, update or clear the string translation cache so the new value loads correctly.
Why is my CDN affecting the widget’s behavior?
CDNs often serve cached versions of our site. Make sure to purge the CDN cache after making changes in the plugin to reflect the updates properly.
Features
Different WhatsApp numbers per visit?
Yes. We can enable the random number feature to load a different number on each visit, or use the sequence option to rotate numbers in a specific order.
Random number setup
Random number setup
Is it possible to show a form before starting the WhatsApp chat?
Yes, this is available in the Pro version. It allows us to collect user details like name, email, or message before redirecting them to WhatsApp.
Greetings Form
Greetings Form
Can we display the widget only for logged-in users?
Yes, we can control widget visibility based on the login status of visitors. Choose to show or hide the widget for logged-in or non-logged-in users from the Display Rules settings.
User login display rules
User login display rules
Can we show different WhatsApp numbers and display the widget based on the visitor’s country or location?
Yes. Using Display Rules, we can control where the widget appears based on the visitor’s country. And with multilingual plugins like WPML or Polylang, we can also set different WhatsApp numbers based on the selected language or region.
PRO
How do I activate the Pro version of Click to Chat?
After purchasing, visit the Shop → View Licenses section. Click the key icon or “Manage Sites” to get the license key. Then, go to plugin settings in our site, paste the key in the Software License field, and Activate.
How are updates handled for the Pro version?
Once the Pro license is activated, we’ll receive updates directly in our WordPress dashboard like any other plugin. Keep your license active to ensure smooth updates.
Can we use the Pro version on multiple websites?
Yes, if our license plan supports multiple sites, we can use the plugin on more than one site. we can manage activations and deactivations from the “Manage Sites” section of our license page.
Are lifetime updates and support included?
If we’ve purchased a lifetime plan, updates and support are included without any renewal. For annual plans, updates and support are available as long as the license is active.
Downloading the Invoice
Sign in to our shop account and go to the Purchase History page. Click on “View Invoice” for the specific product. The invoice will be displayed, and you can download it directly from there. You can also update the address details before downloading to ensure the correct information appears on the invoice.
Is there a refund policy if it doesn’t work for me?
Yes, we offer a 14-day money-back guarantee if the plugin doesn’t meet your needs.