DocumentationAPI Reference

Known issues

Limitations and known issues

Limitations

  • Compatibility with Classic mobile SDKs: Only compatible with the latest Classic SDK version dated March 21, 2023 and later.
  • Single SDK Instance: Only one instance of the Zendesk SDK can run at a time in your app.
  • Push Notification Deep Linking: If the app is killed, tapping a push notification opens the app but does not deep link to the conversation screen. For more information, see Handle push notifications in your app.
  • Limited UI Customization: Only a small set of SDK UI colors can be modified in the Admin Center.
  • Swift UI Limitations: The SDK is not fully compatible with Swift UI. Apps using the SDK with Swift UI may not function correctly.
  • Conversation Observers: Cannot retrieve agent availability or queue position.
  • Supported Image Types: Only jpeg, jpg, gif, and png. For a full list, see File Validation.
  • File Size Limit: Attachments are limited to 50MB. Larger files will not be sent, and users will see a warning.
  • One Attachment per Message: Only one file can be attached per message.
  • APNS Sandbox Certificate Not Supported: Only Production Certificates are supported for Push Notifications.
  • iOS 12.x and earlier Image Picker Orientation: The image picker may not respect device orientation. For more information, see UIImagePickerController in Apple's documentation.
  • No Event for Failed Field Validation: No event is emitted for failed field validation when setting conversation fields. This will be added in a future release.
  • Article Viewer Overlay Limitation: Overlay support for articles is only available when the account does not use host mapping or advanced methods that change the subdomain URL. Articles can still be viewed in the browser.
  • Page View Linked to Previous external_id: If a user logs in with a new external_id before starting a new conversation, Page Views may still be associated with the old external_id.
    Workaround: Use the same external_id with a new expiration date if possible.

Using the SDK with Mobile App Wrappers

Zendesk does not provide or support SDK packages for wrapper frameworks such as React Native, Xamarin, Flutter, Ionic, etc.

Things to Keep in Mind