Localizing text

This page shows you how to localize or customize strings in the SDK UI.

Strings in the Unified SDK are localized into the following 33 languages. They are listed in supported languages below.

Note: If you change the locale programmatically during the runtime of the application, the change won't be applied to the UI element. The UI element relies solely on the device locale. To change the UI element, you must restart the application to update the locale of the device itself.

List of localized strings

To change the default strings in your application, add replacements for the following strings. Make sure to include placeholders in the replacements of any strings that contain them.

Unified SDK

The Unified SDK component contains the following strings:

<resources>	<string name="zui_attachment_indicator_accessibility">Select an attachment</string>	<string name="zui_attachment_indicator_n_attachments_selected_accessibility">There are %d attachments selected</string>	<string name="zui_attachment_indicator_no_attachments_selected_accessibility">There are no attachments selected</string>	<string name="zui_attachment_indicator_one_attachments_selected_accessibility">There is one attachment selected</string>	<string name="zui_bot_label">BOT</string>	<string name="zui_button_label_no">No</string>	<string name="zui_button_label_yes">Yes</string>	<string name="zui_cell_text_suggested_article_header">Here\'s an article that may help:</string>	<string name="zui_cell_text_suggested_articles_header">Here are some articles that may help:</string>	<string name="zui_default_bot_name">Answer Bot</string>	<string name="zui_failed_message_copy">Copy</string>	<string name="zui_failed_message_delete">Delete</string>	<string name="zui_failed_message_retry">Retry</string>	<string name="zui_hint_type_message">Type a message…</string>	<string name="zui_label_dialog_delete_btn">Delete message</string>	<string name="zui_label_dialog_retry_btn">Retry sending</string>	<string name="zui_label_failed">Failed</string>	<string name="zui_label_send">Send</string>	<string name="zui_label_sent">Sent</string>	<string name="zui_label_tap_retry">Tap to retry</string>	<string name="zui_message_log_article_opened_formatter">%1$s opened article \'%2$s\'</string>	<string name="zui_message_log_article_suggestion_message">I found these articles:</string>	<string name="zui_message_log_default_visitor_name">Visitor</string>	<string name="zui_message_log_message_failed_to_send">[Failed to send]</string>	<string name="zui_message_log_transfer_option_selection_formatter">%1$s selected %2$s</string>	<string name="zui_retry_button_label">Retry</string>	<string name="zui_toolbar_title">Contact us</string>	<string name="zui_label_reconnecting">Reconnecting&#8230;</string>	<string name="zui_label_reconnecting_failed">Connection failed.</string>	<string name="zui_message_log_attachment_sending_failed">Attachment could not be sent</string>	<string name="zui_message_log_message_attachment_type_not_supported">Attachment type not supported</string>	<string name="zui_message_log_message_attachments_not_supported">Attachments not supported</string>	<string name="zui_message_log_message_file_exceeds_max_size">Exceeds max file size (%1$s)</string></resources>

Answer Bot

The Answer Bot component contains the following strings:

<resources>    <string name="zab_answer_bot">Answer Bot</string>	<string name="zab_cell_text_acknowledgement_did_help">Nice. Knowledge is power.</string>	<string name="zab_cell_text_acknowledgement_did_not_help">I see. Your question is still unresolved.</string>	<string name="zab_cell_text_answerbot_disabled_header">You can also get in touch.</string>	<string name="zab_cell_text_answerbot_disabled_response">Uh-oh. Sorry, something\'s up. I can\'t answer questions right now.</string>	<string name="zab_cell_text_contact_options_header">Would you like to get in touch?</string>	<string name="zab_cell_text_did_help_ask_again">If there\'s anything else I can find for you, just type another question.</string>	<string name="zab_cell_text_help_followup_question">Please tell us more. Was the article related to your question?</string>	<string name="zab_cell_text_inactivity_contact_option_header">Or you can get in touch.</string>	<string name="zab_cell_text_no_articles">I couldn\'t find any relevant articles.</string>	<string name="zab_cell_text_prompt">Ask me a question and I\'ll find the answer for you.</string>	<string name="zab_cell_text_prompt_another_question">Or you can ask another question.</string>	<string name="zab_cell_text_prompt_another_question_no_transfer_options">You can try asking me another question.</string>    <string name="zab_cell_text_question_did_article_help_with_question">Did the article you viewed help to answer your question?</string>	<string name="zab_cell_text_welcome">Hi!</string>	<string name="zab_error_load_article">Failed to load article</string>	<string name="zab_hint_type_your_question">Type your question…</string>	<string name="zab_view_article_help_followup_question">Was the article related to your question?</string>	<string name="zab_view_article_help_no">No, I need help</string>	<string name="zab_view_article_help_question">Does this article answer your question?</string>	<string name="zab_view_article_help_reason_didnt_answer">It\'s related, but didn\'t answer my question</string>	<string name="zab_view_article_help_reason_not_related">It\'s not related to my question</string>	<string name="zab_view_article_help_yes">Yes</string>	<string name="zab_view_article_loaded_accessibility">%s article loaded</string>	<string name="zui_button_label_no">No</string>	<string name="zui_button_label_yes">Yes</string>	<string name="zui_retry_button_label">Retry</string></resources>

