Read FAQ
NEW
Bitrix24 Support
Registration and Authentication
How to start
My Profile
Feed
Chats and Calls
Calendar
Bitrix24.Docs
Bitrix24.Drive
Bitrix24.Mail
Workgroups
Tasks and Projects
CRM
CoPilot - AI in Bitrix24
Contact Center
Sales Center
CRM Analytics (beta)
BI Builder
Sales Intelligence
Inventory Management
Marketing
Sites
Online Store (beta)
CRM + Online Store
CRM Store (beta)
Bitrix24.Sign
Company
Knowledge base (beta)
Automation
Workflows
Telephony
Market
Subscription
Settings
Enterprise
Mobile App
Desktop App
General questions
Bitrix24 On-Premise

Bitrix24Care

Customize phrases used in the website widget

You can customize phrases used in the Bitrix24 website widget.

Check if this option is available on your Bitrix24 plan.
Bitrix24 pricing page

How to customize phrases

To edit phrases in the website widget, use JavaScript code.

<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);

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_ERROR_DESC: 'Chat is down for repairs',
               BX_MESSENGER_TEXTAREA_PLACEHOLDER: 'Type your question',
                   })
       }
   });
});
</script>

Note that the following phrases cannot be customized using JavaScript:

  • 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!"

To edit them,

  1. Go to CRM > Add-ons > Contact center.

  2. Open the Live Chat block and click Change.

  3. Expand the custom messages section. Here are the corresponding fields:


How to insert a code in Bitrix24 Sites

When editing your website, add a new block.

Scroll down, click Other, and select HTML code.

Click Edit on the left of the block.

Paste the code and save the block.

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


Was this information helpful?
Integration specialist assistance
That's not what I'm looking for
Complicated and incomprehensible text
The information is outdated
It's too short. I need more information
I don't like the way this tool works
Go to Bitrix24
Don't have an account? Create for free