Customize Strings for Android

The UI SDK provides default text for all the messages that a user can encounter. You can customize the strings in your app using resource files.

This article applies to the following implementations:

UI SDKCore SDK

To customize these strings in your app, create a strings.xml resource file in your app using the exact same resource names. To learn about which languages the SDK supports, see Language Support.

KeywordDefault ValueDescription
Chat Feed
smi_chat_feed_titleChatTitle for the chat feed view.
smi_chat_feed_accessibilityChat FeedAccessibility label for the chat feed container view.
smi_chat_add_buttonOpen option menu.Content description for the add button in the chat view to open the options menu.
Chat Feed Input
smi_feed_input_textType a messagePlaceholder text inside chat input field.
smi_feed_input_text_accessibilitymessage InputAccessibility label for identifying the input control.
smi_feed_input_buttonSendAction text for the send message button.
smi_feed_new_messagesNew messagesA notification that alerts the user that there are new unread messages in the chat feed.
smi_feed_new_messages_accessibilityYou have new messages.An accessibility announcement that alerts the user that there are new unread messages in the chat feed.
smi_feed_new_messages_button_accessibilityScroll to bottom of chat feed.The description for the notification badge button that alerts a user that they’ll be brought to the bottom of the feed.
Action Menu
smi_feed_action_menu_photo_sendSend a PhotoAction Menu text for sending a photo.
smi_feed_action_menu_photo_takeTake a PhotoAction Menu text for taking a photo.
smi_feed_action_menu_accessibilityAction MenuThe accessibility string for the Action Menu to the left of the text input.
Delivery Status
smi_delivery_status_deliveredDeliveredThe message auxiliary view that displays the delivered message indicator.
smi_delivery_status_readReadThe message auxiliary view that displays the read message indicator.
smi_delivery_status_sendingSendingThe message auxiliary view that displays the sending message indicator.
smi_delivery_status_sentSentThe message auxiliary view that displays the sent message indicator.
smi_delivery_timestamp_yesterdayYesterday • %sThe message auxiliary view that displays the time information for the day yesterday with the timestamp.
smi_delivery_timestamp_todayToday • %sThe message auxiliary view that displays the time information for the day today with the timestamp.
smi_delivery_status_errorSend failed. Tap to retry.The message auxiliary view that displays a send failure.
smi_delivery_status_error_accessibilityFailedThe concise failed status for accessibility.
smi_delivery_status_error_hint_accessibilityDouble tap to retryHint for the user to double tap the message to retry.
smi_delivery_status_error_unsupported_media_typeChatbots can't receive attachments.The error message appears when trying to send attachments that aren’t supported.
smi_local_message_identifier_accessibilityYour messageThe accessibility text for identifying messages sent from the local user.
smi_message_received_event_accessibilityMessage received from %sThe accessibility announcement text that informs the user when a message has been received.
smi_message_sending_event_accessibilityMessage sentThe accessibility announcement text that informs the user that their message is sending.
Network Connectivity
smi_network_status_reconnectingWaiting to reconnectThe network connectivity banner text that informs the user the network connection has been lost and is attempting to reconnect.
smi_network_status_reconnecting_accessibilityNetwork connectivity is lost, attempting to reconnectThe accessibility announcement that informs the user when the network connection has been lost and is attempting to reconnect
smi_network_status_connectedConnectedThe network connectivity banner that will inform the user the network has connected after the network has lost connectivity.
smi_network_status_connected_accessibilityNetwork connectivity establishedThe accessibility announcement that informs the user when the network is connected after having lost connectivity.
Typing
smi_typing_indicator_start_accessibility%@ has started typingThe accessibility announcement that informs the user when a participant starts typing.
smi_typing_indicator_stop_accessibility%@ has stopped typingThe accessibility announcement that informs the user when a participant stops typing.
smi_typing_indicator_accessibility%@ is typingThe accessibility label for the agent typing indicator.
Miscellaneous
smi_misc_separatorSeparator used when conjoining information together in a string.
smi_action_cancelCancelCancel action to be used for cancel button and menus throughout the SDK.
smi_action_settingsSettingsSettings action for permission alerts.
smi_file_size_megabyteMBSize of a file in megabytes.
Alerts
smi_alert_title_failedMessage FailedAlert title text for the retry message alert.
smi_alert_message_failedMessage failed to send. Retry?Confirmation text for the retry message alert.
smi_alert_action_retryRetryRetry action for the retry message alert.
smi_alert_title_permission_cameraAllow Camera AccessAlert title text for requesting camera access.
smi_alert_message_permission_cameraTo use your camera, go to Settings and enable Camera access for this appExplanation for how to allow camera permission.
smi_alert_attachment_limit_reachedAttachment limit reachedConfirmation text for the retry message alert.
Participants
smi_participant_name_defaultParticipantDefault string for a participant with no display name or subject configured.
smi_participant_changed_joined%s has joinedThe accessibility announcement that informs the user that a participant has joined the conversation.
smi_participant_changed_joined_accessibility%s has joined the conversationNotice that a participant has joined the conversation.
smi_participant_changed_left%s has leftNotice that a participant has joined the conversation.
smi_participant_changed_left_accessibility%s has left the conversationThe accessibility announcement that informs the user that a participant has left the conversation.
Pre-Chat
smi_pre_chat_required_accessibility%s is requiredThe accessibility string for the pre-chat field if the field is required.
smi_pre_chat_required%s *The string for a pre-chat field label if the field is required.
smi_pre_chat_submit_buttonChat with an AgentThe title of the pre-chat submit button.
smi_pre_chat_titleJust a few things before we connect you with an expert…The title of the pre-chat form.
smi_pre_chat_error_field_requiredThis field is required.Error message shown when a required field fails pre-chat validation.
smi_pre_chat_error_valid_email_formatUse a valid email format.Error message shown when an email field fails pre-chat validation.
smi_pre_chat_error_valid_number_formatField can only contain numbers.Error message shown when a number field fails pre-chat validation.
smi_pre_chat_back_buttonBackThe back button for the pre-chat form.
smi_back_button_accessibilityBack to chat feedAccessibility text for hitting the back button on pre-chat submission screen.
smi_pre_chat_submission_review_titleSubmitted Form DetailsHeader for pre-chat submitted form details.
smi_pre_chat_submission_card_titleForm submitted Tap to reviewText for pre-chat cell that shows in chat after submitting form.
smi_exit_button_accessibilityExit to chat feedAccessibility text for hitting the exit button on pre-chat submission screen.
smi_checkbox_selected_accessibilityCheckbox selectedAccessibility text for when the checkbox is selected.
smi_checkbox_not_selected_accessibilityCheckbox not selectedAccessibility text for when the checkbox isn’t selected.
Attachment Messages
smi_image_accessibilityImage message.Accessibility text for an image message in the chat feed or attachment preview.
smi_remove_image_button_accessibilityRemove image message.Accessibility text for the button to remove an image message from the input field.
smi_image_preview_accessibilityImage preview.Accessibility text for the image preview dialog.
smi_image_preview_cancel_button_accessibilityClose image preview.Accessibility text for the button to close the image preview dialog.
smi_camera_gallery_button_accessibilityPhoto gallery.Accessibility text for the button to open the photo gallery.
smi_camera_switch_lens_button_accessibilitySwitch lens direction.Accessibility text for the button to switch the camera lens direction.
smi_camera_capture_button_accessibilityCapture photo.Accessibility text for the button to capture a photo.
smi_camera_view_capturing_accessibilityCamera capturing photoAccessibility text for the view that displays the phone camera capturing a photo.
smi_image_viewer_jump_to_photo_accessibilityJump to photoAccessibility text for the jump to photo button in the image viewer.
smi_image_viewer_share_photo_accessibilityShare photoAccessibility text for the share button in the image viewer.
smi_image_viewer_download_photo_accessibilityDownload photoAccessibility text for the download button in the image viewer.
smi_header_share_image_viewerImageShown when the user taps the share button when viewing an image in the attachment viewer.
smi_header_share_pdf_viewerPDFShown when the user taps the share button when viewing a PDF in the attachment viewer.
smi_image_saved_messageImage savedShown in popup when the user clicks the download button and the attachment successfully saves.
smi_attachment_download_failed_messageFailed to save attachmentShown in popup when the user clicks the download button and the attachment fails to save.
smi_image_download_denied_titleAllow Photo AccessTitle shown in popup when the user tries to save a photo with denied permission.
smi_image_download_denied_bodyTo save photos, go to Settings and enable Photos access for this app.Message shown in popup when the user tries to save a photo with denied permission.
smi_multiple_attachment_counter+%dA counter that takes an integer representing the number of file attachments not shown.
smi_file_format_unsupportedUnsupported file format.Message shown if the user sends an unsupported file.
smi_file_size_exceededAttachment is too large. Maximum size is %sMessage shown if the user sends an attachment that exceeds the maximum size that can be sent. chat.
Agent Transfer
smi_transfer_requested_event_textTransfer requested at %sA system message informing the user that an agent transfer has been requested.
Routing
smi_routing_initial_agentAn agent will be with you shortly.Shown when an estimated wait time is available and the routing type is in the initial state.
smi_routing_wait_resolved_minutesYour expected wait time is %s minutes.Shown when the estimated wait time is greater than 60 seconds. Rounded up to the nearest minute.
smi_routing_wait_resolved_shortYour expected wait time is less than one minute.Shown when the estimated wait time is less than or equal to 60 seconds.
smi_routing_failure_event_textAgents are not available. Try again later.A default system message informing the user that routing to an agent has failed.
Message Search
smi_nothing_entered_in_searchNothing here yetMessage displayed when there’s nothing in the search bar and there are no recent searches.
smi_no_search_resultsNo search resultsMessage displayed when there are no search results.
smi_no_matching_resultsWe couldn’t find what you’re looking for. Try searching for something else.Message displayed when nothing matches the users search.
smi_message_search_headerMessage SearchHeader for the message search page.
smi_recent_searches_headerRecent SearchesHeader for the recent search list.
smi_search_placeholder_textSearchPlaceholder text for the search bar.
smi_today_timestamp_message_searchTodayTimestamp text for when the message was sent today.
smi_yesterday_timestamp_message_searchYesterdayTimestamp text for when the message was sent yesterday.
smi_users_nameYouThe name shown for the user in the time stamp row.
smi_no_recent_searchesYou haven't performed a recent search. Enter keywords in the search field.Message displayed when there are no search results and no text is entered in the search field.
smi_message_search_back_buttonBackThe back button for message search.
smi_message_search_clear_search_text_accessibilityClear search textAccessibility text for clearing the search field in message search.
smi_message_search_agent_avatar_accessibilityAgent avatarAccessibility text for the agent avatar in message search search.
smi_message_search_user_avatar_accessibilityUser avatarAccessibility text for the user avatar in message search search.
smi_message_search_agent_bot_accessibilityBot avatarAccessibility text for the bot avatar in message search search.
Loading Screen
smi_loading_screen_accessibilityActive loading screenA message that is read to the user when a loading screen is shown or when the loading screen is selected.
Link Preview
smi_link_preview_accessibilityLink previewThe screen reader reads out link preview and then the name of the link.
Copy Menu
smi_action_copyCopyText displayed in the context menu for the copy behavior.
smi_action_copy_attachmentCopy AttachmentText displayed in the context menu for copying an attachment (when selecting part of a conversation entry that includes text and an attachment).
smi_copy_textCopy TextText displayed in the context menu for copying text (when selecting part of a conversation entry that includes text and an attachment).