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.
| 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. |
| Image 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 user taps the share button on the image viewer screen. |
| SMI.Image.Saved.Message | Image saved | Shown in popup when the user clicks the download button on the image viewer screen. |
| 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. |
| 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 Failure | ||
| 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. |
| 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. |