Skip to content

Changelog#

11.5.0 - 16/07/26#

New Features#

  • 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.

Improvements#

  • 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.

Bug fixes#

  • Fixed iOS GAM ad-unit requests so combined and Clips bottom-banner ads can await JavaScript responses without blocking the main thread.
  • Fixed Android custom share handling so shareButtonTapped reaches the React Native listener.
  • Restored native Clips list player ownership so viewed state refreshes after dismissal without resetting the iOS More-grid scroll position.

11.2.1 - 05/03/26#

Bug fixes#

  • fixed Card playback video issue on Android

11.2.0 - 26/02/26#

Breaking Changes#

  • updated the Storyteller iOS SDK to version 11.2.0 - see the main release notes for more details
  • updated the Storyteller Android SDK to version 11.2.2 - see the main release notes for more details
  • updated the public API to match the native SDKs

11.0.10 - 20/02/26#

Bug fixes#

  • fix intermittent Storyteller Card height race condition that could render card text outside the card

11.0.9 - 03/02/26#

Bug fixes#

  • fix Storyteller Card incorrect sizing

11.0.8 - 14/01/26#

Bug fixes#

  • fix lifecycle crash in RN to Android bridge component

11.0.7 - 01/12/25#

Bug fixes#

  • fix analytics crash on Android

11.0.6 - 06/11/25#

Improvements#

  • Expo 54 support has been added

11.0.5 - 10/10/25#

Improvements#

  • Align methods with native SDKs

11.0.4 - 02/10/25#

Improvements#

  • Documentation updates
  • Fixed Android OOM issues with proper Compose view cleanup
  • Fixed Expo plugin export bug

11.0.3 - 01/10/25#

Improvements#

  • Android: unified all SDK-backed views under a common Compose host view (StorytellerComposeView) for consistency and maintenance; no public API changes

11.0.2 - 30/09/25#

Improvements#

  • Embedded Clips: fixed state issues that occurred after resetting the user
  • iOS integration: support both modular and non-modular header imports to improve compatibility with different project setups

11.0.1 - 25/09/25#

New Features#

  • Expo config plugin: add iOS SDK version pinning via plugin options
  • Expo config plugin: add Android autolinking exclusion to avoid duplicate linking in certain setups

11.0.0 - 24/09/25#

Breaking Changes#

  • React Native New Architecture required (Fabric + TurboModules), see the Migration Guide (v10.x to v11.0.0+)
  • Promise-based API replaces callbacks; imports/exports reorganized — use StorytellerSdk as the main interface
  • Removed Storyteller.currentUserId for VPPA compliance
  • Removed non-public analytics properties and updated event payloads, see Analytics

New Features#

  • New Fabric components: Stories Row, Stories Grid, Clips Row, Clips Grid, Embedded Clips
  • New components: Cards and Storyteller Home for multi-row/grid screens
  • Added onTileTapped support across list components
  • Embedded Clips: For You / Following feed support, auto reloading, and Android back navigation handling

Improvements#

  • Restored dataCount on Embedded Clips onDataLoadCompleted
  • Fixed delegate methods not emitting consistently; theming fixes and stability improvements
  • Only reload Embedded Clips when the collection changes; fixed opening by external category ID

10.8.3 - 05/11/25#

Improvements#

  • fixed an Android crash

10.8.2 - 04/03/25#

New Features#

  • updated the Storyteller iOS SDK to version 10.8.2 - see the main release notes for more details
  • updated the Storyteller Android SDK to version 10.7.6 - see the main release notes for more details
  • added support for Expo projects, see Expo for more details
  • added theming updates for the Search heading on iOS, see Themes for more details

Improvements#

  • fixed an issue on Android where only 8 items were shown in Clips and Stories grids
  • fixed an issue on Android where page navigation using react-native-screens v3 caused a crash

10.7.1 - 06/02/25#

Improvements#

  • fix for Android build issue when using Kotlin versions that are not 1.9.24

10.7.0 - 17/01/25#

New Features#

  • updated the Storyteller iOS SDK to version 10.7.4 - see the main release notes for more details

  • updated the Storyteller Android SDK to version 10.7.4 - see the main release notes for more details

  • added support for viewed Clips

  • removed deprecated individual properties on our list views, in favor of the new configuration objects, seeStorytellerListViews for more details
  • updated analytics events and properties, see Analytics for more details
  • added support for Followable Categories
  • Clips support for localized closed captions
  • 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

Improvements#

  • various crash fixes, UI/UX and Accessibility improvements and performance optimizations

9.8.5 - 04/12/24#

New Features#

  • fixed Android app builds with React Native versions newer than 0.73

9.8.4 - 31/01/24#

New Features#

  • added reloadData function to StorytellerEmbeddedClipsView
  • updated the Storyteller iOS SDK to version 9.8.1 - see the main release notes for more details
  • updated the Storyteller Android SDK to version 9.8.4 - see the main release notes for more details

9.8.0 - 14/12/23#

New Features#

  • removed home field from StorytellerTheme
  • updated the Storyteller iOS SDK to version 9.8.0 - see the main release notes for more details

9.7.4 - 15/11/23#

Bug Fixes:

  • fixed a crash in StorytellerSdkThemeUtil on Android API < 29

9.7.3 - 18/10/23#

