Advertising sustains the DA. Ads are hidden for members. Join today

On this page

Configuration overview

Last updated on
4 July 2022

A single form across multiple sub-modules

The sub-modules provide their own configuration by extending the main configuration form. The module's configuration form is available under the following menu structure:

Configuration > Media > Cloudinary

Connect your Cloudinary account

This is a part of Cloudinary SDK module. To set up a connection you need to get credentials from the Cloudinary console on http://www.cloudinary.com/console and fill in the form the following values

  • Cloud name
  • API Key
  • API Secret

Besides, you can change API endpoint to use the data center from Europe or Asia if the majority of your users are located there.

https://api.cloudinary.com  (US-based data centers)
https://api-eu.cloudinary.com  (Europe-based data centers)
https://api-ap.cloudinary.com  (Asia-based data centers)

This is a premium feature that is supported only for our Enterprise plans and must be arranged when the account is created. Contact support for more information.

Besides, you can set up CNAME to change the default delivery URL from https://res.cloudinary.com to your custom one. The accepted value is the hostname without the URL schema.

Private CDN distributions and CNAMEs are available only for Cloudinary's Advanced plan and higher, and require a small setup on Cloudinary's side. An HTTPS-enabled CNAME also entails an additional cost. Contact us for more details.

Media library widget settings

This is a part of Cloudinary media library widget module. Follow the link to check all available settings for the media widget. The following settings are available out of the box.

  • Starting folder is used to set up the default folder when you open the media library widget.
  • SAML Authentication is used to perform automatic SSO login via SAML for the specified username.

Starting folder will be populated with more options once you've set up API connection.

Optimizations

Default optimizations are used as the default transformation parameters for the image or video.

Default optimizations for image are not applied for image styles as you can set up transformations on the image style level.

The allowed values are one or more comma-separated transformation parameters in a single URL component, or a set of chained transformations in multiple URL components (separated by slashes). For instance:

c_scale,w_1920/f_auto/q_auto

Responsive breakpoints

By default, the responsive images are not used, but you can change this behaviour by using your own responsive breakpoints. For instance:

480, 768, 992, 1200, 2000, 4000

The srcset attribute for auto-generated images will be used. Find out more details by checking the following article.

Responsive images are applied based on Device Pixel Ratio (DPR). For instance, if your DPR is 2.0, the 2x bigger image will be used for the breakpoints.

Video playback

This is a part of Cloudinary video module. By default HTML 5 Player is used. You can change the default player to Cloudinary Video player.

Each video player has an additional configuration field.

  • Default HTML5 player configuration accepts attributes separated by space. Find out all available video player attributes here.
  • Default Cloudinary player configuration (JSON) accepts a JSON object.

Default Cloudinary player configuration (JSON)

Check available player options here, or use the Video Player studio to try out different configurations.

Help improve this page

Page status: No known problems

You can: