GuidesAPI ReferenceRelease Notes
HomeLog InHome
Guides

React Native SDK release notes (historical)

Historical Experiences SDK release notes for React Native, 2026 onward. For current releases, use the latest published release notes. For 2025 and earlier, see React Native SDK release notes (historical, 2025 and earlier).

1.20.0 - React Native

Date: 2026-07-30

Breaking changes

  • The Moments tabs bar now collapses when a container has zero or one visible tabs. Set isTabTitleVisibleWhenSingleTab: true on BlazePlayerTabsStyle to keep it visible. See Widgets React Native.
  • Renamed ForYou.promotedLabels to coldStartLabels on BlazeRecommendationsType. There's no alias. See DataSource: React Native.

Added

  • isTabVisibleWhenEmpty to BlazePlayerTabsStyle to keep or automatically remove a Moments tabs tab whose content is empty or fails to load. See Widgets React Native.
  • activeTabIndicator to BlazePlayerTabsStyle for an underline indicator under the active tab's title. See Widgets React Native.
  • composite to BlazeDataSourceType to merge multiple data sources into one deduplicated feed, with per-source isMandatory. See DataSource: React Native.
  • widgetRemoteIdentifier to all widget views for remote Widget Builder control of layout, data source, and per-item style overrides. See Widgets React Native.
  • widgetId to all widget views to supply your own per-instance widget identifier. See Widgets React Native.
  • captions, using BlazeCaptionsStyle, to the Videos, Moments, and Stories player styles for caption font and on-screen position. See BlazeMomentsPlayerStyle and BlazeStoryPlayerStyle.
  • captions to BlazeStoryPlayerButtonsStyle and BlazeMomentsPlayerButtonsStyle to style or hide the CC toggle button. See BlazeStoryPlayerButtonsStyle and BlazeMomentsPlayerButtonsStyle.
  • Programmatic Moments tabs reload: reloadAllTabs(), reloadNonActiveTabs(), reloadTab(at:), and reloadTabByContainerId(). Per-tab reload is iOS only. See Methods: React Native.
  • videosFilterParams to the Videos entry points and widgets for content-type and stream-state filtering, plus startTimeDesc and startTimeAsc ordering. See Methods and parameters: React Native.
  • forceLayoutDirection, either 'ltr' or 'rtl', to InitOptions to force the SDK's screens into a layout direction at initialization. See Getting started React Native.
  • onShareClicked to BlazeBasePlayerDelegate, delivering BlazeShareParams including the new extraInfo. See Player Entry Point Delegate: React Native.
  • sdkMetadata to BlazeOnTriggerCustomActionButtonParams, exposing SDK-populated data on custom action button clicks. See Player Entry Point Delegate: React Native.
  • ads.enablePreroll to BlazeStoriesPlaybackConfiguration to play a configured ad on the first unread page as a pre-roll. See Methods and parameters: React Native.
  • overlayVisibilityThresholdMs to BlazeVideosPlayerStyle to control how long the Videos controls overlay stays visible.
  • borderColor and borderWidth to BlazeMomentsPlayerCtaStyle, BlazeStoryPlayerCtaStyle, and BlazeVideosPlayerCtaStyle as a fallback CTA border when the CMS provides none. See BlazeMomentsPlayerCtaStyle and BlazeStoryPlayerCtaStyle.
  • shouldPreserveLikesCountBelowThreshold to BlazeMomentsPlayerButtonsStyle to keep or collapse the space below the like button. See BlazeMomentsPlayerButtonsStyle.
  • multiAspectRatio on BlazeVideosPlaybackConfiguration is now optional and follows the native default, which changed to true. See Methods and parameters: React Native.
  • iOS only: backToLiveButton, statusIndicator, and waitingRoomMessage styling to BlazeVideosPlayerStyle.

1.19.0 - React Native

Date: 2026-06-18

Added

1.18.0 - React Native

Date: 2026-04-23

Added

Story player: title image

A contextual image can be displayed alongside the story title in the player header. See more.

New public types: BlazeStoryPlayerTitleImageStaticSource, BlazeStoryPlayerTitleImageSource, BlazeStoryPlayerTitleImageStyle.

Updated public types: BlazeStoryPlayerTitleTextStyle (added optional image property).


1.6.1 - React Native

Date: 2026-03-12

Android

Breaking changes

  • Replaced ctaVisibility ({ type: "alwaysVisible" } / { type: "visibleAfterOverlayHidden", duration }) with a simple isVisible?: boolean on BlazeVideosPlayerCtaStyle

