Changelog#

10.13.2 - 2025.12.1702#

Improvements#

CSS formatting improvements

10.13.1 - 2025.12.1701#

Improvements#

The logic for updating the hash on Clip navigation now relies on the location pathname instead of the default history API behaviour (which uses base HTML elements if provided)

10.13.0 - 2025.11.2601#

New Features#

Add stNextClipCategories KVP to integrating app custom targeting
Added row.startPadding and row.endPadding theme properties to add padding to a row that should be flush with the container on scroll
Support for the "Between Pages" ad strategy
Ad events now include an "Ad Strategy" field
Added support for additional action types (linking to Stories, categories, Clips, and Collections)
AAds between Stories now display even when a Story is skipped

Deprecations#

Deprecated theme.storyTiles.title.show property in favour of a value that can be set in the CMS. Starting from this version, this Theme property has no effect. Default value for the CMS property is true.
Ad KVPs now match the mobile SDKs (collection was renamed to stCollection, clipCategories was renamed to stClipCategories, and so on)

Improvements#

Added a retry button when a Clip or Story fails to load, replacing the infinite spinner
If a row doesn't have a set height, it now defaults to a minimum height
Improved focus outlines on row and grid items
Removed pause button over image Clip ads
Non-AMP ads in Clips no longer show pause/play controls since they cannot be paused
Previous and Next Story buttons remain enabled when read/unread status is disabled for a row

Bug Fixes#

Fixed a bug where ad placement didn’t consistently account for buffer logic
Initial ad index now properly accounts for the previous Story’s pages

10.12.10 - 2025.11.2601#

Bug Fixes#

Fixed a bug with inconsistent loading of Stories after deleting pages or updating their targeting

10.12.9 - 2025.11.1101#

Bug Fixes#

Fixed a bug with inconsistent loading of live Stories when some theme properties are not set

10.12.8 - 2025-10.30#

Bug Fixes#

Fixed a bug where it was possible for the wrong CTA to show under Stories ads after navigating back and forth

10.12.7 - 2025-10-24#

Improvements#

Added a showScrollIndicator theme property to hide/show scroll arrows in Stories/Clips rows

10.12.6 - 2025-10-23#

Bug Fixes#

Fixed a bug where it was possible for the current category analytics property to be empty in Stories rows with multiple categories

10.12.5 - 2025-10-08#

Bug Fixes#

Fixed a bug where it was possible for the "actionButtonTapped" event not to get triggered for actions that open in a new tab

10.12.5 (alpha.3) - 2025-09-24#

Improvements#

Fixing generation of .d.ts files

10.12.5 (alpha.2) - 2025-09-23#

Improvements#

Fixed a bug where tile size could grow for round tiles when storyTiles.title.show was set to false

10.12.5 (alpha.1) - 2025-09-19#

Improvements#

Further improvements to support for some CMPs

10.12.5 (alpha.0) - 2025-09-12#

Improvements#

Improving support for some CMPs

10.12.4 - 2025-08-25#

Bug Fixes#

Fixed an issue with the Clips player size on some Android devices

10.12.3 - 2025-08-22#

Bug Fixes#

Improved the auto-advance behaviour of non-AMP ads in Firefox and Safari

10.12.2 - 2025-08-14#

New Features#

Introduced an initial index for the betweenStoriesAndPages and betweenClips ads strategies, that will be the index after which the first ad will appear. Can be configured in the CMS.

10.12.1 - 2025-07-22#

Improvements#

Added clipShares as a supported disabledFunctionalFeatures value in tracking preferences. For details, see the Privacy and Tracking documentation

10.12.0 - 2025-07-17#

Improvements#

Introduced disabledFunctionalFeatures option in tracking preferences. For details, see the Privacy and Tracking documentation
Setting the user ID to null is now supported
Introduced enableRemoteViewingStore option in tracking preferences. For details, see the Privacy and Tracking documentation
The recentStoryPlaybackMode is now only saved to local storage if needed for analytics
Stopped storing user attributes when the enablePersonalization tracking preference is set to false
Removed unused settingsSavedDate local storage item

