10.0.0

Android

Intercom Android SDK upgraded to 18.0.1
View Release Notes

⚡ Important Changes

handlePushMessage() removed (Android)

The Intercom Android SDK now automatically opens the relevant conversation when a push notification is tapped. Remove all calls to Intercom.handlePushMessage() and any associated AppState listeners from your code — no replacement is needed.

Android build requirements raised

Requirement	Before	After
compileSdkVersion	35	36
targetSdkVersion	35	36
buildToolsVersion	35.0.0	36.0.0
Android Gradle Plugin	8.6.1	8.9.0
Gradle	8.7	8.11.1

Internal storage migration (Android)

The SDK migrates from SharedPreferences to DataStore on first launch. This is a one-way migration — downgrading to v9.x afterward will lose local SDK state.

🐛 Bug Fixes

• Fixed GIF search input text being unreadable in dark mode
• Fixed in-app messages disappearing when a permission dialog is shown
• Fixed in-app notifications not responding to swipe-to-dismiss gesture
• Fixed overlays not appearing after returning from a long background period
• Fixed missing messages and unread count not updating after extended background
• Fixed ANR on low-memory devices with repeated Messenger launcher access
• Fixed memory leak in WebView cache with card messages
• Improved spacing between message blocks in in-app notifications
• Fixed overlays rendering behind navigation bar on AppCompatActivity with edge-to-edge

iOS

No changes — SDK remains at ~> 19.5.4.

Full Changelog: 9.8.1...10.0.0

9.8.1

What's Changed

• fix: handle non-array action/intent-filter in AndroidManifest parsing by @elizabit-b in #415
• build(expo-example): upgrade Expo example app from SDK 53 to SDK 54 by @imSzukala in #417
• chore: bump version to 9.8.1 by @jasonpraful in #419

Full Changelog: 9.8.0...9.8.1

9.8.0

What's Changed

• Fixed loginUserWithUserAttributes on Android silently dropping all user attributes.

Full Changelog: 9.7.1...9.8.0

9.7.1

What's Changed

📱 iOS SDK 19.5.4
View Release Notes

Release Date: 11-03-2026

🐛 Bug Fixes

• Fixed a crash that could occur when dismissing the privacy policy screen.
• Fixed a crash that could occur when the app launched via CarPlay.
• Fixed a crash that could occur during app launch due to synchronous disk I/O on the main thread.
• Fixed a crash that could occur due to push notification authorization checks blocking the main thread.
• Fixed a crash that could occur when receiving push notifications while the app was in the foreground.
• Fixed a crash that could occur due to concurrent identity updates.
• Fixed a crash that could occur when starting voice recording during audio route changes.
• Fixed an issue where denying microphone permission could result in an endless loading spinner.
• Fixed an issue where conversation message blocks could appear without spacing between them.
• Fixed an unnecessary divider appearing in Post and Note in-app messages.

🤖 Android SDK 17.4.7
View Release Notes

Release Date: 11-03-2026

🐛 Bug Fixes

• Fixed push notifications not displaying in certain cases
• Fixed unread badge counter not updating in certain cases
• Fixed attachment upload issues
• Fixed various UI issues

👉 Note

• The next major version of the Android SDK will require minSdk 23 (Android 6.0) due to AndroidX Compose library requirements.

Full Changelog: 9.7.0...9.7.1

9.7.0

What's Changed

9.7.0

Expo

✨ New Features

