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 SDK | Core SDK |
|---|---|
| ✅ |
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.
| 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. |
| 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.UnsupportedMediaType | Chatbots can't receive attachments. | The error message appears when trying to send attachments that aren’t supported. |
| 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.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.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.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 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.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). |