10.11.1 - 2025-06-20#

Improvements:

Removed quiz share button from OneBox stories

10.11.0 - 2025-06-19#

Breaking changes:

Implemented VPPA compliance measures including SHA256 hashing for User IDs for requests and removal of Content ID from ad requests. See Privacy and Tracking for details.
Deprecated Storyteller.currentUserId method as part of privacy enhancements.
Added enableFullVideoAnalytics property to eventTrackingOptions for granular video analytics control. See Privacy and Tracking for details.

Improvements:

Improved VPPA compliance by removing direct user identifiers from various API requests. See Privacy and Tracking for details.
Added support for sheet actions in Clips.

10.9.1 - 2025-06-02#

Improvements:

Moved some dependencies to devDependencies

10.9.0 - 2025-04-02#

Features:

Added the enableAdTracking property to eventTrackingOptions

Improvements:

Non-AMP ads are now supported in Clips as long as they are based on a Storyteller template
Better tracking pixels support in Clip ads

10.8.0 - 2025-03-07#

Improvements:

The instructions screen is now only shown when opening a Story from the row (not when a Story is opened directly from its URL)
The gradient behind the Story/Clip titles on rectangular tiles is now shown by default (it can be hidden by setting storyTiles.rectangularTile.showGradient to false)
Better support for non-AMP ads

10.7.2 - 2025-01-23#

Improvements:

The instructions screen is now only shown once instead of once per Stories row/grid

10.7.1 - 2025-01-17#

Bug Fixes:

Fixed a Safari iOS bug where it was possible for the borders of round thumbnails to disappear
Fixed a bug where it was possible for some necessary events not to get reported to Storyteller
Fixed a bug where it was possible for a Story row to not be clickable after opening a Story from its share link

10.7.0 - 2025-01-06#

New Features:

Added #stories/[STORY_ID], #clips/[COLLECTION_ID], and #clips/[COLLECTION_ID]/[CLIP_ID] routes
Added support for reloading Stories and Clips views when exiting the player
The eventTrackingOptions property can be used for customising the analytics and tracking behavior

Improvements:

The behaviour and signature of the open* methods now match the native SDKs:

openStory is now async
openStoryByExternalId is now supported
openPage is now async
openCategory is now async
openClip is now deprecated (please use openCollection instead)
openCollection is now async and accepts a destination argument with either a Clip ID or Category ID
openClipByExternalId is now supported

Bug Fixes:

Fixed a bug with linking to a Story not present on the page when player.playAllStories theme property was set to false
Fixed a bug where it was possible for the default basename of a view could be empty if no data-base-url was set
Fixed a bug where it was possible for the Collection ID param of shared Clips to be empty

10.6.0 - 2024-12-17#

New Features:

Added userNavigatedToApp method to the Storyteller delegate

Improvements:

Added default custom targeting values to integrating app ad requests

10.5.3 - 2024-12-09#

Improvements:

Added accessible labels to button elements

10.5.2 - 2024-11-27#

Improvements:

Removed calls to deprecated Storyteller internal endpoint

10.5.1 - 2024-11-15#

Bug Fixes:

Fixed a bug where it was possible for some Stories not to autoplay on iOS

10.5.0 - 2024-11-14#

New Features:

Added support for ads in the Clips Player
Added support for "Share media" actions
Added support for enableViewedOrdering in a Clips collection

Improvements:

Improved focus behaviour for the Story player navigation buttons
Grid thumbnails now use the highest quality asset based on their size
Added support for Storyteller ads with no actions
Mobile CTAs are now aligned to the center by default
Improved Story transitions and loading styles
Improved full screen styles on mobile
Added documentation for Clip events
Improved error handling when initialising Storyteller rows in container with invalid IDs

Bug Fixes:

