Repository navigation
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
CldVideoPlayerwithaspectRatioand atransformationobject orcropModedelivers 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 ownaspect_ratiocropped the video to the player's aspect ratio- a text overlay without a width or height,
transformation={{ crop: "fill", gravity: "auto" }}andcropMode="smart"failed to load
CldVideoPlayerwithaspectRatioandtransformation={[]}(an empty array) now loads its poster, asaspectRatiowithout 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. SetcropPadColoras 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.1Full 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)