Repository navigation
Releases: intercom/intercom-react-native
Release list
10.8.1
Updates the underlying iOS SDK: 19.9.0 → 19.9.1. The Android SDK is unchanged at 18.10.0.
📱 iOS SDK 19.9.1
Enhancements
- Help Center articles now appear as soon as they're drawn, without waiting for every image to finish loading.
Bug fixes
- Fixed a crash that could occur on early iOS 26.0 betas when opening a conversation.
- Fixed a device token being rejected when it was registered right after the user granted notification permission.
- Fixed the sender, timestamp and "via Klipy" credit on GIF messages stretching across the full message width, or the credit being missing.
⚠️ CocoaPods deprecation notice
CocoaPods is winding down its central package trunk, which becomes read-only on 2 December 2026. Intercom is deprecating CocoaPods as an installation method for the iOS SDK and will stop publishing new versions of the Intercom pod before that date. Versions already published will continue to install. See the iOS SDK 19.9.1 release notes for migration guidance.
⚠️ Android compatibility notice
The next major Android SDK will be built with Kotlin 2.3 and will require apps to use Kotlin 2.0 or later due to binary compatibility.
10.8.0
Updates the underlying native SDKs: iOS 19.8.1 → 19.9.0 and Android 18.9.3 → 18.10.0, and adds setUserJwtProvider / removeUserJwtProvider to the React Native API.
New: User JWT provider — register a provider with Intercom.setUserJwtProvider(async () => jwt) and Intercom asks your app for a fresh user JWT when the current one is about to expire or has expired, then retries the requests that failed with the new token. Open Messenger screens recover without being reopened. See the README for details.
📱 iOS SDK 19.9.0
Release notes: 19.8.2, 19.8.3, 19.8.4, 19.9.0
Enhancements
- Added
setUserJwtProviderso Intercom can ask your app for a fresh user JWT when the current one is about to expire or has expired, and retry affected requests with the new token. - Messenger screens now recover after an expired user JWT is replaced, without needing to reopen the Messenger.
- Added support for iOS 27.
- Added support for configuring the Messenger environment from the host app's Info.plist.
- Messenger layouts now adapt when the app window is resized.
- Updated the conversation header with a larger avatar and refined title and subtitle sizes.
- Moved the sender's name and message time below admin, bot and Fin message bubbles, to match the web and Android Messengers.
- VoiceOver now moves focus to the Home greeting when the Messenger opens.
Bug fixes
- Fixed a crash that could occur at app launch on older iOS versions when push notifications are integrated automatically.
- Fixed a crash that could occur on long conversation threads.
- Fixed a crash that could occur when opening a Help Center article in apps that add methods to every object.
- Fixed an issue where the Messenger could fail to load after a cold launch until the app was backgrounded and reopened.
- Fixed an issue where failed conversation rating submissions could appear successful.
- Fixed an issue where a new conversation refused by the workspace could show a "Try Again" option that could never succeed.
- Fixed an issue where the "Fin is thinking" indicator may not appear while Fin was working through a Procedure.
- Fixed an issue where embedded videos could stop and reload during playback while a conversation was updating.
- Fixed an issue where reactions may not appear on in-app posts, full-screen posts and notes.
- Fixed an issue where Home cards and the conversation screen could be cut off on folded iPhones.
- Fixed an issue where part of the host app could appear black behind the Messenger, or the Inbox empty state could be misaligned, after resizing the app window.
- Fixed an issue where the create ticket button's icon and title could be invisible in dark mode.
- Fixed an issue where the survey background fade could show a light band in dark mode.
- Fixed an issue where bullet list text in Large Posts opened from a conversation could appear in a hard-to-read color.
- Fixed an issue where VoiceOver could start reading partway down a Help Center article instead of at its title.
🤖 Android SDK 18.10.0
Release notes: 18.9.4, 18.9.5, 18.9.6, 18.10.0
Enhancements
- Added
setUserJwtProviderso the SDK can request a fresh user JWT when the current one expires, and retry the requests that failed because of it. - Home, Conversation, Inbox and Tickets now reload when a new user JWT is set after an expired-JWT failure.
- Consecutive messages from the same teammate are now grouped together for the whole day, matching the web Messenger.
Bug fixes
- Fixed an ANR when the FCM push token listener ran on the main thread, and main-thread blocking when the push token was read for the first time.
- Fixed a crash in the composer when the workspace's attachment settings don't include a trusted file list.
- Fixed failed CSAT ratings and remarks appearing as saved, and show when the rating window is closed.
- Fixed a message that can't start a new conversation re-sending on every tap; tapping it now offers to delete it.
- Fixed session starts being counted before the server accepted them.
- Fixed the Recent message card on Home remaining stale after returning from a conversation.
- Fixed saving an image from the attachment preview using excess memory and changing the file's format and resolution.
- Fixed the create-ticket icon and title being invisible in dark mode.
- Fixed Messenger text becoming hard to read on devices that apply the system's "dark mode for apps" to a Messenger set to light mode.
Dependency updates
- Paging updated to 3.5.1.
⚠️ Android compatibility notice
The next major Android SDK will be built with Kotlin 2.3 and will require apps to use Kotlin 2.0 or later due to binary compatibility.
10.7.1
Updates the underlying native SDKs: iOS 19.8.0 → 19.8.1 and Android 18.9.0 → 18.9.3.
📱 iOS SDK 19.8.1
Bug fixes
- Fixed layouts rendering incorrectly for right-to-left languages.
- Fixed code blocks in streamed Fin answers stopping updates until the answer completed.
- Fixed code blocks in posts rendering without card styling or with unreadable text.
- Fixed device-token registration with an expired identity-verification token making an unnecessary request and reporting an incorrect error.
- Fixed a crash when dismissing a survey shown at app launch on iOS 26.
- Fixed Intercom push notifications failing to open the conversation after a cold app launch.
🤖 Android SDK 18.9.3
Bug fixes
- Fixed a crash during
Intercom.initializewhen the DataStore shared-counter native library cannot be loaded. - Fixed canceled network requests continuing to retry and delaying later conversation loads on slow connections.
Dependency updates
- AppCompat updated to 1.8.0.
- Fragment updated to 1.9.0.
⚠️ Android compatibility notice
The next major Android SDK will be built with Kotlin 2.3 and will require apps to use Kotlin 2.0 or later due to binary compatibility.
10.7.0
Updates the underlying native SDKs: iOS 19.7.2 → 19.8.0, Android 18.7.0 → 18.9.0 (Android also picks up everything from 18.8.0).
📱 iOS SDK 19.8.0
New: Code blocks — code blocks in conversations now render on their own card with syntax highlighting, line numbers and a copy action. Long or tall snippets scroll within the card or open full screen. Inline code renders as a rounded chip in the platform monospace font.
Enhancements
- Added Georgian and Armenian to the languages the Messenger supports.
Bug fixes
- Fixed a crash that could occur when a typing indicator and a thinking indicator arrived together in a conversation.
- Fixed a crash that could occur when the host app ships a layout file with the same name as the Messenger's error screen.
- Fixed an issue where the Messenger could render inside the Picture in Picture window instead of the host app.
- Fixed an issue where dismissing the keyboard after sending could restore the sent text into the composer.
- Fixed an issue where the composer could accept a free-text reply when a workflow's reply buttons should have been the only option.
- Fixed an issue where ordered list items could be omitted from VoiceOver and from copied text.
- Fixed an issue where the collapsed Home header could appear as a light bar in dark mode.
🤖 Android SDK 18.9.0
Enhancements
- Smoother message rendering and reply reveal in conversations.
- Sender name and timestamp now shown under the latest incoming message.
Bug fixes
- Fixed a crash on activity resume in host apps that repackage or obfuscate the SDK's classes.
- Fixed the composer showing a stale state when conversation responses arrive out of order.
🤖 Android SDK 18.8.0
Enhancements
- Show the push notification permission banner only when a push can actually be delivered to the device.
- Refreshed the messenger top action bar with larger avatars and updated typography.
- Scoped the SDK's ProGuard keep rules further, so R8 can obfuscate more Intercom classes in minified host apps.
Bug fixes
- Fixed the conversation avatar being clipped against the screen edge when the top bar has no navigation icon.
Dependency updates
- ConstraintLayout updated to 2.2.2.
⚠️ Heads-up for Android integrators
The next major version of the Intercom Android SDK will be built with Kotlin 2.3 and will require apps to use a minimum Kotlin version of 2.0 due to binary compatibility. This release is unaffected.
10.6.0
What's Changed
Android 18.7.0
Release Date: 06-08-2026
🚀 Enhancements
- Inline
<code>spans in messages now render in a monospace font on the code background - R8 can now remove unused Intercom SDK classes from minified host apps — the SDK's consumer ProGuard rules no longer pin every class. Names and members of retained classes are unchanged, so reflection, Gson parsing and WebView bridges behave as before
🐛 Bug Fixes
- Fixed crash reports being attributed to Intercom when an Intercom frame merely appeared in a host-app crash's stack trace — attribution is now by throw site
👉 Note
- The next major version of the Android SDK will be built with Kotlin 2.3 and will require apps to use a minimum Kotlin version of
2.0due to binary compatibility
iOS 19.7.2
Release Date: 06-08-2026
🐛 Bug Fixes
- Fixed an issue where sheets presented from the conversation header could appear full screen and undismissable on iPhone in landscape.
- Fixed an issue where universal links tapped in the Messenger could open in Safari instead of the host app on apps using the scene lifecycle.
- Fixed an issue where files added to a ticket form with multiple file-upload fields could appear under the wrong field.
Full Changelog: 10.5.0...10.6.0
10.5.0
What's Changed
Android 18.6.0
Release Date: 27-07-2026
✨ New Features
- Added pinch-to-zoom, double-tap-to-zoom, and pan on full-screen image attachments
🐛 Bug Fixes
- Fixed an ANR during
Intercom.initialize()caused by Android Keystore and persisted-identity reads blocking the calling thread - Fixed the keyboard covering form fields in Canvas Kit sheets by handling IME insets
- Fixed a crash from a null
trustedFileExtensionsin persisted attachment settings - Fixed empty list items rendering a dangling bullet in message and survey text
👉 Note
- The next major version of the Android SDK will be built with Kotlin 2.3 and will require apps to use a minimum Kotlin version of
2.0due to binary compatibility
iOS 19.7.1
Release Date: 21-07-2026
🚀 Enhancements
- Added pinch-to-zoom and double-tap-to-zoom to the image previewer for received images.
🐛 Bug Fixes
- Fixed an issue where the composer could remain interactive when it should have been visible but disabled.
- Fixed a crash that could occur at launch on iOS 15 and 16 devices.
- Fixed an issue where bullet list items could render with excessive spacing between them.
Full Changelog: 10.4.0...10.5.0
10.4.0
What's Changed
✨ React Native
- Added
Intercom.suppressProactiveContent(types)to suppress proactive content (carousels, surveys)
Android 18.5.0
View Release Notes
Release Date: 15-07-2026
✨ New Features
- Added
Intercom.suppressProactiveContentto let host apps suppress carousel and survey content independently of in-app messages
🐛 Bug Fixes
- Fixed a crash when the device's legacy SharedPreferences was unavailable (e.g. an isolated process) during the DataStore migration
- Fixed voice recordings and in-progress transcription being lost on screen rotation, and removed the recording-time orientation lock (which Android 17 ignores on large-screen displays anyway)
👉 Dependency updates
- Firebase Messaging: Updated to 25.1.1
👉 Note
- The next major version of the Android SDK will be built with Kotlin 2.3 and will require apps to use a minimum Kotlin version of
2.0due to binary compatibility
iOS 19.7.0
View Release Notes
Release Date: 15-07-2026
🚀 Enhancements
- Added a new
suppressProactiveContent(_:)API to control which proactive content types (carousels, surveys) can be displayed during pre-authentication launch flows. - Added Unity wrapper identification so conversations opened from Unity apps are attributed to the Unity SDK.
🐛 Bug Fixes
- Fixed an issue where the Messenger could freeze when using the edge-swipe back gesture.
- Fixed an issue where a multiline ticket field could be hidden behind the keyboard when focused.
Full Changelog: 10.3.4...10.4.0
10.3.4
What's Changed
Android 18.3.2
Release Date: 01-07-2026
🐛 Bug Fixes
- Fixed a crash rendering the legacy messenger app card when the WebView provider threw an unexpected error during initialization
- Fixed the composer opening in a new task (or silently failing to open) when launched from Help Center on some host apps
- Fixed a crash opening Help Center when no back-press dispatcher was available in the host app
- Fixed crashes when picking a missing or unreadable media file, and a gap that let a required upload question be bypassed
- Fixed a crash compressing a video whose source file was missing or unreadable
👉 Dependency updates
- Compose BOM: Updated to 2026.06.00
iOS 19.6.4
Release Date: 01-07-2026
🐛 Bug Fixes
- Fixed a crash that could occur at launch on some iOS Simulator runtimes.
Full Changelog: 10.3.3...10.3.4
10.3.3
What's Changed
Android 18.3.1
Release Date: 23-06-2026
🐛 Bug Fixes
- Fixed a crash when selecting multiple photos to upload from a Messenger form
- Fixed attribute collectors not appearing in Android conversations
- Fixed a crash caused by push-notification image loading running on the main thread
- Restored the
ThemeModeenum anduipackage to the published artifact, so theme customization works as documented - Fixed Fin reply links rendering with unreadable, low-contrast text
👉 Dependency updates
- Firebase Messaging: Updated to 25.1.0
Full Changelog: 10.3.2...10.3.3
10.3.2
What's Changed
- Guard deconstructRegistration against null Registration by @imSzukala in #451
- chore: bump version to 10.3.2 by @imSzukala in #452
Full Changelog: 10.3.1...10.3.2