Fixed a bug where it was possible for iOS/Android specific actions to show in desktop browsers
Fixed a bug where it was possible for some progress bars to experience a delay in loading
Fixed a bug where it was possible for the OpenedStory, SkippedStory, DismissedStory, and DismissedClips events to not get recorded in some cases
Fixed a bug where it was possible for a previously paused Story to be paused on reopen
Fixed a bug where it was possible for an unread Story to be skipped by using the keyboard arrows
Fixed a bug where it was possible for the audio of a previous Story to play over the current Story when using the keyboard to navigate
Fixed a bug where it was possible for the like state of a clip to be inaccurate in some cases
Fixed a bug where it was possible for the swipe up gesture to not open the CTA destination

10.4.11 - 2024-09-20#

Improvements:

User attributes now automatically get cleared when a new API key or user ID is provided

Bug Fixes:

Fixed a bug where it was possible for the "New" chips to be visible on Stories with read/unread ordering disabled

10.4.10 - 2024-09-06#

New Features:

Added the player.disableUrls and clipPlayer.disableUrls theme properties

Improvements:

Updated the logic for generating unique ad requests correlators

10.4.9 - 2024-09-03#

New Features:

Added support for image titles in clip collections

Improvements:

Increased cases where the unmute state is persisted in Chromium browsers

10.4.8 - 2024-08-23#

Bug Fixes:

Fixed a bug where it was possible for the Storyteller delegate to not be writeable after the first initialization

10.4.7 - 2024-08-19#

Bug Fixes:

Fixed a bug with the formatting of the ads targeting object

10.4.6 - 2024-08-16#

Improvements:

Fall back to navigator share API (if available) if the provided onShareButtonTapped function returns null or isn't a Promise

10.4.5 - 2024-07-30#

Improvements:

Pinned Stories now use the same styles as Live Stories (to match the native SDKs)
clipActionText and clipActionUrl properties are now recorded for Clip events
Improved error handling when an invalid container ID is supplied

Bug Fixes:

Fixed a bug where it was possible for the completedStory event not to be recorded if a Story was already read
Fixed a bug where it was possible for the category update of an existing Story row to lead to a console error

10.4.4 - 2024-07-26#

Improvements:

Updated the correlator in ads requests URLs so that it's always unique

10.4.3 - 2024-07-17#

Improvements:

Updated the ads algorithm to keep requesting ads for a Story even if a previous request failed

Bug Fixes:

Fixed a bug where it was possible for overflow to be disabled when closing the Story player using the browser back button

10.4.2 - 2024-07-03#

Bug Fixes:

Fixed a bug where it was possible for 1st-party ads to be requested from the wrong endpoint

10.4.1 - 2024-06-28#

Bug Fixes:

Fixed a bug where it was possible for a read Story to be shown as unread when new pages were just added but the assets were still processing

10.4.0 - 2024-06-27#

Improvements:

Replaced the liveChip.textColor theme property with liveChip.readTextColor and liveChip.unreadTextColor
Replaced the storyTiles.liveChip theme properties with storyTiles.rectangularTile.liveChip and storyTiles.circularTile.liveChip
Added support for live clips in browsers that don't support HTTP Live Streaming

Bug Fixes:

Fixed a bug where it was possible for the live chip inside the Clips player to use the default styles instead of the custom theme
Fixed a bug where it was possible for the live chip inside the Stories player to use the default styles instead of the custom theme

10.3.6 - 2024-06-20#

Improvements:

Updated the ads logic to keep fetching ads for a Story even if a previous request failed

Bug Fixes:

Fixed a bug where it was possible for the first ad in a Story to appear a page later than the provided frequency

10.3.5 - 2024-06-18#

Improvements:

Added support for some cookie banners that clear or update local storage when dismissed

10.3.4 - 2024-06-13#

Bug Fixes:

Fixed a bug where it was possible for the round Story cells to remain empty on Safari iOS 16.4 and below

10.3.3 - 2024-06-07#

Improvements:

Updated the maximum lines of the round Story cells titles so they adapt to the chosen line height

10.3.2 - 2024-06-06#

Bug Fixes:

Fixed a bug where it was possible for the round Story cells borders to get cropped
Fixed a bug where it was possible for the round Story cells borders colours to not reflect the read/unread state