• Added Expo config plugin support for Android push notifications. (#385, #384)

🐛 Bug Fixes

• Fixed config chaining in withIntercomPushNotification that could cause plugin options to be lost. (#383)
• Fixed Metro configuration for monorepo local development in the expo-example. (#387)

Full Changelog: 9.6.4...9.7.0

9.6.4

What's Changed

9.6.4

iOS

🐛 Bug Fixes

• Fixed an issue where CSAT workflow reply buttons could fail to render on closed conversations.
• Fixed an issue where calling logout() while viewing a modally presented screen could leave the Messenger home screen visible behind it.
• Fixed an issue where push notifications could be processed after the user had logged out.
• Fixed an issue where in-app notifications may not display the branded AI agent identity.

🤖 Android

🐛 Bug Fixes

• Fixed a crash that could occur when handling push notifications
• Fixed push notification images not loading correctly in some cases
• Fixed AI agent name and avatar not appearing correctly in in-app notifications

👉 Note

• The next major version of the Android SDK will require minSdk 23 (Android 6.0) due to AndroidX Compose library requirements.

New Contributors

• @Rosie-Kennelly-1 made their first contribution in #383

Full Changelog: 9.6.3...9.6.4

9.6.3

What's Changed

• Revert "Fix Android deep link push notifications causing app restart in foreground"
• chore: bump version to 9.6.3 by @jasonpraful in #376

Full Changelog: 9.6.2...9.6.3

9.6.2

What's Changed

9.6.2

📱 iOS

🐛 Bug Fixes

• Fixed an incorrect CSAT translation key for the OK button.
• Fixed an issue where the unread dot was not vertically centered in inbox cells.
• Fixed an issue with audio transcription where transcriptions could fail frequently.
• Fixed an issue where the send button VoiceOver announced "Arrow Up Circle Button" instead of an appropriate label.
• Fixed an issue where unordered lists could overlap other content.
• Fixed an issue where tickets could disappear from the Recent Tickets card.
• Fixed a crash that could occur with stacked notifications.
• Fixed an issue where the navigation bar did not match the background color in carousels and surveys on iOS versions below 26.
• Fixed an issue where retrying a failed multi-part conversation could result in an upload mismatch.

🤖 Android

🐛 Bug Fixes

• Fixed various in-app notification UI issues
• Fixed workflows not triggering in certain cases

👉 Note

• The next major version of the Android SDK will require minSdk 23 (Android 6.0) due to AndroidX Compose library requirements.

New Contributors

• @salmageek made their first contribution in #373

Full Changelog: 9.6.1...9.6.2

9.6.1

What's Changed

9.6.1

iOS

iOS SDK version 19.5.1

🐛 Bug Fixes

• Fixes a crash that could occur when retrying failed messages in a conversation.
• Fixes a crash that could occur when new messages appear in the messages screen.
• Fixed a crash that could occur when displaying push notifications.
• Fixed an issue where sending images and videos was broken on iOS 15.
• Fixed an issue with citation sheet layout and close button styling.
• Fixed an issue where the GIF picker appeared too small on iPad.
• Fixes a rendering issue with the transcription component on devices running versions earlier than iOS 26.

Android

Android SDK version 17.4.4

🐛 Bug Fixes

• Fixed carousels not showing up in certain cases

👉 Dependency updates

• Ably: Updated to 1.6.1

👉 Note

• The next major version of the Android SDK will require minSdk 23 (Android 6.0) due to AndroidX Compose library requirements.

Full Changelog: 9.6.0...9.6.1

9.6.0

What's Changed

9.6.0

iOS

🚀 Enhancements

• Removed Sentry crash reporting from the SDK.

🐛 Bug Fixes

• Fixed an issue where the close button on survey modals may not dismiss the survey.
• Fixed an issue where images in outbound content with transparency could render with a gray background.
• Fixed an issue where list blocks could lose their text content.
• Fixed an issue that could cause incorrect tap behavior on images within carousels.
• Fixed an issue where images in carousels and posts may display with incorrect styling.
• Fixed an issue that could cause overlapping content in carousels containing image and text blocks.
• Fixed an issue where the article reactions UI could obscure article content.
• Fixed an issue where deleted or unavailable articles may not display the appropriate error message.
• Fixed an issue where the "Start a conversation" button in the sad reaction prompt may not respect Messenger configuration settings.
• Fixed an issue that could prevent article reactions from submitting correctly.
• Fixed an issue where anchor links within articles may not scroll to the referenced section.
• Fixed an issue where article content may not respect device safe areas.
• Fixed an issue where articles linked from messenger apps in conversations may not open correctly in the article viewer.
• Fixed an issue where tapping the "disappointed" reaction may not start a new conversation.
• Fixed an issue that could prevent interactions with buttons and links in posts from working correctly.
• Fixed an issue where YouTube videos in posts may not play.
• Fixed an issue where tapping images in posts may not display the image preview.
• Fixed an issue where posts may not dismiss after tapping deep links.
• Fixed an issue where post content could get cut off when reactions are displayed.
• Fixed an issue where large posts could allow content to scroll behind the reactions area.
• Fixed a crash that could occur when dismissing a survey with a confirmation dialog on iPad.
• Fixed a crash that could occur when tapping "Try Again" on a failed attachment upload in ticket forms on iPad.
• Fixed a crash that could occur when deleting an attachment from the ticket form preview on iPad.
• Fixed an issue where the Messenger UI could become misaligned when rotating the device while the Messenger is open on iPad.
• Fixed an issue where retrying a failed attachment upload could create a duplicate attachment instead of retrying the original.
• Fixed an issue where conversation content could be visible through the composer background on iOS versions below 26.
• Fixed an issue where the "Start a conversation" button may appear without its background on iOS versions below 26.
• Fixed an issue where YouTube videos embedded in content may not play correctly.
• Fixed an issue where CSAT "tell us more" feedback could appear to fail, requiring multiple retries.
• Fixed an issue where the GIF search bar and close button may not work correctly on iOS versions below 26.

Android

🐛 Bug Fixes

• Fixed discrepancy between sent and completed metrics for single-screen carousel
• Fixed carousels orientation restriction causing Google Play Store compliance warning for Android 16

👉 Note

• The next major version of the Android SDK will require minSdk 23 (Android 6.0) due to AndroidX Compose library requirements.

Full Changelog: 9.5.0...9.6.0