You can change the text shown in the Bitrix24 website widget.

Customize phrases with JavaScript

To edit widget text, add a JavaScript snippet to your site.

<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 override built-in phrases like these:

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

To see the full list of available variables, open your browser’s Developer Tools console and run:

console.table(BXLiveChat.__privateMethods__.localize);

Add custom phrases

You can add or override multiple phrases at once. Pass them as strings or as an object.

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

These phrases are not configurable through code:

• 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 update these phrases in settings:

1. Go to CRM > Contacts > Contact center.
2. Open the Live Chat block and click Change.
3. Expand Custom messages.
4. Update these fields:
• Welcome text (upper)
• Welcome text (lower)
• Agent unavailable text

Learn more about Live Chat settings

Add the code to Bitrix24 Sites

1. Open your site in the editor.
2. Add a new block.
3. Scroll to Other and select HTML code.
4. Click Edit on the block.
5. Paste your JavaScript code.
6. Save the block.

That’s it. The widget will now use your custom phrases.