Added the optional @getstoryteller/react-native-storyteller-sdk-vast package, with generic VAST and GAM VAST setup, dynamic request-parameter callbacks, and diagnostics events.
Added GAM Clips bottom-banner configuration and AdMob setup through setupAdMobModule, including native, banner fallback, bottom-banner, custom KVP, and banner-priority options.
Expanded the core SDK API with player visibility and mute helpers, nullable locale clearing, deep-link naming aliases, Android Clips preloading and category count helpers, custom attribute replacement, followed-category helpers and catalog access, custom share handling, and client-supplied ad completion/failure methods.
Added optional StorytellerClipsAdConfiguration to imperative Clips collection opening and Embedded Clips, allowing individual presentations to opt into pre-roll and bottom-banner placements while preserving native defaults when omitted.
Expanded user-activity analytics to the current native event and payload surface, including tile visibility, mute/captions, search, sheet, card, ad lifecycle/revenue, SDK initialization, and followable-category events.
Expanded theme support for player icons and Clips controls, Clips like-button Lottie animations, card audio icons, poll image gradients, followable-category gestures, and list player-open behavior.
Updated the native dependencies to Storyteller iOS 11.5.0 and Android 11.5.1; Android SDK and ads artifacts now resolve from Maven Central instead of the legacy Storyteller CloudRepo/MyGet repository.
Normalized global and per-view React Native image resources before native theme conversion and added Android drawable/resource support for custom player imagery.
Improved Android custom-font reuse by resolving packaged res/font families, caching equivalent native themes, and avoiding redundant theme application during React renders.
Aligned DataLoadCompletedEvent with all component payloads: list and Card callbacks include dataCount, while Embedded Clips may omit it.
added support for Gradient Borders on Circular Tiles, Live Chips and Tile Chips, chip.show property for rectangular tiles and many other theme updates, see Themes for more details
updated setup of the Embedded Clips component, see Embedded Clips for more details
added Storyteller Home component for showing multiple Stories and Clips Rows or Grids to be embedded in a single screen in your application in a list, see Storyteller Home for more details
added reorder animation when row Tiles change their order
added support for GAM Native Ads, see Ads for more information
added For You / Following feature to our embedded clips
added auto reloading support to our lists
added support for handling back navigation within SDK in Embedded Clips on Android, see StorytellerEmbeddedClipsView for more details
{"slug": "changelog", "page_title": "Changelog", "page_url": "Changelog/", "canonical_url": "/react-native/Changelog/", "markdown": "# Changelog\n\n## 11.5.0 - 16/07/26\n\n### New Features\n\n- Added the optional `@getstoryteller/react-native-storyteller-sdk-vast` package, with generic VAST and GAM VAST setup, dynamic request-parameter callbacks, and diagnostics events.\n- Added GAM Clips bottom-banner configuration and AdMob setup through `setupAdMobModule`, including native, banner fallback, bottom-banner, custom KVP, and banner-priority options.\n- Expanded the core SDK API with player visibility and mute helpers, nullable locale clearing, deep-link naming aliases, Android Clips preloading and category count helpers, custom attribute replacement, followed-category helpers and catalog access, custom share handling, and client-supplied ad completion/failure methods.\n- Added optional `StorytellerClipsAdConfiguration` to imperative Clips collection opening and Embedded Clips, allowing individual presentations to opt into pre-roll and bottom-banner placements while preserving native defaults when omitted.\n- Expanded user-activity analytics to the current native event and payload surface, including tile visibility, mute/captions, search, sheet, card, ad lifecycle/revenue, SDK initialization, and followable-category events.\n- Expanded theme support for player icons and Clips controls, Clips like-button Lottie animations, card audio icons, poll image gradients, followable-category gestures, and list player-open behavior.\n\n### Improvements\n\n- Updated the native dependencies to Storyteller iOS `11.5.0` and Android `11.5.1`; Android SDK and ads artifacts now resolve from Maven Central instead of the legacy Storyteller CloudRepo/MyGet repository.\n- Normalized global and per-view React Native image resources before native theme conversion and added Android drawable/resource support for custom player imagery.\n- Improved Android custom-font reuse by resolving packaged `res/font` families, caching equivalent native themes, and avoiding redundant theme application during React renders.\n- Aligned `DataLoadCompletedEvent` with all component payloads: list and Card callbacks include `dataCount`, while Embedded Clips may omit it.\n\n### Bug fixes\n\n- Fixed iOS GAM ad-unit requests so combined and Clips bottom-banner ads can await JavaScript responses without blocking the main thread.\n- Fixed Android custom share handling so `shareButtonTapped` reaches the React Native listener.\n- Restored native Clips list player ownership so viewed state refreshes after dismissal without resetting the iOS More-grid scroll position.\n\n## 11.2.1 - 05/03/26\n\n### Bug fixes\n\n- fixed Card playback video issue on Android\n\n## 11.2.0 - 26/02/26\n\n### Breaking Changes\n\n- updated the Storyteller iOS SDK to version 11.2.0 - see the [main release notes](https://docs.getstoryteller.com/ios/Changelog/) for more details\n- updated the Storyteller Android SDK to version 11.2.2 - see the [main release notes](https://docs.getstoryteller.com/android/Changelog/) for more details\n- updated the public API to match the native SDKs\n\n## 11.0.10 - 20/02/26\n\n### Bug fixes\n\n- fix intermittent Storyteller Card height race condition that could render card text outside the card\n\n## 11.0.9 - 03/02/26\n\n### Bug fixes\n\n- fix Storyteller Card incorrect sizing\n\n## 11.0.8 - 14/01/26\n\n### Bug fixes\n\n- fix lifecycle crash in RN to Android bridge component\n\n## 11.0.7 - 01/12/25\n\n### Bug fixes\n\n- fix analytics crash on Android\n\n## 11.0.6 - 06/11/25\n\n### Improvements\n\n- Expo 54 support has been added\n\n## 11.0.5 - 10/10/25\n\n### Improvements\n\n- Align methods with native SDKs\n\n## 11.0.4 - 02/10/25\n\n### Improvements\n\n- Documentation updates\n- Fixed Android OOM issues with proper Compose view cleanup\n- Fixed Expo plugin export bug\n\n## 11.0.3 - 01/10/25\n\n### Improvements\n\n- Android: unified all SDK-backed views under a common Compose host view (`StorytellerComposeView`) for consistency and maintenance; no public API changes\n\n## 11.0.2 - 30/09/25\n\n### Improvements\n\n- Embedded Clips: fixed state issues that occurred after resetting the user\n- iOS integration: support both modular and non-modular header imports to improve compatibility with different project setups\n\n## 11.0.1 - 25/09/25\n\n### New Features\n\n- Expo config plugin: add iOS SDK version pinning via plugin options\n- Expo config plugin: add Android autolinking exclusion to avoid duplicate linking in certain setups\n\n## 11.0.0 - 24/09/25\n\n### Breaking Changes\n\n- React Native New Architecture required (Fabric + TurboModules), see the [Migration Guide (v10.x to v11.0.0+)](getting-started/migration-v10-to-v11.md)\n- Promise-based API replaces callbacks; imports/exports reorganized \u2014 use `StorytellerSdk` as the main interface\n- Removed `Storyteller.currentUserId` for VPPA compliance\n- Removed non-public analytics properties and updated event payloads, see [Analytics](Analytics.md)\n\n### New Features\n\n- New Fabric components: Stories Row, Stories Grid, Clips Row, Clips Grid, Embedded Clips\n- New components: Cards and Storyteller Home for multi-row/grid screens\n- Added `onTileTapped` support across list components\n- Embedded Clips: For You / Following feed support, auto reloading, and Android back navigation handling\n\n### Improvements\n\n- Restored `dataCount` on Embedded Clips `onDataLoadCompleted`\n- Fixed delegate methods not emitting consistently; theming fixes and stability improvements\n- Only reload Embedded Clips when the collection changes; fixed opening by external category ID\n\n## 10.8.3 - 05/11/25\n\n### Improvements\n\n- fixed an Android crash\n\n## 10.8.2 - 04/03/25\n\n### New Features\n\n- updated the Storyteller iOS SDK to version 10.8.2 - see the [main release notes](https://docs.getstoryteller.com/ios/Changelog/) for more details\n- updated the Storyteller Android SDK to version 10.7.6 - see the [main release notes](https://docs.getstoryteller.com/android/Changelog/) for more details\n- added support for Expo projects, see [Expo](getting-started/expo.md) for more details\n- added theming updates for the `Search` heading on iOS, see [Themes](Themes.md) for more details\n\n### Improvements\n\n- fixed an issue on Android where only 8 items were shown in Clips and Stories grids\n- fixed an issue on Android where page navigation using react-native-screens v3 caused a crash\n\n## 10.7.1 - 06/02/25\n\n### Improvements\n\n- fix for Android build issue when using Kotlin versions that are not 1.9.24\n\n## 10.7.0 - 17/01/25\n\n### New Features\n\n- updated the Storyteller iOS SDK to version 10.7.4 - see the [main release notes](https://docs.getstoryteller.com/ios/Changelog/) for more details\n- updated the Storyteller Android SDK to version 10.7.4 - see the [main release notes](https://docs.getstoryteller.com/android/Changelog/) for more details\n\n- added support for viewed Clips\n- removed deprecated individual properties on our list views, in favor of the new configuration objects, see[StorytellerListViews](StorytellerListViews.md) for more details\n- updated analytics events and properties, see [Analytics](Analytics.md) for more details\n- added support for [Followable Categories](UserCustomization.md#followable-categories)\n- Clips support for localized closed captions\n- added support for Gradient Borders on Circular Tiles, Live Chips and Tile Chips, `chip.show` property for rectangular tiles and many other theme updates, see [Themes](Themes.md) for more details\n- updated setup of the Embedded Clips component, see [Embedded Clips](StorytellerEmbeddedClipsView.md) for more details\n- added Storyteller Home component for showing multiple Stories and Clips Rows or Grids to be embedded in a single screen in your application in a list, see [Storyteller Home](StorytellerHome.md) for more details\n- added reorder animation when row Tiles change their order\n- added support for GAM Native Ads, see [Ads](Ads.md#storyteller-gam-ads) for more information\n- added For You / Following feature to our embedded clips\n- added auto reloading support to our lists\n- added support for handling back navigation within SDK in Embedded Clips on Android, see [StorytellerEmbeddedClipsView](StorytellerEmbeddedClipsView.md) for more details\n\n### Improvements\n\n- various crash fixes, UI/UX and Accessibility improvements and performance optimizations\n\n## 9.8.5 - 04/12/24\n\n### New Features\n\n- fixed Android app builds with React Native versions newer than 0.73\n\n## 9.8.4 - 31/01/24\n\n### New Features\n\n- added `reloadData` function to `StorytellerEmbeddedClipsView`\n- updated the Storyteller iOS SDK to version 9.8.1 - see the [main release notes](https://www.getstoryteller.com/documentation/ios/changelog) for more details\n- updated the Storyteller Android SDK to version 9.8.4 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog) for more details\n\n## 9.8.0 - 14/12/23\n\n### New Features\n\n- removed `home` field from `StorytellerTheme`\n- updated the Storyteller iOS SDK to version 9.8.0 - see the [main release notes](https://www.getstoryteller.com/documentation/ios/changelog) for more details\n\n## 9.7.4 - 15/11/23\n\nBug Fixes:\n\n- fixed a crash in `StorytellerSdkThemeUtil` on Android API < 29\n\n## 9.7.3 - 18/10/23\n\n### New Features\n\n- added support for Android 14\n- updated the Storyteller Android SDK to version 9.7.2 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog) for more details\n\n## 9.7.2 - 13/10/23\n\n### New Features\n\n- added `openCategory` method, please see [Storyteller](Storyteller.md) for more details\n- added `openStoryByExternalId` and `openClipByExternalId` methods, please see [Storyteller](Storyteller.md) for more details\n- added `storyDisplayTitle` parameter to analytic events, please see [Analytics](Analytics.md) for more details\n- added `adPlacement` to analytics, please see [Analytics](Analytics.md) for more details\n- We have added the `StorytellerEmbeddedClipsView` so you can [embed the Clips playback experience](StorytellerEmbeddedClipsView.md) in your custom view hierarchy.\n\n### Breaking Changes\n\n- changed signature of ad delegate from `getAdsForList` to `getAd`, please see [Ads](Ads.md) for more details\n\n## 9.1.6 - 16/08/23\n\n- fixed `setCustomAttributes` signature on iOS\n\n## 9.1.5 - 15/08/23\n\n- fixed NPE crash which could occur on some Android devices running the SDK\n\n## 9.1.4 - 18/05/23\n\n- updated the Storyteller Android SDK to version 9.1.4 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog) for more details\n- updated the Storyteller iOS SDK to version 9.1.4 - see the [main release notes](https://www.getstoryteller.com/documentation/ios/changelog) for more details\n\n## 9.1.2 - 08/05/23\n\n- updated the Storyteller Android SDK to version 9.1.2 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog) for more details\n- updated the Storyteller iOS SDK to version 9.1.2 - see the [main release notes](https://www.getstoryteller.com/documentation/ios/changelog) for more details\n- renamed `StorytellerRowView` into `StorytellerStoriesRowView`\n- renamed `StorytellerGridView` into `StorytellerStoriesGridView`\n- changed event interface for `GetAdsForList` to match interface of native SDKs\n- removed tileBecameVisible prop on list components\n\n## 8.5.1 - 01/02/23\n\n- updated the Storyteller Android SDK to version 8.5.1 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog) for more details\n- fixed bug which could cause the app to crash when dealing with invalid data for client ads, themes and initialization\n\n## 8.3.1 - 30/01/24\n\n- updated the Storyteller Android SDK to version 8.3.1 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog) for more details\n\nImprovements:\n\n- added Android font weight support for themes\n- fixed appearance style changes when the app goes into the background\n- enabled iPad as a demo app destination\n- updated theme font docs and code snippets\n\n## 8.3.0 - 09/12/22\n\n- updated the Storyteller Android SDK to version 8.3.0 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog) for more details\n- updated the Storyteller iOS SDK to version 8.3.0 - see the [main release notes](https://www.getstoryteller.com/documentation/ios/changelog) for more details\n\nImprovements:\n\n- added `storytellerPlacement` and `storytellerCurrentCategory` to Google Ad Manager\n- updated Google Ad Manager for React Native\n\n## 8.2.11 - 02/12/22\n\nBug Fixes:\n\n- fixed bug with the category format on `GetAdsForList`\n\n## 8.2.10 - 30/11/22\n\n- updated the Storyteller iOS SDK to version 8.2.4 - see the [main release notes](https://www.getstoryteller.com/documentation/ios/changelog) for more details\n\nBug Fixes:\n\n- fixed bug with type inference and arguments\n- fixed `lists.backgroundColor` theme on React Native Android\n\n## 8.2.9 - 25/11/22\n\n- updated the Storyteller Android SDK to version 8.2.8 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog) for more details\n- updated the Storyteller iOS SDK to version 8.2.3 - see the [main release notes](https://www.getstoryteller.com/documentation/ios/changelog) for more details\n\nImprovements:\n\n- removed validation that User ID has to be set for React Native on Android and iOS\n\n## 8.2.8 - 23/11/22\n\n- updated the Storyteller Android SDK to version 8.2.7 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog) for more details\n- updated the Storyteller iOS SDK to version 8.2.2 - see the [main release notes](https://www.getstoryteller.com/documentation/ios/changelog) for more details\n\nNew Features:\n\n- added support for Clips and Collections\n\n## 8.2.4 - 04/11/22\n\n- updated the Storyteller Android SDK to version 8.2.4 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog) for more details\n- updated the Storyteller iOS SDK to version 8.2.1 - see the [main release notes](https://www.getstoryteller.com/documentation/ios/changelog) for more details\n\nBug Fixes:\n\n- fixed bug with custom themes\n\n## 7.0.3 - 12/04/22\n\n- updated the Storyteller Android SDK to version 7.0.3 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog#7.0.3) for more details\n\n## 7.0.2 - 08/04/22\n\n- updated the Storyteller Android SDK to version 7.0.2 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog#7.0.2) for more details\n- updated the Storyteller iOS SDK to version 7.0.2 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog#7.0.2) for more details\n- updated Storyteller themes\n\n## 6.1.3 - 11/03/22\n\nBug Fixes:\n\n- fixed bug where it was possible for `categories` to not be respected when passed to a `StorytellerListView`\n\nImprovements:\n\n- updated the Storyteller iOS SDK to version 6.1.1 - see the [main release notes](https://www.getstoryteller.com/documentation/ios/changelog#6.1.1) for more details\n\n## 6.1.2 - 23/02/22\n\n- updated the Storyteller Android SDK to version 6.1.2 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog#6.1.2) for more details\n\nBug Fixes:\n\n- fixed a rendering issue which could arise when displaying multiple Storyteller lists on a single view\n- fixed an issue where theming individual rows on Android did not function correctly\n\n## 6.0.2 - 08/02/22\n\n- updated the Storyteller iOS SDK to version 6.0.2 - see the [main release notes](https://www.getstoryteller.com/documentation/ios/changelog#6.0.2) for more details\n- updated the Storyteller Android SDK to version 6.0.2 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog#6.0.2) for more details\n\nNew Features:\n\n- added the `StorytellerRowView` component. For more information please read [StorytellerListViews](StorytellerListViews.md).\n- added the `StorytellerGridView` component. For more information please read [StorytellerListViews](StorytellerListViews.md).\n- added the `Storyteller` object. For more information please read [Storyteller](Storyteller.md).\n\n## 5.0.2 - 08/12/21\n\n- updated the Storyteller iOS SDK to version 5.0.0 - see the [main release notes](https://www.getstoryteller.com/documentation/ios/changelog#5.0.0) for more details\n- updated the Storyteller Android SDK to version 5.0.2 - see the [main release notes](https://www.getstoryteller.com/documentation/android/changelog#5.0.2) for more details\n\nDeprecations and Changes:\n\n- removed the deprecated `cellScale` property from the `Storyteller` component\n\nNew Features:\n\n- added the new `categories` and `categoriesToPreload` properties to the Storyteller component\n\n## 0.9.3 - 06/10/21\n\n- Initial Release\n", "copy_markdown_include_header": false, "base_path": "", "ai_dir": "ai", "missing_payload_behavior": "empty"}