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 SDK | Core 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.
| Keyword | Default Value | Description |
|---|---|---|
| Chat Feed | ||
| smi_chat_feed_title | Chat | Title for the chat feed view. |
| smi_chat_feed_accessibility | Chat Feed | Accessibility label for the chat feed container view. |
| smi_chat_add_button | Open option menu. | Content description for the add button in the chat view to open the options menu. |
| smi_chat_start_conversation | Start Conversation | Content description for a button that is used to resubmit pre-chat fields mid-conversation. |
| smi_chat_start_conversation_feed_input_text_accessibility | Fill out a pre-chat form to continue the conversation | Accessibility announcement when the user needs to enter and resubmit pre-chat fields. |
| Chat Feed Input | ||
| smi_feed_input_text | Type a message | Placeholder text inside chat input field. |
| smi_feed_input_text_accessibility | message Input | Accessibility label for identifying the input control. |
| smi_feed_input_button | Send | Action text for the send message button. |
| smi_feed_new_messages | New messages | A notification that alerts the user that there are new unread messages in the chat feed. |
| smi_feed_new_messages_accessibility | You 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_accessibility | Scroll 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_send | Send a Photo | Action Menu text for sending a photo. |
| smi_feed_action_menu_photo_take | Take a Photo | Action Menu text for taking a photo. |
| smi_feed_action_menu_accessibility | Action Menu | The accessibility string for the Action Menu to the left of the text input. |
| Delivery Status | ||
| smi_delivery_status_delivered | Delivered | The message auxiliary view that displays the delivered message indicator. |
| smi_delivery_status_read | Read | The message auxiliary view that displays the read message indicator. |
| smi_delivery_status_sending | Sending | The message auxiliary view that displays the sending message indicator. |
| smi_delivery_status_sent | Sent | The message auxiliary view that displays the sent message indicator. |
| smi_delivery_timestamp_yesterday | Yesterday • %s | The message auxiliary view that displays the time information for the day yesterday with the timestamp. |
| smi_delivery_timestamp_today | Today • %s | The message auxiliary view that displays the time information for the day today with the timestamp. |
| smi_delivery_status_error | Send failed. Tap to retry. | The message auxiliary view that displays a send failure. |
| smi_delivery_status_error_accessibility | Failed | The concise failed status for accessibility. |
| smi_delivery_status_error_hint_accessibility | Double tap to retry | Hint for the user to double tap the message to retry. |
| smi_delivery_status_error_unsupported_media_type | Chatbots can't receive attachments. | The error message appears when trying to send attachments that aren’t supported. |
| smi_delivery_status_error_additional_information_required | Provide additional info to proceed. | The error message that appears when receiving a 417 error. This message corresponds to needing to resubmit pre-chat fields. |
| smi_local_message_identifier_accessibility | Your message | The accessibility text for identifying messages sent from the local user. |
| smi_message_received_event_accessibility | Message received from %s | The accessibility announcement text that informs the user when a message has been received. |
| smi_message_sending_event_accessibility | Message sent | The accessibility announcement text that informs the user that their message is sending. |
| Network Connectivity | ||
| smi_network_status_reconnecting | Waiting to reconnect | The network connectivity banner text that informs the user the network connection has been lost and is attempting to reconnect. |
| smi_network_status_reconnecting_accessibility | Network connectivity is lost, attempting to reconnect | The accessibility announcement that informs the user when the network connection has been lost and is attempting to reconnect |
| smi_network_status_connected | Connected | The network connectivity banner that will inform the user the network has connected after the network has lost connectivity. |
| smi_network_status_connected_accessibility | Network connectivity established | The accessibility announcement that informs the user when the network is connected after having lost connectivity. |
| Typing | ||
| smi_typing_indicator_start_accessibility | %@ has started typing | The accessibility announcement that informs the user when a participant starts typing. |
| smi_typing_indicator_stop_accessibility | %@ has stopped typing | The accessibility announcement that informs the user when a participant stops typing. |
| smi_typing_indicator_accessibility | %@ is typing | The accessibility label for the agent typing indicator. |
| Miscellaneous | ||
| smi_misc_separator | • | Separator used when conjoining information together in a string. |
| smi_misc_unknown | Unknown | This string is used when a value or result cannot be determined. |
| smi_action_cancel | Cancel | Cancel action to be used for cancel button and menus throughout the SDK. |
| smi_action_settings | Settings | Settings action for permission alerts. |
| smi_file_size_megabyte | MB | Size of a file in megabytes. |
| Alerts | ||
| smi_alert_title_failed | Message Failed | Alert title text for the retry message alert. |
| smi_alert_message_failed | Message failed to send. Retry? | Confirmation text for the retry message alert. |
| smi_alert_action_retry | Retry | Retry action for the retry message alert. |
| smi_alert_title_permission_camera | Allow Camera Access | Alert title text for requesting camera access. |
| smi_alert_message_permission_camera | To use your camera, go to Settings and enable Camera access for this app | Explanation for how to allow camera permission. |
| smi_alert_attachment_limit_reached | Attachment limit reached | Confirmation text for the retry message alert. |
| Participants | ||
| smi_participant_name_default | Participant | Default string for a participant with no display name or subject configured. |
| smi_participant_changed_joined | %s has joined | The accessibility announcement that informs the user that a participant has joined the conversation. |
| smi_participant_changed_joined_accessibility | %s has joined the conversation | Notice that a participant has joined the conversation. |
| smi_participant_changed_left | %s has left | Notice that a participant has joined the conversation. |
| smi_participant_changed_left_accessibility | %s has left the conversation | The accessibility announcement that informs the user that a participant has left the conversation. |
| Pre-Chat | ||
| smi_pre_chat_required_accessibility | %s is required | The 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_button | Chat with an Agent | The title of the pre-chat submit button. |
| smi_pre_chat_title | Just a few things before we connect you with an expert… | The title of the pre-chat form. |
| smi_pre_chat_choice_list_none | None | Label for the None option in a pre-chat choice list. |
| smi_pre_chat_error_field_required | This field is required. | Error message shown when a required field fails pre-chat validation. |
| smi_pre_chat_error_valid_email_format | Use a valid email format. | Error message shown when an email field fails pre-chat validation. |
| smi_pre_chat_error_valid_number_format | Field can only contain numbers. | Error message shown when a number field fails pre-chat validation. |
| smi_pre_chat_back_button | Back | The back button for the pre-chat form. |
| smi_back_button_accessibility | Back to chat feed | Accessibility text for hitting the back button on pre-chat submission screen. |
| smi_pre_chat_submission_review_title | Submitted Form Details | Header for pre-chat submitted form details. |
| smi_pre_chat_submission_card_title | Form submitted Tap to review | Text for pre-chat cell that shows in chat after submitting form. |
| smi_exit_button_accessibility | Exit to chat feed | Accessibility text for hitting the exit button on pre-chat submission screen. |
| smi_checkbox_selected_accessibility | Checkbox selected | Accessibility text for when the checkbox is selected. |
| smi_checkbox_not_selected_accessibility | Checkbox not selected | Accessibility text for when the checkbox isn’t selected. |
| Attachment Messages | ||
| smi_image_accessibility | Image message. | Accessibility text for an image message in the chat feed or attachment preview. |
| smi_remove_image_button_accessibility | Remove image message. | Accessibility text for the button to remove an image message from the input field. |
| smi_image_preview_accessibility | Image preview. | Accessibility text for the image preview dialog. |
| smi_image_preview_cancel_button_accessibility | Close image preview. | Accessibility text for the button to close the image preview dialog. |
| smi_camera_gallery_button_accessibility | Photo gallery. | Accessibility text for the button to open the photo gallery. |
| smi_camera_switch_lens_button_accessibility | Switch lens direction. | Accessibility text for the button to switch the camera lens direction. |
| smi_camera_capture_button_accessibility | Capture photo. | Accessibility text for the button to capture a photo. |
| smi_camera_view_capturing_accessibility | Camera capturing photo | Accessibility text for the view that displays the phone camera capturing a photo. |
| smi_image_viewer_jump_to_photo_accessibility | Jump to photo | Accessibility text for the jump to photo button in the image viewer. |
| smi_image_viewer_share_photo_accessibility | Share photo | Accessibility text for the share button in the image viewer. |
| smi_image_viewer_download_photo_accessibility | Download photo | Accessibility text for the download button in the image viewer. |
| smi_header_share_image_viewer | Image | Shown when the user taps the share button when viewing an image in the attachment viewer. |
| smi_header_share_pdf_viewer | Shown when the user taps the share button when viewing a PDF in the attachment viewer. | |
| smi_header_share_gif_viewer | GIF | Shown when the user taps the share button when viewing a GIF in the attachment viewer. |
| smi_image_saved_message | Image saved | Shown in popup when the user clicks the download button and the attachment successfully saves. |
| smi_attachment_download_failed_message | Failed to save attachment | Shown in popup when the user clicks the download button and the attachment fails to save. |
| smi_image_download_denied_title | Allow Photo Access | Title shown in popup when the user tries to save a photo with denied permission. |
| smi_image_download_denied_body | To 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 | +%d | A counter that takes an integer representing the number of file attachments not shown. |
| smi_file_format_unsupported | Unsupported file format. | Message shown if the user sends an unsupported file. |
| smi_file_size_exceeded | Attachment is too large. Maximum size is %s | Message shown if the user sends an attachment that exceeds the maximum size that can be sent. chat. |
| Agent Transfer | ||
| smi_transfer_requested_event_text | Transfer requested at %s | A system message informing the user that an agent transfer has been requested. |
| Routing | ||
| smi_routing_initial_agent | An 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_minutes | Your 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_short | Your 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_text | Agents 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_search | Nothing here yet | Message displayed when there’s nothing in the search bar and there are no recent searches. |
| smi_no_search_results | No search results | Message displayed when there are no search results. |
| smi_no_matching_results | We couldn’t find what you’re looking for. Try searching for something else. | Message displayed when nothing matches the users search. |
| smi_message_search_header | Message Search | Header for the message search page. |
| smi_recent_searches_header | Recent Searches | Header for the recent search list. |
| smi_search_placeholder_text | Search | Placeholder text for the search bar. |
| smi_today_timestamp_message_search | Today | Timestamp text for when the message was sent today. |
| smi_yesterday_timestamp_message_search | Yesterday | Timestamp text for when the message was sent yesterday. |
| smi_users_name | You | The name shown for the user in the time stamp row. |
| smi_no_recent_searches | You 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_button | Back | The back button for message search. |
| smi_message_search_clear_search_text_accessibility | Clear search text | Accessibility text for clearing the search field in message search. |
| smi_message_search_agent_avatar_accessibility | Agent avatar | Accessibility text for the agent avatar in message search search. |
| smi_message_search_user_avatar_accessibility | User avatar | Accessibility text for the user avatar in message search search. |
| smi_message_search_agent_bot_accessibility | Bot avatar | Accessibility text for the bot avatar in message search search. |
| Loading Screen | ||
| smi_loading_screen_accessibility | Active loading screen | A 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_accessibility | Link preview | The screen reader reads out link preview and then the name of the link. |
| Copy Menu | ||
| smi_action_copy | Copy | Text displayed in the context menu for the copy behavior. |
| smi_action_copy_attachment | Copy Attachment | Text displayed in the context menu for copying an attachment (when selecting part of a conversation entry that includes text and an attachment). |
| smi_copy_text | Copy Text | Text displayed in the context menu for copying text (when selecting part of a conversation entry that includes text and an attachment). |
| Business Hours | ||
| smi_business_hours_outside | New chats aren't available outside of business hours | The message that is shown in the chat feed banner when outside of business hours. |
| smi_business_hours_outside_accessibility | New chats aren't currently available. Try again during business hours. | The accessibility announcement that informs the user that they are out of the set business hours and the contact center is closed. |
| Participant Client Menu | ||
| smi_participant_client_menu_title | Conversation Options | Text displayed in the header of the participant client menu. The participant client menu will contain actions a user can take in a chat feed. |
| participant_client_menu_title_accessibility | Conversation Options Menus | The accessibility message for the participant client menu. |