10.3.1 - 2024-05-31#

Improvements:

Improved console error logs when no Clips or Stories available
Improved mouse scrolling experience for Clips on Firefox

Bug Fixes:

Fixed a bug where it was possible for the first Story in a view to skip pre-loading for tenants with a lot of Stories
Fixed a bug where it was possible for the ads action button destination to be displayed instead of the advertiser name if no advertiser name was provided

10.3.0 - 2024-05-15#

New Features:

Introduced first-party ads support
Introduced linear-gradient support for the round cell borders

Improvements:

Improved initialization errors
'New' chip are not shown on pinned Stories so as to match the native SDKs behaviors
The tappable area to pause the Clips player has been increased

Bug Fixes:

Fixed a bug where it was possible for a viewed clip to display the 'new' chip
Fixed a bug where it was possible for some of the buttons theme properties to not get applied
Fixed a bug where it was possible for Stories to get cropped on some tablet screens
Fixed a bug where it was possible for the Clips share amount to not persist on navigation

10.2.1 - 2024-05-02#

Bug Fixes:

Fixed a bug where it was possible for some of the instructions theme properties to not get applied

10.2.0 - 2024-04-10#

New Features:

Added the openCategory method to Story views
Added support for Clips read/unread ordering
Added support for Clips locales using Storyteller.User.setLocale

Improvements:

Removed Storyteller inline styles
Updated ad events to use seconds (not milliseconds) for consistency with other events
Clips players can now be closed by clicking on the background
Improved transition between clips on Safari for smoother experience
Adjusted the Story player to accommodate sticky elements like Smart App banners

Bug Fixes:

Fixed a bug where it was possible for the Story lightbox not to open
Fixed a bug where it was possible for the Story page to restart after sharing on Safari
Fixed a bug where it was possible for the Story progress bars to transition from their previous state upon reopening

10.1.3 - 2024-04-16#

Bug Fixes:

Fixed a bug where it was possible for the Story player to load indefinitely after closing the instructions screen

10.1.2 - 2024-04-03#

Bug Fixes:

Fixed a bug where it was possible for round story cells with hidden titles to be horizontally off-centre in Chromium browsers

10.1.1 - 2024-03-19#

Improvements:

If the lists.row.scrollIndicatorInlineAlignment theme property is set to outside and the row doesn't have enough items for the scroll indicators to be visible, the empty space where the indicator would normally sit has been removed

10.1.0 - 2024-03-08#

New Features:

The advertiser name property is now supported for AMPHTML ads
Stories now don't preload by default (this can be overridden using the configuration.preload property at the list level)
Added inline clips player component (StorytellerClipsPlayerView)
The Story rows scroll indicator can now be moved outside of the carousel using the lists.row.scrollIndicatorInlineAlignment theme property
The Story rows scroll indicator can now be horizontally aligned with the thumbnails (instead of the whole cell which includes the title) using the storyTiles.circularTile.scrollIndicatorBlockAlignment theme property
The thickness of round cells borders is now configurable using the storyTiles.circularTile.unreadStrokeWidth and storyTiles.circularTile.readStrokeWidth theme properties
Ad events are now recorded

Improvements:

Story players can now be closed by pressing the Esc button
Story players can now be closed by clicking on the background
Trying to initialize a Storyteller instance more than once will now throw an error
Clicking on an already answered quiz option now moves the user to the next page
OpenedReason now has additional possible values: tap and automaticPlayback
DismissedReason now has additional possible values: backgroundTapped, skippedFinalPage, completedFinalPage, and backTapped
The following enums used for building custom themes are now exposed: Alignment, ButtonAlignment, and TextCase
The IListConfiguration type is now exposed and can be used to set a list's configuration
Updated the type of IStorytellerDelegate to make the onUserActivityOccurred callback optional
Updated the type of IStorytellerDelegate to make customTargeting optional in getAdConfig
Grid thumbnails now use the most appropriate thumbnail size
The clip player now automatically pauses on tab change
If playAllStories is set to false and the next Story will be skipped, the next Story button is greyed out
Various improvements to the clip player transitions and experience
Various performance improvements to the Stories player on iOS
Various improvements to the loading states and transitions

