2.14.1 / 2026-02-05 ================== Update jquery.ui.widget.js from 1.12.1 to 1.14.1 2.14.0 / 2025-07-11 ================== 2.13.1 / 2024-04-04 ================== * Fix deprecated `jQuery.isArray` 2.13.0 / 2022-07-17 ================== New functionality and features ------------------------------ * Allow to disable b-frames for video codec (#284) * Add support for generating url with auth_token (#290) Fixes ------------- * Fix support for start offset and end offset parameters (#289) Other Changes ------------- * Remove links to nonexistent mapfiles in js folder (#283) * Update README 2.12.3 / 2022-01-06 ================== * Fix transparent video on safari 14.1 by using fetch instead of XHR (#282) 2.12.2 / 2022-01-03 ================== * Fix missing userAgent on Node.js (#281) 2.12.1 / 2022-01-02 ================== * Fix pictureTag arguments & add missing definitions (#278) * Fix image srcset passed as attribute (#277) * Fix transparent video on Safari (#280) 2.12.0 / 2021-10-10 ============= New functionality and features ------------------------------ * Add support for variables in text style (#271) Other Changes ------------- * Fix README.md npm package links (#272) * Refactor normalization of e_preview:duration (#270) 2.11.4 / 2021-04-25 ================== * Fix transformations with variable names containing predefined names (#265) * Fix responsive URL generation for zero width images (#206) * Fix incorrect readme text and broken links (#264) * Add test for context metadata as user variables (#266) 2.11.3 / 2020-09-30 ================== * Fix js/jquery.cloudinary.js es5 compatibility by removing arrow functions 2.11.2 / 2020-08-11 ================== * Fix typescript declarations (#257) 2.11.1 / 2020-07-26 ================== * Revert Fix lazy loading of responsive images (#253) 2.11.0 / 2020-07-26 ================== New functionality and features ------------------------------ * Add support for transparent video (#211) Other Changes ------------- * Fix lazy loading of responsive images (#253) * Fix signature param support in ie11 (#252) * Add test and pre commit hook to prevent js folder changes (#249) (#251) 2.10.3 / 2020-07-11 ================== * Fix bug where image width was set to 'null' for responsive images * Refactor tests configuration and folder structure 2.10.2 / 2020-07-08 ================== * Fix ie11 support by removing usage of string.repeat() (#247) 2.10.1 / 2020-07-06 ================== * Update analytics param to be urlAnalytics (#245) * Fix IE11 support by removing unsupported padStart function (#244) * Fix normalize() in jquery library used by server-side sdks * Fix title added to npm packages * Update travis configuration to test on node 8,10,12,14 (#241) 2.10.0 / 2020-07-01 ================== New functionality and features ------------------------------ * Add support for intersection detection. * Add support for placeholder and accessibility to url() function (#236) * Update responsive() to return a callback that removes the listener it adds Other Changes ------------- * Add SDK analytics signature to the URL (off by default) * Update tsconfig to only test types folder (#237) 2.9.0 / 2020-06-21 ================== New functionality and features ------------------------------ * Add support for OCR in transformation (#224) * Add support for POW operator Bug Fixes --------- * Fix fontAntialiasing type definition (#233) * Fix Transformation normalization for predefined variables * Fix Transformation normalization in browsers that do not support lookbehind in regular expressions (#228) * Fix bug where preview:duration was shortened to preview:du Other Changes ------------- * Update test descriptions (#223) * Update devDependencies packages * Remove CoffeeScript and Grunt mentions from readme (#222) * Remove unneeded file (#221) * Update issue templates (#218) 2.8.2 / 2020-03-25 ================== * Fix - Add signature to list of url keys so that extractUrlParams() won't filter it * Add test for package size using bundlewatch 2.8.1 / 2020-02-18 ================== * Fix spaces encoding of named transformations * Align responsive function with cloudinary_angular's lazy load * Add tests for special chars encoding in urls * Fix tests for video offset * Fix secure_distribution type definition * Add watch mode to tests * Refactor normalizeArray function * Update puppeteer to version 2.1.1 2.8.0 / 2019-11-24 ================== New functionality and features ------------------------------ * Add support for option to function (#198) Other Changes ------------- * Add npm package test (#187) * Fix lodash imports * Fix responsive and minified tests * Fix files list for npm package in 2.7.4 / 2019-08-18 ================== New functionality and features ------------------------------ * Add support for remote\local "pre" function invocation Other Changes ------------- * Fix responsive images in ie11 * Add pre release test for packages (#185) 2.7.3 / 2019-08-05 ================== * Fix cloudinary-core-shrinkwrap.js missing in release 2.7.2 / 2019-08-05 ================== * Fix cloudinary-react needed file not included in release * Update copy_deployment script 2.7.1 / 2019-08-04 ================== * Update copybuilds script 2.7.0 / 2019-08-04 ================== New functionality and features ------------------------------ * Feature/add video duration condition (#183) * Support force_version parameter to include default version when generating delivery urls (#173) * add support for antialiasing and hinting * Add support for custom functions * Add support of custom codecs in video tag (#161) Other Changes ------------- * Feature/configuration (#172) * Update webpack and karma configuration * Update npm scripts * Add deployment files under a single repository * Add pkg folder * Add copybuilds script * Add test for support of art:incognito effect (#168) * Update jsdoc version (#182) * Add duration to conditions in video (#178) * Fix layer cloning (#163) * Update inline documentation (#174) * Add `fontAntiAliasing` and `fontHinting` to TypeScript definition * Add `FetchLayer` to types * Fix TypeScript cloudinary import * Add default export definition to TypeScript * Bump lodash from 4.17.11 to 4.17.13 (#180) * Bump js-yaml from 3.12.1 to 3.13.1 (#177) * Fix/sample code (#170) * Bump package versions in samples 2.6.3 / 2019-04-02 ================== New functionality and features ------------------------------ * Add support for composite radius params Other Changes ------------- * Replace `object.assign` with `util.assign` (#169) * Escape quotes in html attributes (#166) * Remove Safari from automated tests * Fix test:all script * Implement isEmpty, isString and fix default function values * Update `.jshintrc to support ES6 * Add "join the Community" 2.6.2 / 2019-02-01 ================== * Use hardcoded list of method names. Fixes #153 * Use babel for development mode too * Add test:all script 2.6.1 / 2019-01-29 ================== * Fix ES6 modules 2.6.0 / 2019-01-28 ================== Note ---- Sources are now divided into JavaScript modules. However we can't change the public API of the package or its structure, including the "main" property of the package.json file, without a major release. You can import cloudinary from the sources: ``` npm install cloudinary_js ``` ```js import cloudinary from 'cloudinary_js/src'; const cl = cloudinary.Cloudinary.new({cloud_name: 'demo'}); ``` The npm packages: * `cloudinary-core` * `cloudinary-jquery` * `cloudinary-jquery-file-upload` Are still used to distribute the bundled library. New functionality and features ------------------------------ * Add picture tag and source tag * Add support to `fps` transformation parameter (#139) * Replaced CoffeeScript with JavaScript * Refactor code as modules Other Changes ------------- * Fix Fetch layer * Remove grunt * Update TypeScript configuration * Remove PhantomJS and bower references * Fix HTML tag test * Fix fps test 2.5.0 / 2018-02-13 ================== New functionality and features ------------------------------ * Support SEO urls * Merge pull request #136 from ignatiusreza/lodash/diet * selectively import lodash to avoid bundling the whole lodash Other Changes ------------- * Update `package-lock.json` 2.4.0 / 2017-12-09 ================== New functionality and features ------------------------------ * Support fetch URL in layers * Support SEO suffix for private images Other Changes ------------- * Add documentation * Refactor `btoa`; Add POJO `isFunction` * Update Node version list to test; Remove env vars * Update dependencies and configuration * Fix CLOUDINARY_URL regex * Update npm installation instructions * Update dependencies 2.3.0 / 2017-03-27 ================== New functionality and features ------------------------------ * Add TypeScript typings for cloudinary-core (merging #120 and #122) Other Changes ------------- * Remove redundant script tags. * Add tests for gravity modes. * Restore cloud_name when chaining transformations (#116) * Add backward compatibility file * Fix broken conditional transformations based on order to transformation keys * Return node within loop so images is populated correctly (#119) 2.2.1 / 2017-03-15 ================== * Filter out `$attr` as a variable name - it is reserved in Angular 2.2.0 / 2017-03-14 ================== * Add **User defined variables**. * Add `callback` and `upload_preset` to configuration parameters 2.1.9 / 2017-01-02 ================== * Support ‘iw’ and ‘ih’ transformation parameters for indicating initial width or height (respectively) in `ImageTag` * Support responsive image tag in `ImageTag` 2.1.8 / 2016-12-12 ================== * Replace `$` with jQuery * Replace require 2.1.7 / 2016-12-04 ================== * Add Client Hints meta tag helper * Support public ID with special characters * Don't convert parameters to CamelCase * Remove using `@const` to avoid lint error on constant assignment * Edit instructions in README * Encode `|` and `=` in context values. * Merge pull request #110 from gvillenave/master * Fix the "delay" transformation URL code 2.1.6 / 2016-10-26 ================== * Change client hints behavior. Fixes #107. * Remove dependency on 'jquery.ui' Fixes #104. 2.1.5 / 2016-10-10 ================== * Refactor `grunt version` * Test width value 'ow' and height value 'oh' * Update documentation * Merge branch 'dpr_auto' * preview URL shows dpr_1.0 when setting DPR to auto * Re-introduce the copy:docs task * Guard for null or empty param in `cloudinary_update` and `processImageTags` as mentioned in #99 * Fix documentation for `processImageTags` as mentioned in #99 2.1.4 / 2016-10-06 ================== * Move `configuration` before `transformation` in build and test scripts. * Refactor Util. * Modify karma configuration to support coverage reporting. * Fix typo. * Make Layer classes support camelCase and snake_case parameters. Add Layer text. * Add `baseutil.js` as a common source for lodash and jQuery utils. * Fix Layer tests * Fix bug in `maxWidth` 2.1.3 / 2016-09-05 ================== * Add TravisCI label for npm, bower and license. * Add license file * Add missing `rmargin` variable. Fixes #76 * Fix README reference to `fileupload()` * Merge pull request #95 from crazile/patch-1 * Remove shorthand jQuery reference ($) * Update packages. 2.1.2 / 2016-07-16 ================== * Rename `short` to `shortName`. Fixes #73. 2.1.1 / 2016-06-30 ================== * Add TravisCI configuration * Allow browsers to be defined in commandline for karma runs. * Remove map reference created by the coffee compiler from distribution files. * Fixes cloudinary/pkg-cloudinary-core#6. * Fixes mileszim/ember-cli-cloudinary#3. 2.1.0 / 2016-06-22 ================== New functionality and features ------------------------------ * New configuration parameter `:client_hints` * Enhanced auto `width` values * Enhanced `quality` values Other Changes ------------- * Use duck-typing to set/get attributes. * Updated dependencies * Add `client_hints`, `width`, `quality` tests * Create spec-helper.coffee. Add `sharedExamples`. * Fix assets compilation issue with Cloudinary GEM cloudinary/cloudinary_gem#203 * Remove map reference in `js` folder. Fixes cloudinary/cloudinary_gem#199 2.0.9 / 2016-06-05 ================== New functionality and features ------------------------------ * Add structured overlay and underlay * Add `keyframe_interval` and `streaming_profile` transformation parameters Other Changes ------------- * Fix missing `cloudinary-jquery-file-upload.coffee.js.map` error. Fixes cloudinary/cloudinary_gem#199. * Don't overwrite `root.cloudinary` when initializing. Allows the cloudinary upload widget to be loaded before the JS library. Fixes #88 2.0.8 / 2016-03-22 ================== * Create local variables for `lodash` and `_` for the shrinkwrap version. * Add `face_count` and `page_count` to Condition. Use replace with callback to process condition. * Add `transformation-spec.js` to karma configuration * Add translation of parameter names in conditional transformation * Fix responsive tests * Update tests * Set default `responsive_use_breakpoints` instead of `responsive_use_stoppoints`. 2.0.7 / 2016-03-08 ================== New functionality and features ------------------------------ * Conditional Transformations * Set breakpoint steps to 100. Default `responsive_use_stoppoints` to `true` instead of `"resize"`. * Round up DPR by default. Add `round_dpr` configuration parameter. Other Changes ------------- * Add `Condition` class. Add `Transformation.if`, `Transformation.endif`, `Transformation.else`. * Use String.slice() instead of String.substring() * Update Grunt `build` task to not delete the lodash artifacts. Update `compile` task to not clean `jsdoc`. * Add `bootstrap` argument to `responsive()`. Support responsive_class in options (defaults to `cld-responsive`). * Add `Util.removeAttribute` * Add `item == null` to jQuery utils `isEmpty` 2.0.6 / 2016-02-15 ================== New functionality and features ------------------------------ * Support webpack, browserify * webpack example * Minified version of source * Shrinkwrapped core lib which includes a subset of the lodash functions Other Changes ------------- * Remove UMD constrcut from the individual source files. * Fix module references for NodeJS * Clone headers instead of modifying them. Fixes handling of multiple chunked uploads in parallel. * Rename `lodash-shrinkwrapped` to `lodash-shrinkwrap`. Fix documentation comments. * Update dependencies 2.0.5 / 2016-01-21 ================== * Update version number in backward compatibility library (no code changes) * Merge branch 'master' of https://github.com/cloudinary/cloudinary_js * Update README.md * Add IDEA files to gitignore * Merge pull request #71 from bradvogel/patch-2 * I think you mean this link? 2.0.4 / 2015-12-28 ================== * Create `namespace` folder. Move "`-full`" files to the new folder and rename them. * Make root module nameless. * Update dependencies and documentation of script tags. * Check if jQuery.fn.fileupload exists before executing related methods. Used for backward compatibility. Fixes #67 * Add test runner for source ("un-packed") AMD. * Don't use `file:` for Cloudinary URL. Modify resources URLs in the test files. * Remove `testWindow.removeEventListener handler` - it was causing the test to fail. * Fix reference to Configuration. 2.0.3 / 2015-11-30 ================== * Update backward compatibility files 2.0.2 / 2015-11-30 ================== * Bootstrap fileupload when loading the code directly. Required for backward compatibility. * Verify that cloudinary domain exists when defining the Tranfsormation class 2.0.1 / 2015-11-22 ================== * Version 2.0.1 * Fix Links in `README.md` * Fix responsive and dpr. * Create a web project for testing at `test/docRoot`. Add a bootstrap responsive html for tests. * Create a separate spec file for responsive tests. * Remove "old" from the JS link in `bootstrap.html` * Fix algorithm used to calculate container width 2.0.0 / 2015-11-10 ================== The version 2.0.0 release refactors the Cloudinary JavaScript library, and the biggest news is that the newly introduced Core Library is jQuery-independent. The source code has been converted into CoffeeScript and rearranged into classes, and a new build script based on Grunt has been added. The build process produces 3 artifacts: * A Core Library that is not dependent on jQuery * A jQuery plugin that includes the Core Library * A Blueimp plugin that includes the jQuery plugin and the Core Library In order to publish these libraries in bower and NPM, 3 new Github repositories have been created: +------------------------------------+-------------------------------+ | Repository | Package name | +------------------------------------+-------------------------------+ | pkg-cloudinary-core | cloudinary-core | | pkg-cloudinary-jquery | cloudinary-jquery | | pkg-cloudinary-jquery-file-upload | cloudinary-jquery-file-upload | +------------------------------------+-------------------------------+ The same package names are used in both bower and NPM. ## Backward compatibility The cloudinary-jquery-file-upload library is fully backward compatible with cloudinary_js library 1.0.25. The relevant Blueimp files will still be found in the `js` folder for backward compatibility. However if you rely on Blueimp files located in the repository's `js` folder, make sure to update your links to `load-image.all.min.js` which replaced the `load-image.min.js` from previous versions. We however encourage developers to utilize a dependency manager such as bower or NPM to install 3 party libraries and not rely on the files in the `js` folder. ## Details * Add lodash * Add Blueimp distribution files. * Replace `bower-*` repositories with `pkg-*`. * Update `devDependencies` in `package.json` * Fix files references in karma configuration files. * Add `load-image.all.min.js` , remove `load-image.min.js`. Fix `uglify` task. Add `copy:doc` task. Modify `build` task. * Add manually compiled Gruntfile. * Optimize bundles to build dir. Dynamically build grunt tasks. Rename files to match repositories. * Update documentation. * Replace "stoppoints" with "breakpoints". Prefix HtmlTag attributes with "html_". * Add format to documentation task. Fix documentation. Remove headers and footer. * Add template files to be used by jsdoc * Add grunt task to copy artifact to bower repositories * Define modules for namespaces. Modify grunt script. * Add requirejs tasks to grunt build file. * Add UMD to all sources. * Filter empty transformation values for the transformation parameter * Add aspect_ratio transformation * Update README * Update gitignore file; Add new API information to README; update npm dependencies * Split karma configuration * Remove lodash and jQuery references where they shouldn't be. * Don't fail on falsy public_id * Redefine `cloudinary` scope and secure it internally; Add documentation * Remove automatic configuration from Cloudinary class. Will be enabled in jquery flavor for backward compatibility. * Add utils.jquery * Define `Util` domain for utility functions * Return DOM from `Cloudinary.image()` * Convert specs to coffee * Add Karma runner to grunt. * Add Transformation chains * Change file paths in jasmine html files. * Replace '$' with jQuery * Move tags to separate folder. Add TODO.md. * Add uglify to grunt. * Add correct width algorithm. * Add node modules to the ignore file 1.0.25 / 2015-09-01 =================== * Add node_nodules to gitignore * Set innerText and textContent without using hasOwnProperty, in order to support IE and FF. Fixes #56 * Update README.md 1.0.24 / 2015-04-16 =================== * Re-fix issues lost in merge * Fix poster options. Edit Documentation. * Fix documentation * Use jQuery width for responsive for correct handling of padding * Support responsive_preserve_height configuration option * Support video tag generation * Add test for zoom. * Refactored range code. Updated dependencies. * Support resource_type and type parameters for cloudinary_fileupload 1.0.23 / 2015-03-22 =================== * Merge branch 'feat/video-support' * Add support for video * Add X-Unique-Upload-Id header to upload requests. Particularly useful for the upload_chunked endpoint * Increment version to v1.0.22: Support root path for shared CDN * Support root path for shared CDN 1.0.21 / 2014-12-11 =================== * support url_suffix and use_root_path for private_cdn URL building * Fix potential XSS vulnerability on cloudinary_cors.html * Upgrade to jquery.fileupload.js version 5.42.1 * Traverse ancestors in DOM to find clientWidth for responsive images * Reading use_root_path also from global config * Merge pull request #40 from zaption/xss-fix * Support domain sharding for https in res.cloudinary.com * Refactor tests * Merge pull request #39 from sl4m/responsive-image-width * Fix dpr cache to store by queue indexed by 1.0.20 / 2014-09-22 =================== * Fix issue #125 - find closest supported DPR value since zoom changes DPR 1.0.19 / 2014-07-14 =================== * Support for delete_by_token API call from the browser 1.0.18 / 2014-06-30 =================== * Responsive images support. Support passing cloud_name to unsigned_cloudinary_upload as part of upload_params hash. * Automatically update dpr according to real devicePixelRatio when building or updating image * Refactor generate_transformation_string. Add support for dpr parameter * Support supplying cloud_name as option to upload methods. Support supplying multiple in unsigned upload methods 1.0.17 / 2014-05-26 =================== * Add unsigned_cloudinary_upload 1.0.16 / 2014-05-12 =================== * fix url generation if secure is false in a secure page 1.0.15 / 2014-05-04 =================== * fix object encoding in unsigned upload * Merge pull request #29 from zvictor/master * fix non-fileupload code 1.0.14 / 2014-04-15 =================== * Rename unsigned_upload to unsigned_upload_tag * Support dynamically creating an unsigned_upload widget. Better absolutize for fetch urls * Merge pull request #27 from eroh92/patch-1 * fix invalid JSON 1.0.13 / 2014-03-25 =================== * fix trailing ',', add .jshintrc, fix named transformations * Bower manifest * Added bower.json, for registration. * Merge pull request #23 from aceunreal/master * Upating the webp image to ensure the webpify function handles Android 4.1.2 version * Better handling of fieldupload fields with multiple true * trust_public_id - allow keeping file extension that looks like an image extension * AMD support 1.0.12 / 2014-01-21 =================== * Updating links in jquery plugin definition * Merge pull request #20 from luxedigital/allow_to_override_protocol * Allow to set protocol using cloudinary config * Allow to specify a protocol * Fix tests follow change to secure urls under file:// change * Secure option overrides window.location.protocol 1.0.11 / 2013-11-04 =================== * Add color parameter support 1.0.11 / 2013-11-04 =================== * Binding jQuery file upload events * Bind other important events and expose to application * Update client size resize and validation instructions * Referring to cloudinary_angular in readme 1.0.11 / 2013-11-04 =================== * Escape public_ids even if not fetch 1.0.8 / 2013-07-30 ================== * Change secure urls to use *res.cloudinary.com