Localizing the UI

Introduction

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

Strings in the Zendesk SDK are localized into 33 languages.

The strings contained in the SDK are only related to UI components. Any string that's part of the conversation screen is provided and/or translated by the Flow Builder, by an agent in the ticket, or by an integration.

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

Below is the full list of strings used in the Zendesk SDK UI. You can override any of these in your app's strings.xml to customize the UI text. If a string contains a placeholder (for example, %1$s or %1$d), ensure your override includes it.

Example: Overriding SDK strings in your app

Add the following to your app's res/values/strings.xml:

<string name="zma_contextual_menu_copy">Copy</string>
<string name="zma_contextual_menu_delete">Delete</string>
<string name="zma_conversation_list_item_description_carousel">Sent a carousel</string>
<string name="zma_conversation_list_item_description_file">Sent a file</string>
<string name="zma_conversation_list_item_description_form">Sent a form</string>
<string name="zma_conversation_list_item_description_image">Sent an image</string>
<string name="zma_conversation_list_item_description_no_messages">No messages</string>
<string name="zma_conversation_list_item_description_sender_you">You: %1$s</string>
<string name="zma_conversation_list_item_timestamp_just_now">Just now</string>
<string name="zma_conversation_message_label_cant_be_displayed">Message can't be displayed</string>
<string name="zma_conversation_new_messages_divider">New</string>
<string name="zma_form_submission_error">Details couldn’t be sent. Try again.</string>
<string name="zma_image_view_loading_error">Unable to load image</string>
<string name="zma_multiconvo_setting_conversation_titles_and_avatars_current_year">Started %1$s at %2$s</string>
<string name="zma_multiconvo_setting_conversation_titles_and_avatars_previous_years">Started %1$s at %2$s</string>
<string name="zma_new_conversation_button">New conversation</string>
<string name="zma_new_conversation_error_alert">Couldn\'t create conversation. Try again later.</string>
<string name="zma_new_conversation_error_alert_dismiss_button">Ok</string>
<string name="zma_new_conversation_error_alert_message">Try again later.</string>
<string name="zma_new_conversation_error_alert_title">Couldn\'t create conversation</string>
<string name="zma_notification_channel_name">Messages</string>
<string name="zma_notification_default_author_name">User</string>
<string name="zma_notification_default_text">Sent a message</string>
<string name="zma_permission_rationale">Message can\'t be displayed</string>
<string name="zuia_accessibility_message_received">Message received from %1$s</string>
<string name="zuia_accessibility_unread_messages.few">%1$d unread messages</string>
<string name="zuia_accessibility_unread_messages.many">%1$d unread messages</string>
<string name="zuia_accessibility_unread_messages.one">1 unread message</string>
<string name="zuia_accessibility_unread_messages.other">%1$d unread messages</string>
<string name="zuia_accessibility_unread_messages.two">2 unread messages</string>
<string name="zuia_accessibility_unread_messages.zero">0 unread messages</string>
<string name="zuia_attachment_permissions_rationale">To send attachments you need to allow permissions in your settings</string>
<string name="zuia_carousel_action_not_supported">Option not supported</string>
<string name="zuia_conversation_header_logo">Brand logo</string>
<string name="zuia_conversation_message_label_download_failed">Download failed. Tap to retry.</string>
<string name="zuia_conversation_message_label_downloading">Downloading…</string>
<string name="zuia_conversation_message_label_just_now">Just now</string>
<string name="zuia_conversation_message_label_new">New</string>
<string name="zuia_conversation_message_label_sending">Sending…</string>
<string name="zuia_conversation_message_label_sent_absolute">Sent • %1$s</string>
<string name="zuia_conversation_message_label_sent_relative">Sent • Just now</string>
<string name="zuia_conversation_message_label_tap_to_retry">Tap to retry</string>
<string name="zuia_conversation_message_label_unsupported_item">Item can't be displayed</string>
<string name="zuia_conversations_list_tap_to_retry_message_label">Conversations failed to load</string>
<string name="zuia_dialog_camera">Camera</string>
<string name="zuia_dialog_gallery">Gallery</string>
<string name="zuia_exceeds_max_file_size">Exceeds max file size (%1$d MB)</string>
<string name="zuia_hint_type_message">Type a message</string>
<string name="zuia_label_add_attachments">Add attachments</string>
<string name="zuia_label_send_message">Send message</string>
<string name="zuia_new_message_label">1 new message</string>
<string name="zuia_new_messages_label">%1$d new messages</string>
<string name="zuia_new_messages_nighty_night_plus_label">99+ new messages</string>
<string name="zuia_postback_error_banner_message">%1$s could not be completed. Try again later.</string>
<string name="zuia_see_latest_label">See latest</string>
<string name="zuia_settings">Settings</string>
<string name="zuia_attachment_permissions_rationale">To send attachments you need to allow permissions in your settings</string>
<string name="zuia_carousel_action_not_supported">Option not supported</string>
<string name="zuia_conversation_header_logo">Brand logo</string>
<string name="zuia_conversation_message_label_just_now">Just now</string>
<string name="zuia_conversation_message_label_new">New</string>
<string name="zuia_conversation_message_label_sending">Sending…</string>
<string name="zuia_conversation_message_label_sent_absolute">Sent • %1$s</string>
<string name="zuia_conversation_message_label_sent_relative">Sent • Just now</string>
<string name="zuia_conversation_message_label_tap_to_retry">Tap to retry</string>
<string name="zuia_conversation_message_label_unsupported_item">Item can't be displayed</string>
<string name="zuia_conversations_list_tap_to_retry_message_label">Conversations failed to load</string>
<string name="zuia_dialog_camera">Camera</string>
<string name="zuia_dialog_gallery">Gallery</string>
<string name="zuia_exceeds_max_file_size">Exceeds max file size (%1$d MB)</string>
<string name="zuia_hint_type_message">Type a message</string>
<string name="zuia_label_add_attachments">Add attachments</string>
<string name="zuia_label_send_message">Send message</string>
<string name="zuia_new_message_label">1 new message</string>
<string name="zuia_new_messages_label">%1$d new messages</string>
<string name="zuia_new_messages_nighty_night_plus_label">99+ new messages</string>
<string name="zuia_postback_error_banner_message">%1$s could not be completed. Try again later.</string>
<string name="zuia_see_latest_label">See latest</string>
<string name="zuia_settings">Settings</string>
<string name="zuia_accessibility_carousel_message_received_announcement.few">%1$s sent a carousel with %2$d articles</string>
<string name="zuia_accessibility_carousel_message_received_announcement.many">%1$s sent a carousel with %2$d articles</string>
<string name="zuia_accessibility_carousel_message_received_announcement.one">%1$s sent a carousel with 1 article</string>
<string name="zuia_accessibility_carousel_message_received_announcement.other">%1$s sent a carousel with %2$d articles</string>
<string name="zuia_accessibility_carousel_message_received_announcement.two">%1$s sent a carousel with 2 articles</string>
<string name="zuia_accessibility_carousel_message_received_announcement.zero">%1$s sent a carousel with 0 articles</string>
<string name="zuia_accessibility_file_message_received_announcement">%1$s sent a file</string>
<string name="zuia_accessibility_form_message_received_announcement">%1$s sent a form</string>
<string name="zuia_accessibility_image_and_text_message_received_announcement">%1$s replied %2$s and sent an image</string>
<string name="zuia_accessibility_image_message_received_announcement">%1$s sent an image</string>
<string name="zuia_accessibility_loading_label">Loading</string>
<string name="zuia_accessibility_message_dismiss">Dismiss</string>
<string name="zuia_accessibility_quick_replies_available_actions_announcement">Available actions:</string>
<string name="zuia_back_button_accessibility_label">Go back</string>
<string name="zuia_connection_banner_label_connected">Connected</string>
<string name="zuia_connection_banner_label_disconnected">Offline. You won\'t receive messages.</string>
<string name="zuia_connection_banner_label_reconnecting">Reconnecting…</string>
<string name="zuia_connection_banner_label_state_reconnected">You\'re now online</string>
<string name="zuia_connection_refresh_button_accessibility_label">Tap to refresh</string>
<string name="zuia_conversation_header_logo">Brand logo</string>
<string name="zuia_conversation_list_item_content_accessibility_label">%1$s Message from %2$s: %3$s, %4$s, %5$s</string>
<string name="zuia_conversation_list_item_message_author_name_as_end_user_accessibility_label">You</string>
<string name="zuia_conversation_list_item_one_unread_message_accessibility_label">1 unread message</string>
<string name="zuia_conversation_list_item_unread_indicator_maximum">99+</string>
<string name="zuia_conversation_list_item_unread_messages_accessibility_label">%1$d unread messages</string>
<string name="zuia_dialog_camera">Camera</string>
<string name="zuia_dialog_gallery">Gallery</string>
<string name="zuia_dialog_take_a_photo">Take a photo</string>
<string name="zuia_dialog_upload_a_file">Upload a file</string>
<string name="zuia_form_dropdown_menu_accessibility_label">Show dropdown menu for %1$s</string>
<string name="zuia_form_field_counter_label">%1$d of %2$d</string>
<string name="zuia_form_field_invalid_email_error">Enter a valid email address</string>
<string name="zuia_form_field_max_character_error">Enter %1$d characters or less</string>
<string name="zuia_form_field_min_character_error">Enter %1$d characters or more</string>
<string name="zuia_form_field_required_accessibility_label">%1$s (Required)</string>
<string name="zuia_form_field_required_label">This field is required</string>
<string name="zuia_form_next_button">Next</string>
<string name="zuia_form_send_button">Send</string>
<string name="zuia_form_submission_error">Details couldn\'t be sent. Try again.</string>
<string name="zuia_generated_by_ai">Generated by AI</string>
<string name="zuia_guide_article_view_article_failed_to_load_label">Page failed to load</string>
<string name="zuia_guide_article_view_attachment_carousel_accessibility_action">open</string>
<string name="zuia_guide_article_view_attachment_carousel_accessibility_label">Attachment item</string>
<string name="zuia_guide_article_view_attachment_carousel_accessibility_value">%1$s, type: %2$s, size: %3$s</string>
<string name="zuia_guide_article_view_back_button_content_description">Back</string>
<string name="zuia_guide_article_view_close_button_content_description">Close</string>
<string name="zuia_guide_article_view_share_button_content_description">Share</string>
<string name="zuia_guide_article_view_tap_to_retry_label">Tap to retry</string>
<string name="zuia_guide_feedback_banner_option_no">No</string>
<string name="zuia_guide_feedback_banner_option_yes">Yes</string>
<string name="zuia_guide_feedback_banner_question">Was this article helpful?</string>
<string name="zuia_hint_type_message">Type a message</string>
<string name="zuia_image_thumbnail_accessibility_action_label">Open image in full screen</string>
<string name="zuia_image_thumbnail_accessibility_label">Image thumbnail</string>
<string name="zuia_label_add_attachments">Add attachments</string>
<string name="zuia_label_send_message">Send message</string>
<string name="zuia_load_more_messages_failed_to_load">Messages failed to load</string>
<string name="zuia_load_more_view_retry_button_accessibility_label">Tap to retry</string>
<string name="zuia_multiconvo_conversation_list_screen_item_default_title_accessibility_label">Conversation started %1$s at %2$s, Message from %3$s, %4$s, %5$s</string>
<string name="zuia_multiconvo_conversation_screen_header_default_title_accessibility_label">Conversation started %1$s at %2$s</string>
<string name="zuia_new_content_change_accessibility_label">%1$s replied</string>
<string name="zuia_new_messages_banner_close_button_accessibility_label">Tap to dismiss</string>
<string name="zuia_new_messages_banner_new_messages_accessibility_label">%1$s. Tap to scroll to the earliest unread message.</string>
<string name="zuia_no_matches_found_label">No matches found</string>
<string name="zuia_option_not_supported">Option not supported</string>
<string name="zuia_postback_error_banner_accessibility_label">Error, %1$s</string>
<string name="zuia_quick_reply_button_accessibility_label">Quick reply button</string>
<string name="zuia_send_button_accessibility_label">Send message</string>
<string name="zuia_static_wait_time_banner_join_about_days">An agent will join you in about %1$d days</string>
<string name="zuia_static_wait_time_banner_join_about_hours">An agent will join you in about %1$d hours</string>
<string name="zuia_static_wait_time_banner_join_about_minute">An agent will join you in about %1$d minute</string>
<string name="zuia_static_wait_time_banner_join_about_minutes">An agent will join you in about %1$d minutes</string>
<string name="zuia_static_wait_time_banner_join_days">An agent will join you in %1$d-%2$d days</string>
<string name="zuia_static_wait_time_banner_join_hours">An agent will join you in %1$d-%2$d hours</string>
<string name="zuia_static_wait_time_banner_join_minutes">An agent will join you in %1$d-%2$d minutes</string>
<string name="zuia_static_wait_time_banner_join_within_days">An agent will join you within %1$d days</string>
<string name="zuia_static_wait_time_banner_join_within_hours">An agent will join you within %1$d hours</string>
<string name="zuia_static_wait_time_banner_join_within_minute">An agent will join you within %1$d minute</string>
<string name="zuia_static_wait_time_banner_join_within_minutes">An agent will join you within %1$d minutes</string>
<string name="zuia_static_wait_time_banner_queue_position.few">%1$d people are waiting ahead of you</string>
<string name="zuia_static_wait_time_banner_queue_position.many">%1$d people are waiting ahead of you</string>
<string name="zuia_static_wait_time_banner_queue_position.one">1 person is waiting ahead of you</string>
<string name="zuia_static_wait_time_banner_queue_position.other">%1$d people are waiting ahead of you</string>
<string name="zuia_static_wait_time_banner_queue_position.two">2 people are waiting ahead of you</string>
<string name="zuia_static_wait_time_banner_queue_position.zero">0 people are waiting ahead of you</string>
<string name="zuia_static_wait_time_banner_will_be_shortly">An agent will be with you shortly</string>
 <string name="zuia_static_wait_time_banner_you_are_up_next">You\'re up next</string>