Chat

The Chat component contains the following strings:

<resources>	<string name="zch_account_availability_failed">Hi. Unfortunately, we are unable to determine if an agent is available.</string>	<string name="zch_chat_comment_acknowledgement">Thank you for the feedback. You can now get back to your chat.</string>	<string name="zch_chat_comment_composer_hint">Type your comment&#8230;</string>	<string name="zch_chat_ended">Chat ended</string>	<string name="zch_chat_handover_message_selection">Chat with an agent</string>	<string name="zch_chat_rating_comment_action_label">Add a comment</string>	<string name="zch_chat_rating_comment_prompt_message">We value your feedback. If you like, you can also add a comment with more detail.</string>	<string name="zch_chat_rating_label_bad">Bad 👎</string>	<string name="zch_chat_rating_label_good">Good 👍</string>	<string name="zch_chat_rating_request_prompt">Hey, just checking in to see how your chat with %s has been going?</string>	<string name="zch_chat_transcript_email_prompt">What email address should the transcript be sent to?</string>	<string name="zch_chat_transcript_prompt">Would you like a transcript of this chat sent to your email?</string>	<string name="zch_chat_transcript_request_confirmation">Transcript will be sent to %1$s when the chat ends</string>	<string name="zch_chat_welcome_message_handover">OK. I will find someone who can help with your query.</string>	<string name="zch_end_chat">End chat</string>	<string name="zch_member_join">%1$s joined the chat</string>	<string name="zch_member_leave">%1$s left the chat</string>	<string name="zch_offline_form_completion_acknowledgement">We\'ve received your message and will get back to you as soon as possible.</string>	<string name="zch_offline_form_introduction_message">To contact you when someone is available, I need some more information.</string>	<string name="zch_offline_form_message_field_prompt">What can we help you with when we are back online?</string>	<string name="zch_offline_form_welcome_message">Hi. Unfortunately nobody is online at the moment.</string>	<string name="zch_offline_message">Unfortunately, nobody is online at the moment. Check back later.</string>	<string name="zch_pre_chat_department_field_message">Which department would be best able to answer your question?</string>	<string name="zch_pre_chat_email_field_hint">What is your email address?</string>	<string name="zch_pre_chat_email_field_invalid_message">The email address you entered is incorrect. Enter a valid email address.</string>	<string name="zch_pre_chat_email_field_message">What is your email address?</string>	<string name="zch_pre_chat_introduction_greeting">Hi!</string>	<string name="zch_pre_chat_introduction_message">I will find someone to help you. First I need a few pieces of information.</string>	<string name="zch_pre_chat_message_acknowledgement">I will find someone to help you. First I need some more information.</string>	<string name="zch_pre_chat_name_field_hint">What is your name?</string>	<string name="zch_pre_chat_name_field_message">What is your name?</string>	<string name="zch_pre_chat_phone_field_hint">What is your phone number?</string>	<string name="zch_pre_chat_phone_field_message">What is your phone number?</string>	<string name="zch_pre_chat_response_accepted_message">Thank you.</string>	<string name="zch_pre_chat_skip_button">Skip</string>	<string name="zch_pre_chat_welcome_message">Hi. What can we help you with today?</string>	<string name="zch_queue_position">Queue position: %1$d</string>	<string name="zch_request_transcript">Request transcript</string></resources>

The Support SDK strings used with Unified SDK are:

<resources>    <string name="zs_engine_greeting_message">Type a message and I will find someone who can help you.</string>	<string name="zs_engine_message_retry_button">Retry</string>	<string name="zs_engine_message_send_error_message">Something went wrong and I wasn\'t able to send your message. Please try again later.</string>	<string name="zs_engine_request_created_conversations_disabled_message">Thank you. A message has been sent to the team. If a reply is needed, they will contact you on %s.</string>	<string name="zs_engine_request_created_conversations_enabled_message">Thank you. A message has been sent to the team. You can view this message and add additional details here:</string>	<string name="zs_engine_request_created_request_list_button">View messages</string>	<string name="zs_engine_request_creation_email_invalid_message">Something isn\'t quite right with this address. Please try re-entering it.</string>	<string name="zs_engine_request_creation_email_prompt_hint">Enter your email&#8230;</string>	<string name="zs_engine_request_creation_email_prompt_message">If a reply is needed, someone will contact you by email. What is your email address?</string></resources>

The Support SDK contains a large number of other strings for its other components. See full details in Localize text in the Support SDK documentation.

To learn more about resource handling and strings in Android, see String resources in the official Android developer documentation.

To learn more about localization in Android, see Localize your app in the official Android developer documentation

Supported languages

Language code Language
ar Arabic
bg Bulgarian
cs Czech
da Danish
de German
el Greek
en-GB British English
en American English
es Spanish
fi Finnish
fil Filipino
fr French
he Hebrew
hi Hindi
hu Hungarian
id Indonesian
it Italian
ja Japanese
ko Korean
ms Malay
nb Norwegian
nl Dutch
pl Polish
pt-BR Brazilian Portuguese
pt Portuguese
ro Romanian
ru Russian
sv Swedish
th Thai
tr Turkish
vi Vietnamese
zh-Hans Simplified Chinese
zh-Hant Traditional Chinese