Bug Fixes:

Fixed a bug where it was possible for the player not to pause when pressing the share button on Safari
Fixed a bug where it was possible for a Story page to get skipped after answering a poll
Fixed a bug where it was possible for the OpenedPage event not to get triggered
Fixed a bug where it was possible for the player to pause when a quiz question wasn't answered
Fixed a bug where it was possible for a previously opened Story to appear briefly when opening another Story
Fixed a bug where it was possible for Story audio to keep playing after the player was closed
Fixed a bug where it was possible for a Story to show a grey screen when navigating backwards or quickly
Fixed a bug where it was possible for the wrong OpenedReason to be recorded when opening a Story or Page
Fixed a bug where it was possible for clip players to be appended to the DOM more than once on SPAs
Fixed a bug where it was possible for the clip player back button to scroll users back to the top of the page
Fixed a bug where it was possible for poll results to clash with the background
Fixed a bug where it was possible for OneBox Stories not to autoplay in the Google app
Fixed a bug where it was possible for the live chip position to be wrong when the row titles were hidden

10.0.4 - 2024-02-02#

Bug Fixes:

Fixed a bug where it was possible for short image polls captions to overlap with the background

10.0.3 - 2024-01-31#

Bug Fixes:

Fixed a bug where it was possible for OneBox Stories not to send events analytics to Amplitude

10.0.2 - 2024-01-26#

Bug Fixes:

Fixed a bug where it was possible for OneBox Stories not to send engagement units events analytics

10.0.1 - 2024-01-10#

Bug Fixes:

Fixed a console error about navigator being undefined
Fixed a bug where the gradient behind the Story titles on rectangular tiles didn't respect padding preferences

10.0.0 - 2024-01-10#

New Features:

Added support for Clips
Introduced the configuration object for list views
Implemented tracking for ad events

Improvements:

Added support for instanceMethod and escapeKeyPressed in the analytics events' DismissedReason property
Added support for tap and automaticPlayback in the analytics events' OpenedReason property
Added isInitialized and isPlayerVisible properties to the global Storyteller instance
Added the dismissPlayer method to the global Storyteller instance
Added the enableEventTracking and disableEventTracking methods to the global Storyteller instance
Added the enableLogging method to the global Storyteller instance
Added IListViewDelegate type export
Moved the openPage and openStory methods from the list views to the global Storyteller instance
Renamed the onShareButtonClicked callback to onShareButtonTapped and moved it to the global Storyteller delegate
Renamed the onStoriesDataLoadStarted callback to onDataLoadStarted
Renamed the onStoriesDataLoadComplete callback to onDataLoadComplete
Renamed the onStoryDismissed callback to onPlayerDismissed
Moved the getAdConfig method to the global Storyteller delegate
Moved the onUserActivityOccurred callback to the global Storyteller delegate
Removed the tileBecameVisible callback
Removed the onError callback
Updated list views to derive their basename from their categories or collection
Improved dark mode support and default styles
Various performance and playback improvements

Bug Fixes:

Fixed a bug where the OpenedPage event did not fire on Stories with a single Page
Fixed a bug where the SkippedStory event did not fire when the final Page of a Story was skipped
Resolved playback issues on quizz Pages

8.9.4 - 2023-12-18#

Improvements:

Adding support for dark mode placeholders by using the lists.backgroundColor theme property to set the placeholder styles
Preventing Content Layout Shift when loading grid items

8.9.3 - 2023-12-08#

Improvements:

Adding title.show theme property to show/hide Story titles on all tiles
Removed circularTile.title.hide theme property

Bug Fixes:

Fixing a bug where it was possible for round Story tiles with hidden titles to get cropped

8.9.2 - 2023-12-01#

Bug Fixes:

Fixing a bug where it was possible for the player to load indefinitely after closing the instructions screen

8.9.1 - 2023-11-30#

Bug Fixes:

