Known limitations in 5.x
This page lists public SDK API parameters that, in the current version (5.x), are either not applied or applied with restrictions, as well as deprecated type names and properties. For parameters with restrictions, the page describes what is used instead and the resulting symptom.
Parameters not applied in 5.x
In 5.x the properties listed below are ignored by the runtime — changing their value has no effect on the appearance.
| Parameter | What is used instead | Symptom |
|---|---|---|
ChatInputTextStyle.borderColor | system UIColor.systemGray2 | The input field border color does not change |
ChatInputTextStyle.borderWidth | fixed value 0.5 | The input field border width does not change |
ChatInputQuoteStyle.titleTextStyle | messageAuthorTextStyle | The quote title is not styled separately — the author style is used |
ChatInputQuoteStyle.subtitleTextStyle | messageTextStyle | The quote subtitle is not styled separately — the message text style is used |
QuickReplyStyle.buttonHeight | automatic calculation based on content | Quick reply button height is determined by the cell layout |
QuickReplyStyle.insets | values hardcoded in the implementation | Quick reply button insets are fixed. Additionally: the property is declared as public let and cannot be overridden |
SurveyChatMessageStyle.voteLikeCompleted | — | The like button style after the survey completes is not applied |
SurveyChatMessageStyle.voteCompletedColor | — | The color of completed survey elements is not applied |
SurveyChatMessageStyle.onStarTextStyle | — | The text style next to rating stars is not applied |
SurveyChatMessageStyle.underStarTextStyle | — | The caption style under rating stars is not applied |
AudioPlayerStyle.recordButtonStyle | — | The audio record button style is not applied |
ChatInputVoiceStyle.sendButtonStyle | ChatInputStyle.sendButtonStyle | In voice message mode, the shared send button style is used |
ChatImages.backButtonImage | the system UIKit icon | The system "Back" button icon in UINavigationController is not replaced. To customize the close button, use closeButtonImage and NavigationBarStyle.closeButtonStyle |
NavigationBarStyle.backButtonColor | NavigationBarStyle.closeButtonStyle.color.normal | On the only usage path, the value is immediately overwritten by the color from closeButtonStyle.color.normal. For the close button color use closeButtonStyle.color.normal; the color of the system "Back" button in a regular UINavigationController is also not controlled by this parameter |
ChatImages.errorAlertImage | — | The property is declared but not read by UI code in 5.x — changing its value has no effect on error display |
ChatImages.errorShieldImage | — | The property is declared but not read by UI code in 5.x — changing its value has no effect on the file type error display |
Parameters with conditional application
The properties listed below do work, but only under specific conditions. If your scenario does not match the condition, changing the value has no effect.
| Parameter | Condition |
|---|---|
NavigationBarStyle.titleTextStyle.font | Only when NavigationBarStyle.isConfigurable = true. The color (titleTextStyle.color) applies in both modes |
NavigationBarStyle.subtitleTextStyle | Only when NavigationBarStyle.isConfigurable = true. In system mode the subtitle is not displayed |
ChatInputVoiceStyle.deleteButtonStyle | Only the image, backgroundColor, and textStyle.font properties apply. The other properties (color, tintColor, cornerRadius) are ignored |
SearchBarStyle.cancelButtonStyle | Only color.normal applies: on iPad — as the tintColor of UIBarButtonItem; on iPhone — as the foregroundColor text attribute via UIBarButtonItem.appearance(...). The other properties (color.highlighted/disabled, image, backgroundColor, textStyle, cornerRadius) are ignored |
ChatMenuStyle.titleTextStyle | Only .color applies, and not as the title color, but as the tintColor of the entire UIAlertController (affects the color of action buttons). Font and other text attributes are not configurable — a UIAlertController limitation |
ChatMessagesStyles.bubbleErrorColor | Applies only to outgoing messages (from the client). The "not delivered" state is not defined for incoming messages |
ChatNetworkConfig.HTTPConfig.connectionTimeout | Applies only to REST requests. For WebSocket, a separate wsConfig.connectionTimeout is used |
ChatConfig.keepSocketActive, ChatConfig.keepSocketActiveDuringOperatorSession | By default (shouldUseRemoteConfig = true) the channel server config takes priority; local values are used as a fallback if the server has not sent the corresponding field. To guarantee that only local settings are used, set shouldUseRemoteConfig = false |
QuickReplyStyle.color (normal/highlighted) | Applies only in mode = .toolbar. In mode = .embed (default), the button background is taken from QuickReplyStyle.backgroundColor and color is ignored |
QuickReplyStyle.borderWidth | Applies only in mode = .embed (default). In mode = .toolbar the border width is hardcoded to 1 and does not change |
NavigationBarStyle.closeButtonStyle | Only image and color.normal apply (see also backButtonColor above). The properties color.highlighted/disabled, backgroundColor, cornerRadius, tintColor, textStyle are ignored. Applies only when showCloseButton = true and the chat screen is the root controller of navigation |
Deprecated type names
The names below are preserved as aliases for backward compatibility and marked @available(*, deprecated). Use the new names in the right column.
| Old name (deprecated) | Current name |
|---|---|
AudioMessageStyle | AudioChatMessageStyle |
AudioPlayerChatStyle | AudioPlayerStyle |
ButtonChatStyle | ButtonStyle |
FileMessageStyle | FileChatMessageStyle |
IconButtonChatStyle | IconButtonStyle |
ImageMessageStyle | ImageChatMessageStyle |
InputChatTextStyle | ChatInputTextStyle |
InputChatVoiceStyle | ChatInputVoiceStyle |
InputViewStyle | ChatInputStyle |
PhotoPickerStyle | ChatMenuStyle |
PlaceholderChatStyle | ChatPlaceholderStyle |
SearchBarChatStyle | SearchBarStyle |
SystemMessagesStyles | ChatSystemMessagesStyles |
TextChatStyle | ChatTextStyle |
TextMessageStyle | TextChatMessageStyle |
Deprecated properties
The properties below remain public for backward compatibility and are marked @available(*, deprecated). Xcode emits a warning when they are used.
| Property | Location | Replacement |
|---|---|---|
ChatInputTextStyle.alignment | ChatInputTextStyle | Use ChatInputStyle.alignment (alignment is set at the ChatInputStyle level, not on the text field) |
ChatComponents.photoPickerStyle | ChatComponents | Use ChatComponents.chatMenuStyle (the file picker menu style) |
ChatFlow.photoPickerStyle | ChatFlow | Use ChatFlow.addFileMenuStyle (the add-file menu style) |
SurveyChatMessageStyle.questionBackgroundColor | SurveyChatMessageStyle | Use SurveyChatMessageStyle.questionButtonColor |
See also the changelog for per-version details.