Customize Strings for iOS

The UI SDK provides default text for all the messages that a user can encounter. To customize these strings in your app, create an SMI.strings localizable resource file in your app and override the string keywords. For example:

To learn more, see the Apple documentation on String Resources.

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.
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.UnsupportedMediaTypeChatbots 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 user taps the share button on the image viewer screen.
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 aren’t 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.
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).