Adding TypeScript declaration file export to package.json

8.9.0 - 2023-11-22#

Bug Fixes:

Fixing a bug where it was possible for auto-advancing ads to not show a progress bar
Fixing a bug where it was possible for action buttons to open the wrong URL in Stories with multiple action buttons

8.8.7 - 2023-10-26#

Bug Fixes:

fixing a bug where it was possible for stories not to play when the instructions screen was hidden via the theme

8.8.6 - 2023-10-25#

Bug Fixes:

Fixing a bug where it was possible for OpenedStory events not to be fired in certain scenarios
Fixing a bug where it was possible for OpenedPage events not to be fired in certain scenarios
Fixing a bug where it was possible for PreviousPage events to be fired at an incorrect moment
Fixing a bug where it was possible for the story player to be incorrectly aligned on certain mobile browsers
Fixing a bug where it was possible for playback to stall on certain mobile browsers

8.8.5 - 2023-10-24#

Improvements:

Moving the Action button below the player on desktop
Reducing the size of the Action button on mobile browsers to reduce the chance of collision with content

8.8.4 - 2023-10-17#

Improvements:

Fixing the category query parameter

8.8.3 - 2023-10-13#

Bug Fixes:

Fixing a bug where it was possible for Current Category to be reported as empty

8.8.1 - 2023-10-12#

Improvements:

Fixing a bug where it was possible for externalId for Categories for Ads Targeting
Fixing a bug where it was possible for Current Category to be reported incorrectly for Analytics

8.8.0 - 2023-10-11#

New Features:

Adding fixed story order support
Adding pinned story support

Improvements:

Fixing Story navigation bugs
Fixing instruction page bugs
Adding missing title attribute in iframes

8.7.0 - 2023-10-05#

New Features:

Adding support for ads between pages

Improvements:

Adding SkippedPage Analytics Event
Adding CompletedPage Analytics Event
Adding Page Title to all events
Adding missing event properties
Updating Story Title display
Adding missing alt attributes
Fixing images aspect ratio errors

8.6.0 - 2023-09-20#

Improvements:

Removing the # from the URL when closing a Story.

Bug Fixes:

Fixing a muting/unmuting bug when going back into a Story.
Fixing errors coming from Google Ad Manager.

8.5.0 - 2023-08-17#

New Features:

Adding useGoogleWebStoryUrls parameter to StorytellerStoriesGridView

Improvements:

Reduced SDK budle size by 50%, leading to faster app performance.

Bug Fixes:

Fixing a bug where it was possible for the navigation arrows on desktop to not appear.
Fixing a bug where it was possible for Story transition animations to not appearing.
Fixing a bug where it was possible for Stories to fail to open when opened via a URL.

8.4.2 - 2023-07-31#

New Features:

Adding the ability to open a fully AMPHTML compatible version of stories when selecting an item from a StorytellerStoriesRowView

Bug Fixes:

In certain situations, the OpenedStory and OpenedPage events might not fire. This is now fixed.

8.4.1 - 2023-07-07#

New Features:

Allow the ability to set a theme on an individual StorytellerStoriesRowView or StorytellerStoriesGridView

8.4.0 - 2023-06-30#

Improvements:

Standardizing the behavior of quizzes with our native SDKs
Adding additional analytics properties

Bug Fixes:

Fixing a bug where it was possible for the "Share your Result" button on quizzes to be black in Safari
Fixing a bug where videos could fail to play if a user hadn't interacted with the browser
Fixing a bug where it was possible for a Page's sound to continue playing after the Story player was dismissed

8.2.0 - 2023-06-23#

New Features:

Adding support for Audience Targeting and Personalization - see Users for more information

Improvements:

Adding additional analytics properties

8.1.0 - 2023-06-01#

Improvements:

Internal state management and minor bugfixes

7.9.2 - 2023-04-17#

New Features:

Adding useGoogleWebStoryUrls parameter to StorytellerListView

7.9.1 - 2023-01-17#

Bug Fixes:

Fixing bug causing the skip story buttons to not appear on Safari