Added

  • Added Chromecast support for Videos player: casting field in BlazeVideosPlayerButtonsStyle, stopActiveCastingSession() method, and setCastingDelegate() for casting state change events
  • Added Picture-in-Picture support for Videos player: pictureInPicture field in BlazeVideosPlayerButtonsStyle, BlazePipConfiguration with enterPipOnAppBackground, stopActivePiPSession() / isPiPActive() methods, and setPipDelegate() for PiP state change events
  • Added Moments auto-advance: BlazeMomentsPlaybackConfiguration with loopBehavior (infiniteLoop / loopAndAdvance) prop on Moments widgets, plus setDefaultMomentsPlaybackConfiguration() / getDefaultMomentsPlaybackConfiguration() methods
  • Added showSearchScreen(options?) method with optional suggestionsDataSource
  • Added search button to BlazeMomentsPlayerButtonsStyle
  • Added seekForward / seekBackward buttons to BlazeMomentsPlayerButtonsStyle and BlazeVideosPlayerButtonsStyle
  • Added setPreferredLanguage() / getPreferredLanguage() methods for text localization (content language preference). Supported starting with this version. See Text localization.
  • Added BlazeDataSourceType.Search for free text content search. Supported starting with this version. See Free text context search methods.
  • Added disableAnalytics method to stop analytics collection while keeping event callbacks and content delivery
  • Added promotedLabels to BlazeRecommendationsType.ForYou
  • Added appendMomentsToPlayer() method to append content to an already-open moments player
  • Added playbackModificationHandler callback to modify the playback URL before video starts
  • Added isVisible field to CTA style for Stories and Moments players
  • Added captions button to BlazeVideosPlayerButtonsStyle
  • Added forceRotation button to BlazeVideosPlayerButtonsStyle
  • Added entryContentId parameter to entry point methods (playVideos, playVideo, etc.)
  • Added BlazeVideosPlaybackConfiguration for video widgets and playback methods
  • Added setDefaultVideosPlaybackConfiguration() / getDefaultVideosPlaybackConfiguration() methods
  • Added followEntity to BlazeMomentsPlayerStyle
  • Added visibilityCondition for custom action buttons: show/hide based on content metadata conditions (exists, equals, in, range, and/or/not)
  • Added BlazeExtraInfoKeyPreset enum for accessing content metadata keys

Improved

  • Added accessibility support
  • Improved video caching performance

iOS

Breaking changes

  • Raised minimum iOS deployment target to 15.0
  • Replaced ctaVisibility ({ type: "alwaysVisible" } / { type: "visibleAfterOverlayHidden", duration }) with a simple isVisible?: boolean on BlazeVideosPlayerCtaStyle

Added

  • Added AirPlay support for Videos player: casting field in BlazeVideosPlayerButtonsStyle, stopActiveCastingSession() method, and setCastingDelegate() for casting state change events
  • Added Picture-in-Picture support for Videos player: pictureInPicture field in BlazeVideosPlayerButtonsStyle, BlazePipConfiguration with enterPipOnAppBackground, stopActivePiPSession() / isPiPActive() methods, and setPipDelegate() for PiP state change events
  • Added Moments auto-advance: BlazeMomentsPlaybackConfiguration with loopBehavior (infiniteLoop / loopAndAdvance) prop on Moments widgets, plus setDefaultMomentsPlaybackConfiguration() / getDefaultMomentsPlaybackConfiguration() methods
  • Added showSearchScreen(options?) method with optional suggestionsDataSource
  • Added search button to BlazeMomentsPlayerButtonsStyle
  • Added seekForward / seekBackward buttons to BlazeMomentsPlayerButtonsStyle and BlazeVideosPlayerButtonsStyle
  • Added setPreferredLanguage() / getPreferredLanguage() methods for text localization (content language preference). Supported starting with this version. See Text localization.
  • Added BlazeDataSourceType.Search for free text content search. Supported starting with this version. See Free text context search methods.
  • Added disableAnalytics method to stop analytics collection while keeping event callbacks and content delivery
  • Added promotedLabels to BlazeRecommendationsType.ForYou
  • Added appendMomentsToPlayer() method to append content to an already-open moments player
  • Added playbackModificationHandler callback to modify the playback URL before video starts
  • Added isVisible field to CTA style for Stories and Moments players
  • Added captions button to BlazeVideosPlayerButtonsStyle
  • Added forceRotation button to BlazeVideosPlayerButtonsStyle
  • Added entryContentId parameter to entry point methods (playVideos, playVideo, etc.)
  • Added BlazeVideosPlaybackConfiguration for video widgets and playback methods
  • Added setDefaultVideosPlaybackConfiguration() / getDefaultVideosPlaybackConfiguration() methods
  • Added followEntity to BlazeMomentsPlayerStyle
  • Added visibilityCondition for custom action buttons: show/hide based on content metadata conditions (exists, equals, in, range, and/or/not)
  • Added BlazeExtraInfoKeyPreset enum for accessing content metadata keys

Improved

  • Added accessibility support
  • Improved content and HLS prefetching performance
  • Improved video caching performance

1.5.4 - React Native

Date: 2026-02-02

Fixed

  • Updated requiresMainQueueSetup() to return false

Did this page help you?