Customize Strings for iOS

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 an Localizable.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.
SMI.Chat.Add.ButtonOpen option menu.Content description for the add button in the chat view to open the options menu.
SMI.Chat.Start.ConversationStart ConversationContent description for a button that is used to resubmit pre-chat fields mid-conversation.
SMI.Chat.Start.Conversation.Feed.Input.Text.AccessibilityFill out a pre-chat form to continue the conversationAccessibility announcement when the user needs to enter and resubmit pre-chat fields.
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.
SMI.Unknown.Entry.MessageAgent sent an unsupported message type.The message shown when displaying an unknown entry in the chat 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.Delivery.Status.Error.Additional.Information.RequiredProvide 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.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.Misc.UnknownUnknownThis string is used when a value or result cannot be determined.
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.Back.ButtonBackThe back button for the pre-chat form.
SMI.Pre.Chat.Choice.List.NoneNoneLabel for the None option in a pre-chat choice list.
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.Required%s *The string for a pre-chat field label if the field is required.
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.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.Unknown.Entry.MessageThis message type isn’t supported.The error message that appears when the message type of the message in the chat feed isn’t supported.
SMI.Pre.Chat.Required.Accessibility%s is requiredAccessibility text for the pre-chat field if the field is required.
SMI.Back.Button.AccessibilityBack to chat feedAccessibility text for hitting the back button on pre-chat submission screen.
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.Header.Share.Gif.ViewerGIFShown when the user taps the share button when viewing a GIF 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 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.
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).
Business Hours
SMI.Business.Hours.OutsideNew chats aren't available outside of business hoursThe message that is shown in the chat feed banner when outside of business hours.
SMI.Business.Hours.Outside.AccessibilityNew 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.TitleConversation OptionsText 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.AccessibilityConversation Options MenusThe accessibility message for the participant client menu.
Terms and Conditions
SMI.Terms.And.Conditions.AcceptAcceptMessage displayed next to the checkbox to accept the Terms and Conditions.
SMI.Terms.And.Conditions.ErrorAccept the Terms and Conditions to continue.Error message displayed when the Terms and Conditions are required but not accepted.