7.9.0 - 2023-01-16#

Improvements:

Add theme property to hide the gradient on rectangular thumbnails

7.8.5 - 2023-01-13#

Bug Fixes:

Stop the flash of images when coming back from swipe up

7.8.4 - 2023-01-12#

Bug Fixes:

Story player improvements

7.8.2 - 2022-12-13#

Bug Fixes:

Fixing bug where the PreviousPage event would not fire
Fixing bug where the SkippedStory event would not fire

7.8.1 - 2022-12-13#

Bug Fixes:

Fixing bug where the player would freeze when opened
Fixing bug where the PreviousPage event would not fire

7.8.0 - 2022-12-05#

Bug Fixes:

Ensuring circular live story border matches theme color
Improving loading behavior when opening stories

7.7.1 - 2022-11-09#

Bug Fixes:

Fixing font theme property
Fixing instructions.icons theme property

7.7.0 - 2022-09-28#

Improvements:

Allow quizzes to be rendered outside stories
Adding showWebStoriesIcon theme property

7.6.0 - 2022-09-23#

Bug Fixes:

Fixing bug where thumbnails would sometimes fail to load

Improvements:

Adding displayLimit to rows and grids
Exposing contentLength in user activity delegate callback

7.5.0 - 2022-08-29#

Bug Fixes:

Lazy load Story tile thumbnails
Fixing issue where the navigation buttons could disappear
Stop player going back 2 Stories when back button pressed

Improvements:

Improve caching for static assets

7.4.5 - 2022-08-22#

Bug Fixes:

Fixing bug with scroll indicator fade theming
Fixing bug when applying corner radius theme property

7.4.3 - 2022-08-17#

Bug Fixes:

Fixing quiz score placement when sharing disabled
Fixing bug where instructions screen took multiple clicks to dismiss

7.4.2 - 2022-08-17#

Bug Fixes:

Don't reorder Stories when player is closed
Fix NPM type definitions

Improvements:

Use simple HTTP Requests

7.4.1 - 2022-07-29#

New Features:

Adding openStory and openPage methods

7.4.0 - 2022-07-29#

New Features:

Support CommonJS and ESM

Bug Fixes:

Fixing live chip theme issues

7.3.5 - 2022-07-15#

Bug Fixes:

Don't show share results button if share API not available
Fixing bug when returning from swipe up
Make sure externalApp swipe ups are recorded correctly

7.3.4 - 2022-07-13#

Improvements:

Improving support for older browsers

7.3.3 - 2022-07-11#

Bug Fixes:

Polls theme fixes

7.3.1 - 2022-07-08#

Improvements:

Make sure player Stories reorder when player closed

Bug Fixes:

Fixing corrupt svg console errors

7.3.0 - 2022-06-23#

Deprecation and Changes:

Removing showStoryTitle theme property
Adding showStoryIcon theme property

7.2.4 - 2022-06-20#

Improvements:

Improving open Story transitions
Hide Quiz share button when share buttons hidden

Bug Fixes:

Fixing issue with new indicator always showing on rectangular tiles

7.2.2 - 2022-06-01#

Bug Fixes:

Fixing issues with NPM type definitions

7.2.1 - 2022-05-31#

Bug Fixes:

Stop scroll to top when player closed

7.2.0 - 2022-05-13#

Bug Fixes:

Fixing issues with NPM package

7.1.2 - 2022-05-12#

Improvements:

Updating package.json

7.1.1 - 2022-05-11#

New Features:

Added NPM support

7.1.0 - 2022-05-02#

New Features:

Added support for Live Stories

7.0.0 - 2022-04-07#

New Features:

Added support for Trivia Quizzes

Improvements:

Made implementing custom themes even easier

2.2.0 - 2022-03-23#

Improvements:

Hide share button on browsers that don't support navigator.share
Make externalId optional
Allow Ad frequency to be configured

2.1.0 - 2022-03-11#

Improvements:

Adjust tile height to fill parent container
Send pollAnswerId in analytics events
Send all properties to analytics endpoint

