Skip to content

v7.1.1

Latest

Choose a tag to compare

@github-actions github-actions released this 17 Nov 19:57
· 2 commits to main since this release

Overview

This release fixes a regression in 7.1.0. When CldVideoPlayer had an aspectRatio and a transformation object or a cropMode, the delivered video could be different from 7.0.0, or fail to load. Those players now use exactly the same URLs as in 7.0.0.

The 7.1.0 poster fix is kept for players that use aspectRatio without a transformation or cropMode.

If you pinned 7.0.0 because of the 7.1.0 known issue, you can upgrade to 7.1.1.

Fixes

  • CldVideoPlayer with aspectRatio and a transformation object or cropMode delivers the same video as 7.0.0 (#676). In 7.1.0, for example:
    • transformation={{ width: 500 }} delivered a vertical (9:16) video at 500×280 instead of 500×888 (distorted)
    • transformation={{ crop: "fill" }} or the object's own aspect_ratio cropped the video to the player's aspect ratio
    • a text overlay without a width or height, transformation={{ crop: "fill", gravity: "auto" }} and cropMode="smart" failed to load
  • CldVideoPlayer with aspectRatio and transformation={[]} (an empty array) now loads its poster, as aspectRatio without a transformation already did in 7.1.0. The delivered video is unchanged.

Posters with aspectRatio and a transformation

As in 7.0.0, the poster doesn't load when aspectRatio is combined with a transformation object or array and no cropMode. This includes { effect }, { quality } and { width, height, crop: "fill" }, whose poster loaded in 7.1.0. A proper fix is tracked in #675.

Until then, either of these makes the poster load:

  • cropMode="pad" shows the whole video, with bars that fill the rest of the aspect ratio. Set cropPadColor as well, for example "black": without it, the poster's bars are white while the video's are black. The delivered video gets the padded dimensions (for example, 3414×1920 for a 1080×1920 video at 16:9).
  • cropMode="fill" crops the video (and poster) to the aspect ratio.

cropMode and cropPadColor aren't in the CldVideoPlayer types yet, so in TypeScript pass them like this:

<CldVideoPlayer
  src="<Your Public ID>"
  width="1080"
  height="1920"
  aspectRatio="16:9"
  transformation={{ effect: 'sepia' }}
  {...({ cropMode: 'pad', cropPadColor: 'black' } as object)}
/>

Upgrading

npm install next-cloudinary@7.1.1

Full changelog: v7.1.0...v7.1.1


7.1.1 (2026-11-17)

Bug Fixes

  • keep 7.0.0 CldVideoPlayer URLs when aspectRatio is used with a transformation or cropMode (83c7cf7)