New Features#

  • added support for Android 14
  • updated the Storyteller Android SDK to version 9.7.2 - see the main release notes for more details

9.7.2 - 13/10/23#

New Features#

  • added openCategory method, please see Storyteller for more details
  • added openStoryByExternalId and openClipByExternalId methods, please see Storyteller for more details
  • added storyDisplayTitle parameter to analytic events, please see Analytics for more details
  • added adPlacement to analytics, please see Analytics for more details
  • We have added the StorytellerEmbeddedClipsView so you can embed the Clips playback experience in your custom view hierarchy.

Breaking Changes#

  • changed signature of ad delegate from getAdsForList to getAd, please see Ads for more details

9.1.6 - 16/08/23#

  • fixed setCustomAttributes signature on iOS

9.1.5 - 15/08/23#

  • fixed NPE crash which could occur on some Android devices running the SDK

9.1.4 - 18/05/23#

  • updated the Storyteller Android SDK to version 9.1.4 - see the main release notes for more details
  • updated the Storyteller iOS SDK to version 9.1.4 - see the main release notes for more details

9.1.2 - 08/05/23#

  • updated the Storyteller Android SDK to version 9.1.2 - see the main release notes for more details
  • updated the Storyteller iOS SDK to version 9.1.2 - see the main release notes for more details
  • renamed StorytellerRowView into StorytellerStoriesRowView
  • renamed StorytellerGridView into StorytellerStoriesGridView
  • changed event interface for GetAdsForList to match interface of native SDKs
  • removed tileBecameVisible prop on list components

8.5.1 - 01/02/23#

  • updated the Storyteller Android SDK to version 8.5.1 - see the main release notes for more details
  • fixed bug which could cause the app to crash when dealing with invalid data for client ads, themes and initialization

8.3.1 - 30/01/24#

  • updated the Storyteller Android SDK to version 8.3.1 - see the main release notes for more details

Improvements:

  • added Android font weight support for themes
  • fixed appearance style changes when the app goes into the background
  • enabled iPad as a demo app destination
  • updated theme font docs and code snippets

8.3.0 - 09/12/22#

  • updated the Storyteller Android SDK to version 8.3.0 - see the main release notes for more details
  • updated the Storyteller iOS SDK to version 8.3.0 - see the main release notes for more details

Improvements:

  • added storytellerPlacement and storytellerCurrentCategory to Google Ad Manager
  • updated Google Ad Manager for React Native

8.2.11 - 02/12/22#

Bug Fixes:

  • fixed bug with the category format on GetAdsForList

8.2.10 - 30/11/22#

  • updated the Storyteller iOS SDK to version 8.2.4 - see the main release notes for more details

Bug Fixes:

  • fixed bug with type inference and arguments
  • fixed lists.backgroundColor theme on React Native Android

8.2.9 - 25/11/22#

  • updated the Storyteller Android SDK to version 8.2.8 - see the main release notes for more details
  • updated the Storyteller iOS SDK to version 8.2.3 - see the main release notes for more details

Improvements:

  • removed validation that User ID has to be set for React Native on Android and iOS

8.2.8 - 23/11/22#

  • updated the Storyteller Android SDK to version 8.2.7 - see the main release notes for more details
  • updated the Storyteller iOS SDK to version 8.2.2 - see the main release notes for more details

New Features:

  • added support for Clips and Collections

8.2.4 - 04/11/22#

  • updated the Storyteller Android SDK to version 8.2.4 - see the main release notes for more details
  • updated the Storyteller iOS SDK to version 8.2.1 - see the main release notes for more details

Bug Fixes:

  • fixed bug with custom themes

7.0.3 - 12/04/22#

  • updated the Storyteller Android SDK to version 7.0.3 - see the main release notes for more details

7.0.2 - 08/04/22#

  • updated the Storyteller Android SDK to version 7.0.2 - see the main release notes for more details
  • updated the Storyteller iOS SDK to version 7.0.2 - see the main release notes for more details
  • updated Storyteller themes

6.1.3 - 11/03/22#

Bug Fixes:

  • fixed bug where it was possible for categories to not be respected when passed to a StorytellerListView

Improvements:

  • updated the Storyteller iOS SDK to version 6.1.1 - see the main release notes for more details

6.1.2 - 23/02/22#

  • updated the Storyteller Android SDK to version 6.1.2 - see the main release notes for more details

Bug Fixes:

  • fixed a rendering issue which could arise when displaying multiple Storyteller lists on a single view
  • fixed an issue where theming individual rows on Android did not function correctly

6.0.2 - 08/02/22#

  • updated the Storyteller iOS SDK to version 6.0.2 - see the main release notes for more details
  • updated the Storyteller Android SDK to version 6.0.2 - see the main release notes for more details

New Features:

  • added the StorytellerRowView component. For more information please read StorytellerListViews.
  • added the StorytellerGridView component. For more information please read StorytellerListViews.
  • added the Storyteller object. For more information please read Storyteller.

5.0.2 - 08/12/21#

  • updated the Storyteller iOS SDK to version 5.0.0 - see the main release notes for more details
  • updated the Storyteller Android SDK to version 5.0.2 - see the main release notes for more details

Deprecations and Changes:

  • removed the deprecated cellScale property from the Storyteller component

New Features:

  • added the new categories and categoriesToPreload properties to the Storyteller component

0.9.3 - 06/10/21#

  • Initial Release