Menu

Localization and UI templating

This guide is for Flex UI 1.x and channels that use Programmable Chat and Proxy. If you are using Flex UI 2.x or you are starting out, we recommend that you build with Flex Conversations (beta).

Any string in Flex WebChat UI can be changed. Within the context of FlexWebChat.manager you can specify any string you want to change to override its default value.

With templated strings you can also:

Read more about it in Flex UI localization and templating

This example shows how to override WelcomeMessage shown to user in the chat

FlexWebChat.Manager.create(configuration)
    .then(manager => {

        manager.strings.WelcomeMessage = "I am a new Welcome Message";

        ReactDOM.render(
            <FlexWebChat.ContextProvider manager={manager}>
                <Flex.RootContainer />
            </FlexWebChat.ContextProvider>,
            document.getElementById("root")
        );
    });

List of templated strings in WebChat

  • EntryPointTagLine - Text show on the WebChat entry point
  • InvalidPreEngagementMessage - Text shown if the Pre engagement form is turned on ( startEngagementOnInit=true ), but no Pre engagement form is specified
  • PredefinedChatMessageAuthorName - Author of the predefined message

  • PredefinedChatMessageBody - Body of the predefined message

  • FieldValidationRequiredField - Text shown, if required field in the pre engagement form is not filled
  • FieldValidationInvalidEmail - Text shown, if validation for email type field in pre engagement for is not passed
  • InputPlaceHolder - Text shown in the edit box when no content has been entered
  • TypingIndicator - Text used for typing indicator, user name is denoted by {{name}}. For example "{{name}} is typing"
  • Read - Text below last message that has been read by other party
  • MessageSendingDisabled - Text shown if sending messages has been disabled
  • Today - Text shown in message list to group messages from today's date
  • Yesterday - Text shown in message list to group messages from yesterday's date
  • WelcomeMessage - welcome message shown to customers who enter chat in Webchat UI
  • NotificationMessage - text shown in notification message. Custom error message denoted by {{message}}
  • MessageCanvasTrayContent - a post-engagement message displayed in the tray of the webchat
  • MessageCanvasTrayButton - button caption to start a new chat

Default string values

    EntryPointTagline: "Chat with us",
    MessageCanvasTrayContent: `
        <h6>Thanks for chatting with us!</h6>
        <p>If you have any more questions please reach out to us again.</p>`,
    MessageCanvasTrayButton: "START NEW CHAT",
    InvalidPreEngagementMessage: "Pre-engagement forms have not been set and are required to initiate the web-chat. " + "Please configure these now in setup.",
    InvalidPreEngagementButton: "Learn more",
    PredefinedChatMessageAuthorName: "Bot",
    PredefinedChatMessageBody: "Hi there! How can we help you today?",    
    InputPlaceHolder: "Type message",
    TypingIndicator: "{{name}} is typing ... ",
    Read: "Read",
    MessageSendingDisabled: "Message sending has been disabled",
    Today: "TODAY",
    Yesterday: "YESTERDAY",
    MessageCanvasTrayButton: "START NEW CHAT",
    WelcomeMessage: "Welcome to customer service",
    Save: "SAVE",
    Reset: "RESET",
    MessageCharacterCountStatus: "{{currentCharCount}} / {{maxCharCount}}",
    SendMessageTooltip: "Send Message",
    FieldValidationRequiredField: "Field required",
    FieldValidationInvalidEmail: "Please provide a valid email address"
Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

Thank you for your feedback!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!

thanks-feedback-gif