2.0.1 - 2022-02-16#

Bug Fixes:

Fixing Story Page issues

2.0.0 - 2022-02-09#

Improvements:

Adding Grid Layout
Theme updates

New Features:

Adding support for unread indicator gradient

1.17.1 - 2022-01-18#

Improvements:

Improving swipe behavior
Show navigation arrows on touchscreen laptops

Bug Fixes:

Stopping JSONParseErrors being thrown for empty responses
Fixing missing API key 401s

1.17.0 - 2021-11-19#

New Features:

Added full support for Categories
Added support for ads

1.16.0 - 2021-11-02#

New Features:

Added the ability to swipe down to dismiss a Story
Added the ability for share links to open a specific Page (instead of just the first Page in the Story)
Added a playAllStories option to the theme which will not exit the Story player when the user reaches the end of their unread Stories - but rather keep them in the Stories experience until they see every Story in the row

Bug Fixes:

Fixed an issue which could cause Polls not to display in certain scenarios

1.15.0 - 2021-10-22#

Improvements:

Hiding 'i' button when video fails to play

Bug Fixes:

Stop video failed to play message appearing when a video successfully plays

New Features:

Recording share success events

1.14.0 - 2021-10-21#

Bug Fixes:

Fixing bug where Poll answer percentages display incorrectly

1.13.0 - 2021-10-19#

Improvements:

Preventing background media from being cropped

1.12.0 - 2021-10-18#

Bug Fixes:

Using the correct value for storyReadStatus in analytic events
Fixing issue where Story titles are shared/duplicate sharing URLs are shared when tapping share button

Improvements:

Adding information about VotedPoll event to the docs
Updating to open Story immediately when tapping/clicking Story tile instead of showing loading spinners

1.11.0 - 2021-10-15#

Bug Fixes:

Fixing sharing instructions issues

1.10.0 - 2021-10-12#

Improvements:

Removes the border around buttons in the Story player

1.9.0 - 2021-10-07#

Bug Fixes:

Fixing bug where users can vote for a Poll more than once

1.8.0 - 2021-10-05#

Improvements:

Adding theme option to hide Story titles

Bug Fixes:

Persisting mute state throughout Stories
Fixing CORS issues

1.7.0 - 2021-09-24#

Bug Fixes:

Stopping the wrong Story from being shown briefly when opening a share link
Disabling the 'previous page' button on the first Page of the first Story
Fixing issue where Story row would not load on iOS 12

1.6.0 - 2021-09-23#

Improvements:

Always displaying the mute/unmute icon in player
Adding text property to onShareButtonClicked() delegated method
Allow 3 lines for the Story title when using circular tiles

Bug Fixes:

Fixing instructions screen layout and icons on desktop
Fixing issue with missing navigation arrows and black background when refreshing/arriving from shared link

1.5.0 - 2021-09-17#

Bug Fixes:

Stop player closing when navigating backwards
Sort all Story rows when player is closed
Stop player from continuing in background after being closed

New Features:

Adding share delegate method
Adding docs for share callback

Improvements:

Hide share button if navigator.share doesn't exist
Don't hide share button if onShareButtonClick callback is defined

1.4.0 - 2021-09-16#

Bug Fixes:

Fixing Poll styling
Fixing ad overlay appearing over Story view

1.3.0 - 2021-09-09#

Bug Fixes:

Fixing desktop player not pausing on share
Fixing left scroll arrow
Only show read Stories and fix player opening unexpectedly
Don't open player until correct Story has loaded
Fixing bug when opening same Story after dismissing it
Setting opacity on tile loading
Fixing style import
Hide mute/unmute text

New Features:

Adding tileLoading state to tiles

1.2.0 - 2021-09-07#

New Features:

Adding properties to row theme

Bug Fixes:

Fixing instruction icons

Deprecations and Changes:

Switch to using query string params instead of headers in API requests
Updating row theme docs

1.1.0 - 2021-09-02#

Bug Fixes:

Fixing Poll styling
Fixing ad overlay appearing over Story view