How to override a string

To override a string, simply add it to your app's strings.xml with the same name. For example, to change the label for the new conversation button:

<string name="zma_new_conversation_button">Start a support chat</string>

This will replace the default text in the SDK UI with your custom value.

Tip:

• Always keep placeholders (for example, %1$s, %1$d) in your overrides to avoid runtime errors.
• You can localize your overrides for different languages by adding them to the appropriate values-xx folders (for example, values-fr for French).

How to find all localizable strings in the SDK

Instead of relying on this documentation to list every string, you can always find the latest set of localizable strings directly in the Zendesk SDK Android library:

Locate the SDK's values.xml file

In the SDK's Android library (AAR or source), there is a res/values/values.xml file containing all the string resources used by the SDK UI.

Extract string names

Open the SDK's strings.xml and review all <string name="...">...</string> entries. These are the keys you can override in your own app's strings.xml.

Note: The Messaging SDK depends on other UI modules as transitive dependencies. Some strings may be defined in those modules and won't be found directly in the Messaging SDK's strings.xml.

Override as needed

Copy any string name you want to customize into your app's res/values/strings.xml and provide your own value.

Tip:

• If you are using a prebuilt SDK (AAR), you can unzip it and inspect the res/values/strings.xml file.
• For Maven/Central dependencies, you can browse the SDK source or use Android Studio's Resource Manager to see all available string resources.

This approach ensures you always have the latest list of localizable strings, even as the SDK evolves.

For the full list of supported languages, see Zendesk SDK supported languages.

FAQ

Q: How do I find all localizable strings in the Zendesk SDK?
A: Most localizable strings can be found in the SDK's res/values/strings.xml file. Because the Messaging SDK depends on other UI modules as transitive dependencies, some strings may be defined in those modules and won't be found directly in the Messaging SDK's strings.xml.

Q: What happens if I override a string in my app's strings.xml?
A: The SDK will use your custom value instead of the default. Make sure to keep any placeholders (for example, %1$s, %1$d) in your override.

Q: Can I localize SDK strings for different languages?
A: Yes. Add your overrides to the appropriate values-xx folders (for example, values-fr for French) to support multiple languages.

Q: Are bot strings localizable in the SDK?
A: No. Bot strings (such as automated replies or bot messages) are provided and/or translated by Flow Builder, AI agents, or integrations—not by the SDK UI string resources.