top_en
Log In
Your Bitrix24
Authorize to enter
your company's Bitrix24.
Log In

Bitrix24Care

Customize phrases used in the website widget

You can customize phrases used in the Bitrix24 Website Widget.

This option is available to Standard and Professional plans subscribers only.

Use JavaScript code to do that:

<script>
window.addEventListener('onBitrixLiveChat', function(event)
{
	var widget = event.detail.widget;

	widget.subscribe({
		type: BX.LiveChatWidget.SubscriptionType.configLoaded,
		callback: function() 
		{
			widget.addLocalize({VARIABLE: 'New Text'});				
		}
	});
	
});
</script>

For example, you can customize these variable phrases:

BX_LIVECHAT_LOADING – "Please wait"
BX_LIVECHAT_ERROR_TITLE – "Unfortunately we could not load live chat :("
BX_LIVECHAT_ERROR_DESC – "Please use some other communication tool or try again later."
BX_LIVECHAT_VOTE_BUTTON – "Rate our service"
BX_MESSENGER_TEXTAREA_PLACEHOLDER – "Enter message..."
The full list of variable phrases can be invoked by entering the following command to the browser's Developers Tools console:
console.table(BXLiveChat.__privateMethods__.localize);

You can add new phrases to the code as a string or as an array:

<script>
window.addEventListener('onBitrixLiveChat', function(event)
{
	var widget = event.detail.widget;

	widget.subscribe({type: BX.LiveChatWidget.SubscriptionType.configLoaded,
		callback: function(){widget.addLocalize({BX_LIVECHAT_LOADING: 'Wait, Live Chat is loading'});
			widget.addLocalize({BX_LIVECHAT_ERROR_TITLE: 'Oops, something went wrong'});				
			
			widget.addLocalize({BX_LIVECHAT_VOTE_BUTTON: 'Give us a score!',
				BX_LIVECHAT_OFFLINE: 'Sorry, our agents are sleeping',
				BX_LIVECHAT_ONLINE_LINE_1: 'Our team',
				BX_LIVECHAT_ONLINE_LINE_2: 'is ready to help you',					
				BX_LIVECHAT_ERROR_DESC: 'Chat is down for repairs',
				BX_MESSENGER_TEXTAREA_PLACEHOLDER: 'Type your question',
                    })
		}
	});
});
</script>

How to insert a code

In the Sites section, select a website. Then you need to add a new block.

Scroll down > click Other > HTML code.

Click Edit.

Paste the code > click Save > Publish.

Done! Phrases used in the website widget have been successfully customized!


Important!

You cannot customize the following phrases using JavaScript anymore:

  • BX_LIVECHAT_ONLINE_LINE_1 – "We are online"
  • BX_LIVECHAT_ONLINE_LINE_2 – "and ready to help!"
  • BX_LIVECHAT_OFFLINE – "One of our representatives will get back to you shortly!"

You can customize these phrases in the Live Chat settings > custom messages section:

  • Welcome text (upper).
  • Welcome text (lower).
  • Agent unavailable text.
This helped Thanks :) This didn't help Sorry :(
Could you please tell us why:
It's not what I'm looking for
It's too complicated