--- schema_version: "1" id: 0fc4a9ee8e2f15d8b4262f65bc38a2174bbfd23bc426068ab86d8ae72cb7038f title: Customize Strings for Android collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/messaging-in-app/guides/android-strings.md canonical_url: https://developer.salesforce.com/docs/service/messaging-in-app/guide/android-strings.html source_site: developer.salesforce.com content_type: documentation content_hash: 8ecef6d0714b859c36390d6e91e851900c8da35b39aba17eee1b2319d9126c14 products: - Enhanced In-App Chat - Service Cloud Developer Content --- # 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](https://developer.salesforce.com/docs/service/messaging-in-app/guide/before-you-begin.md). ## Action Menu | **Keyword** | **Default Value** | **Description** | | ---------------------------------- | ----------------- | --------------------------------------------------------------------------- | | smi_feed_action_menu_accessibility | Action Menu | The accessibility string for the Action Menu to the left of the text input. | | 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_file_send | Send a File | Action Menu text for sending a file. | ## Rep Transfer | **Keyword** | **Default Value** | **Description** | | --------------------------------- | ------------------------ | --------------------------------------------------------------------------- | | smi_transfer_requested_event_text | Transfer requested at %s | A system message informing the user that a rep transfer has been requested. | ## Alerts | **Keyword** | **Default Value** | **Description** | | ----------------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------- | | smi_alert_action_retry | Retry | Retry action for the retry message alert. | | smi_alert_attachment_limit_reached | Attachment limit reached | Confirmation text for the retry message alert. | | smi_alert_message_failed | Message failed to send. Retry? | Confirmation text for the retry message alert. | | 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_title_failed | Message Failed | Alert title text for the retry message alert. | | smi_alert_title_permission_camera | Allow Camera Access | Alert title text for requesting camera access. | ## Attachments | **Keyword** | **Default Value** | **Description** | | --------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | 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_camera_capture_button_accessibility | Capture photo. | Accessibility text for the button to capture a photo. | | 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_view_capturing_accessibility | Camera capturing photo | Accessibility text for the view that displays the phone camera capturing a photo. | | 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. | | smi_image_accessibility | Image message. | Accessibility text for an image message in the chat feed or attachment preview. | | 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_image_download_denied_title | Allow Photo Access | Title shown in popup when the user tries to save a photo with denied permission. | | 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_image_saved_message | Image saved | Shown in popup when the user clicks the download button and the attachment successfully saves. | | smi_image_viewer_download_photo_accessibility | Download photo | Accessibility text for the download button in the image viewer. | | 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_multiple_attachment_counter | +%d | A counter that takes an integer representing the number of file attachments not shown. | | smi_remove_image_button_accessibility | Remove image message. | Accessibility text for the button to remove an image message from the input field. | ## Business Hours Banner | **Keyword** | **Default Value** | **Description** | | ---------------------------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | 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. | ## Carousels | **Keyword** | **Default Value** | **Description** | | -------------------------------------------- | -------------------- | ------------------------------------------------------------------------------- | | smi_carousel_image_accessibility | Carousel image | The default image description for a carousel option if no description is given. | | smi_carousel_image_placeholder_accessibility | Empty carousel image | A placeholder icon to indicate there is no image for a carousel option. | | smi_carousel_selected_icon_accessibility | Option selected | An icon to indicate that an option has been selected for a carousel message. | ## Chat Feed | **Keyword** | **Default Value** | **Description** | | --------------------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------- | | 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_feed_title | Chat | Title for the chat feed view. | | 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 | **Keyword** | **Default Value** | **Description** | | ------------------------------------------ | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | smi_feed_input_button | Send | Action text for the send message button. | | 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_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. | | smi_unknown_entry_message | Agent sent an unsupported message type. | The message shown when displaying an unknown entry in the chat feed. | ## Copy Menu | **Keyword** | **Default Value** | **Description** | | --------------- | ----------------- | --------------------------------------------------------- | | smi_action_copy | Copy | Text displayed in the context menu for the copy behavior. | ## Delivery Status | **Keyword** | **Default Value** | **Description** | | --------------------------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | | smi_delivery_status_delivered | Delivered | The message auxiliary view that displays the delivered message indicator. | | 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_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_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_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_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. | ## End Chat Session | **Keyword** | **Default Value** | **Description** | | --------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | | smi_end_chat_menu_button | End Chat | The title of the end chat button in the participant client menu. | | smi_end_chat_title | End Chat? | The title label on the end chat confirmation page. | | smi_end_chat_subtitle | Are you sure you want to end the chat session? You will be disconnected from the agent. | The subtitle label on the end chat confirmation page. | | smi_end_chat_confirmation_button | End Chat | The end chat button label on the confirmation page. | | smi_end_chat_cancel | Cancel | The cancel button label on the confirmation page. | | smi_end_chat_error_message | Something went wrong. Please try again later. | Error message to display on the end chat confirmation page if ending the chat fails. | | smi_fallback_message_close_button | Close | The close button label on the fallback message page. | ## Form Message | **Keyword** | **Default Value** | **Description** | | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | smi_form_message_back_button | Back | The back button for the secure form. | | smi_form_message_back_button_accessibility | Back to chat feed | The accessibility text for hitting the back button on form message submission screen. | | smi_form_message_exit_screen_subtitle | After leaving the form, you can open it again in the messaging window. However, your progress isn't saved. | The subtitle for the secure form exit confirmation screen. | | smi_form_message_exit_screen_title | Leave the form | The main title for the secure form exit confirmation screen. | | smi_form_message_footer_back | Back | The text displayed in the footer menu of the form message for the back button. | | smi_form_message_footer_next | Next | The text displayed in the footer menu of the form message for the next button. | | smi_form_message_footer_submit | Submit | The text displayed in the footer menu of the form message for the submit button. | | smi_form_message_divider | %1$d/%2$d | The divider for the form message text field character counter. | | smi_form_message_exit_screen_cancel | Cancel | The cancel button text for the secure form exit confirmation screen. | | smi_form_message_exit_screen_confirm | Leave Form | The leave form button for the secure form exit confirmation screen. | | smi_form_message_option_required_message | One or more options required | The string that is displayed below a form entry to indicate that the item is required. | | smi_form_message_required | %s \* | The string that is displayed to indicate that the form message field is required. | | smi_form_message_required_accessibility | %s is required | The accessibility string that is displayed to indicate that the form message field is required. | | smi_form_message_result_error | Error Submitting Form | The message shown in the chat bubble if a form fails to submit. | | smi_form_message_result_success | Form Submitted | The message shown in the chat bubble when a form has been successfully submitted. | | smi_form_message_result_submitting | Form Submitting | The message shown in the chat bubble when a form is submitting. | | smi_form_message_text_input_required_message | This field is required | The string that is displayed below a form entry that indicates that this item is required. | | smi_form_message_text_invalid_email | Not a valid email | The string that is displayed below a form entry to indicate that the email is invalid. | | smi_form_message_text_invalid_url | Not a valid url | The string that is displayed below a form entry to indicate that the url is invalid. | ## Link Preview | **Keyword** | **Default Value** | **Description** | | ------------------------------ | ----------------- | ----------------------------------------------------------------------- | | smi_link_preview_accessibility | Link preview | The screen reader reads out link preview and then the name of the link. | ## Loading Screen | **Keyword** | **Default Value** | **Description** | | -------------------------------- | --------------------- | --------------------------------------------------------------------------------------------------------- | | 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. | ## Message Search | **Keyword** | **Default Value** | **Description** | | -------------------------------------------------- | --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | smi_message_search_header | Message Search | Header for the message search page. | | smi_message_search_agent_avatar_accessibility | Rep avatar | Accessibility text for the rep avatar in message search search. | | smi_message_search_agent_bot_accessibility | Bot avatar | Accessibility text for the bot avatar in message search search. | | 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_user_avatar_accessibility | User avatar | Accessibility text for the user avatar in message search search. | | smi_no_matching_results | We couldn’t find what you’re looking for. Try searching for something else. | Message displayed when nothing matches the user's search. | | 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_no_search_results | No search results | Message displayed when there are no search results. | | 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_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_users_name | You | The name shown for the user in the timestamp row. | | smi_yesterday_timestamp_message_search | Yesterday | Timestamp text for when the message was sent yesterday. | ## Miscellaneous | **Keyword** | **Default Value** | **Description** | | ------------------------- | ---------------------------------- | ----------------------------------------------------------------------------------------------------- | | 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. | | 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_unknown_entry_message | This message type isn't supported. | The error message that appears when the message type of the message in the chat feed isn't supported. | ## Network Connectivity Banner | **Keyword** | **Default Value** | **Description** | | --------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | 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. | | 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 | ## Participant Client | **Keyword** | **Default Value** | **Description** | | ----------------------------------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | 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. | | smi_participant_client_menu_title_accessibility | Conversation Options Menus | The accessibility message for the participant client menu. | ## Participants | **Keyword** | **Default Value** | **Description** | | -------------------------------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------- | | 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. | | smi_participant_name_default | Participant | Default string for a participant with no display name or subject configured. | ## Pre-Chat | **Keyword** | **Default Value** | **Description** | | --------------------------------------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | smi_back_button_accessibility | Back to chat feed | Accessibility text for hitting the back 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. | | smi_exit_button_accessibility | Exit to chat feed | Accessibility text for hitting the exit button on pre-chat submission screen. | | smi_pre_chat_back_button | Back | The back button for 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_error_valid_phone_format | Use a valid phone number format. | Error message shown when a phone field fails pre-chat validation | | smi_pre_chat_required | %s \* | The string for a pre-chat field label if the field is required. | | smi_pre_chat_required_accessibility | %s is required | Accessibility text for the pre-chat field if the field is required. | | smi_pre_chat_submission_card_title | Form submitted Tap to review | Text for pre-chat cell that shows in chat after submitting form. | | smi_pre_chat_submission_review_title | Submitted Form Details | Header for pre-chat submitted form details. | | 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_unknown_entry_message | This message type isn’t supported. | The error message that appears when the message type of the message in the chat feed isn’t supported. | ## Progress Indicators | **Keyword** | **Default Value** | **Description** | | -------------------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | smi_progress_indicator_single_participant | %s is typing... | The default label for a single participant progress indicator. | | smi_progress_indicator_bot | %s is responding... | The default label for a bot progress indicator. | | smi_progress_indicator_two_participants | %1$s and %2$s are typing... | The default label displayed when two participants are typing. | | smi_progress_indicator_multiple_participants | Multiple people are typing... | The default label displayed when multiple participants are typing. | | smi_progress_indicator_message_accessibility | %1$s %2$s | The accesibility announcement for a bot progress indicator containing the bot display name and the progress message text. | ## Request Transcript | **Keyword** | **Default Value** | **Description** | | ----------------------------------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | smi_transcript_request_button | Request Chat Transcript | The title of the request transcript button in the participant client menu. | | smi_transcript_title | Chat Transcript | The title of the request transcript screen. | | smi_transcript_leave_button | Leave | The leave button on the leave transcript screen. This screen warns the user that if they leave without saving, the transcript is lost. | | smi_transcript_cancel_button | Cancel | The cancel button on the leave transcript screen. This screen warns the user that if they leave without saving, the transcript is lost. | | smi_transcript_leave_title | Leave Transcript | Title of the leave transcript screen. This screen warns the user that if they leave without saving, the transcript is lost. | | smi_transcript_leave_subtitle | Be sure to save the transcript before leaving. | Subtitle of the leave transcript screen. This screen warns the user that if they leave without saving, the transcript is lost. | | smi_transcript_save_button_accessibility | Save Transcript | The accessibility string for the save transcript button. | | smi_transcript_share_button_accessibility | Share Transcript | The accessibility string for the share transcript button. | | smi_transcript_error_message | Something went wrong. Please try again later. | Error message to display on the error screen when the transcript fails to download from the server. | | smi_transcript_alert_save_failed | Save failed | Message to display when the request transcript fails to save on the device. | | smi_transcript_alert_save_succeed | Save was successful | Message to display when a request transcript successfully saves on the device. | ## Routing | **Keyword** | **Default Value** | **Description** | | --------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------ | | 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. | | 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. | ## Streaming Tokens | **Keyword** | **Default Value** | **Description** | | ----------------------------------- | --------------------- | -------------------------------------------------------- | | smi_streaming_text_cursor | ▏ | The cursor shown when a message is streaming. | | smi_streaming_message_accessibility | The bot is responding | The accessibility text used when a message is streaming. | ## Terms and Conditions | **Keyword** | **Default Value** | **Description** | | ------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------ | | smi_terms_and_conditions_accept | Accept | Message displayed next to the checkbox to accept the Terms and Conditions. | | smi_terms_and_conditions_error | Accept the Terms and Conditions to continue. | Error message displayed when the Terms and Conditions are required but not accepted. | ## Typing | **Keyword** | **Default Value** | **Description** | | ---------------------------------------- | --------------------- | -------------------------------------------------------------------------------------- | | smi_typing_indicator_start_accessibility | %s has started typing | The accessibility announcement that informs the user when a participant starts typing. | | smi_typing_indicator_stop_accessibility | %s has stopped typing | The accessibility announcement that informs the user when a participant stops typing. |