Frequently asked questions

You can change the position of the button so that nothing covers it by adding this CSS in Appearance > Customize > Additional CSS:

.joinchat { z-index:9999; }

Higher z-index values are above, the default value is 1000. If you need to raise it:

/* always */
.joinchat { --bottom: 60px; }

/* mobile only */
@media (max-width: 480px), (max-width: 767px) and (orientation: landscape) {
 .joinchat { --bottom: 60px; }
}

Joinchat does not provide shortcodes, but you can easily create links to WhatsApp in two ways:

add an anchor link to #whatsapp (opens WhastApp directly) or #joinchat (displays the chat window). e.g.:

<a href="#joinchat">WhastApp Chat</a>

Add a “class” css to any element, joinchat_app (opens WhastApp directly) or joinchat_open (displays the chat window). e.g.:

<img src="contact.jpg" class="joinchat_open" alt="Contactar">

It works with your phone and message settings with dynamic variables, even on pages where Joinchat is not visible.

For custom links to WhatsApp, you can create the url with our free tool WhatsApp link generator and copy it into your links.

By default the Joinchat configuration is a submenu under “Settings” and can only be edited by users with administrator role. You can change the required ability to edit the general Joinchat settings with the joinchat_capability filter.

e.g.: allow Shop Manager:

add_filter( 'joinchat_capability', function(){ return 'manage_woocommerce'; } );

e.g.: allow editors:

add_filter( 'joinchat_capability', function(){ return 'edit_pages'; } );

By changing joinchat_capability the Joinchat menu will be placed as a direct menu in your wp-admin but you can also force it with the joinchat_submenu filter:

e.g.: force as menu:

add_filter( 'joinchat_submenu', '__return_false' );

e.g.: force as submenu:

add_filter( 'joinchat_submenu', '__return_true' );

Joinchat settings are saved in the main language of your site. For translation of other languages go to WPML/Polylang Settings > String Translations, filter by the “Joinchat” string group and update the strings for each language. For more information visit our documentation on translations, WPML and Polylang.

Joinchat sends a custom event when the user clicks to launch WhatsApp. If Global Site Tag (gtag.js) is detected:

gtag('event', 'click', { 'event_category': 'JoinChat', 'event_label': out_url })

If Universal Analtics (analytics.js) is detected:

ga('send', 'event', 'JoinChat', 'click', out_url })

If your site does not use standard names for UA tracking (‘ga) or the data layer (‘dataLayer’) you can set your custom names with this filter:

add_filter( 'joinchat_get_settings', function( $settings ){
	$settings['ga_tracker'] = 'gaCustom';
	$settings['data_layer'] = 'dataLayerCustom';
	return $settings;
} );

Joinchat sends an event (if GTM is detected) when the user clicks to launch WhatsApp:

dataLayer.push({ 'event': 'JoinChat', 'eventAction': 'click', 'eventLabel': out_url });

Joinchat sends a custom event if it detects Facebook Pixel when the user clicks on launch WhatsApp:

fbq('trackCustom', 'JoinChat', { eventAction: 'click', eventLabel: out_url });

There is a JavaScript event that Joinchat fires automatically before launching WhatsApp and can be used to add your custom tracking code (or other needs).

jQuery(function($){
 $(document).on('joinchat:open', function (event, args, settings) {
 // Your staff
 // Note: args.link is the link to open, you can change it
 // but only wa.me, whastapp.com or current domain are allowed.

 // e.g.: Google Ads conversion
 gtag_report_conversion();
 });
});

By default Joinchat validates phone numbers, being able to choose the country flag and formatting the number. If you want to remove this option and form a complete number, you can do it with this filter:

add_filter( 'joinchat_enhanced_phone', '__return_false' );