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 exact same 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.
Image 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 on the image viewer screen.
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.
Agent Transfer
SMI.Transfer.Requested.Event.TextTransfer requested at %sA system message informing the user that an agent transfer has been requested.
Routing Failure
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.
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.