Chrome Media Library Extension


The Media Library Extension is a Google Chrome extension that allows you to easily insert actual image files, or URLs of any asset type (videos, images, sprites, etc.) from your Cloudinary account directly into your CMS, PIM, website builder, or any other browser-based application. The selected image or asset URL is imported directly from your Cloudinary account into any text box or content area in the web application without the need to manually download and upload images, or look up asset URLs. The Media Library Extension also enables you to apply transformations to the images you import from Cloudinary, changing the visual appearance or resizing to support multiple devices, and delivering the images in the optimal format and quality.

With the Media Library Extension, users can import Cloudinary images to their large enterprise systems in a simplified, streamlined way while leveraging Cloudinary's powerful managing, editing, and optimizing capabilities.


  • Facebook and Instagram don't support importing Cloudinary images and asset URLs via the Media Library Extension.
  • Whether the Media Library Extension works with a specific app depends on the hosting website. If you encounter a website that prevents the extension from working, please contact our support.

Get started

Before you install the extension, make sure you have a Cloudinary account. You can start by signing up for a free plan. When your requirements grow, you can upgrade to a plan that best fits your needs.

Once you have your Cloudinary account, download and install the extension from the Chrome Extension Marketplace and pin the Media Library extension icon to your Chrome extension toolbar.


Once you complete the Media Library Extension installation and setup, you'll be able to access your Cloudinary account from within a content area of your Chrome browser to import a selected image or asset URL.

During setup:

  • You must enter your Cloudinary credentials.
  • You can optionally specify a folder that the Media Library will open when you launch the Media Library Extension.
  • You can optionally implement some of Cloudinary's powerful media enhancements to optimize or edit all the images you import using the Media Library Extension.

If your needs change, you can always go back and update your setup.

To set up or update the Media Library Extension settings:

  • Click the Media Library Extension menu item to open the dialogue box and fill out the following fields:

    Media Library Extension setup

    Cloudinary sync

    Enter your Cloudinary credentials here.

    Mandatory fields:

    Field Description
    Cloud name Enter the name of the Cloudinary cloud you want to connect to.
    API key Enter the API key (not the API secret) of the Cloudinary cloud you want to connect to.

    Click get credentials to access your credentials from your Media Library Dashboard.

    Account details example

    Optional field:

    Field Description Example
    Cloudinary folder path Specify which folder in your Cloudinary account the Media Library will open whenever you launch the Media Library Extension. If you don't specify a folder, the Media Library will open to the root directory. When working on ads for the summer_campaign with images and URLs located in the corresponding folder, setting the Media Library to open to the folder summer_campaign/ads saves the trouble of navigating to that folder every time an image is imported.

    Image optimization

    Transformations applied to a Cloudinary image URL generate a new, programmatically modified file based on the original with effects, cropping, and much more applied to meet your specifications.

    Optionally enter optimizations and transformations specifying how all the images imported via the Media Library Extension will be enhanced, optimized, and / or edited.

    Field Description
    Image format Select the format of the delivered image. (In most cases, Auto is the best option, allowing for Cloudinary's intelligent delivery to choose the fastest loading format while maintaining the best visual fidelity.)
    Image quality Select the quality of the delivered image. (In most cases, Auto is the best option, allowing for Cloudinary's intelligent delivery to choose the best quality compression level and optimal encoding settings, in order to produce an image with good visual quality while minimizing file size.)
    Image transformations Enter the transformation that will be applied to every image pulled into your application via the Media Library extension. For example, enter c_thumb,g_face,h_150,w_150,z_0.7 to resize the images you are importing as thumbnails with faces automatically centered.


    • Click see examples to learn more about how you can utilize Cloudinary's powerful optimizing and editing features via transformations, and to view a large variety of possible transformations that you can apply.
    • If you want to use a predefined transformation instead of specifying an Image transformation, you can apply a transformation preset to each image you insert. However, entering a transformation in setup has the advantage that the transformation you enter will be applied automatically to all images inserted using the Media Library Extension without the need to manually select a transformation every time you import.

Inserting Cloudinary images or asset URLs in content areas

The Media Library extension opens a compact version of the Cloudinary Media Library from which you can import selected images or asset URL into any content area.

The Media Library opens when you right-click in a content area, and then click either Insert an Asset URL (to insert a URL for an asset of any type) or Insert an Image (to import the actual image) from the Media Library extension menu.

Media Library extension right-click menu


  • An asset URL can be inserted into any text or rich content area. However, Insert an Image is only active in content areas that support images or rich content.
  • The Media Library Extension is disabled while browsing in Incognito mode.

From the Media Library, select an asset and click Insert from the toolbar.

Media Library widget

Media Library features

The compact version of the Media Library provides access to almost all of the same functionality that is available in the full Media Library in your account console. The following sections explain some of the features that might be relevant to you as you select images or asset URLs.

Advanced search

When importing an image or an asset URL, you can use the advanced search feature to help find the asset you are looking for throughout the entire Media Library.

The advanced search feature lets you search by filters such as tags, metadata, format, orientation, resolution, or (if supported for your account), even by image analysis characteristics, such as prominent colors, presence of faces, or image location.

Advanced search

For more details, see Advanced search in the Digital Asset Management guide.


When importing an image or an asset URL using the Media Library Extension, you might want to access an asset that is part of a collection that you created or was shared with you.

Collections are ad-hoc groupings of assets. Assets can be added to and from collections without affecting or moving the asset itself, and assets can be included in multiple collections. You can create your own collections (assuming you have the required permissions) or other Cloudinary users can share collections with you. You can also share collections with external stakeholders by sending a URL to a dedicated collection webpage, which is available to those with a link during an optionally specified date range.

Collections can often be a convenient way to group all assets that you might want to use on a particular project or campaign.

You can access collections from the Navigation button at the top left of the Connector pane.

Media Library collections

For more details, see Collection management in the Digital Asset Management guide.

Transformation presets

A 'Transformation Preset' is a pre-defined transformation that was created and saved by an administrator of your Media Library to optimize and edit original assets. The advantage of using a transformation preset is that you can be sure you are applying a transformation that works well and is approved and preferred by your team.

You can apply a transformation preset to the image you are importing via the Media Library Extension from the Asset management page of the library.

To apply a transformation preset to an imported image:

  1. Open the Asset management page by double clicking an image from the Media Library.
  2. Select the Transformation Preset you want to apply.
  3. Click Insert to import the transformed image.

Asset management page:

Asset management

For more details, see Transformation presets in the Digital Asset Management Guide.

Editing options

You might want to modify, edit, or customize an image to your liking before pulling it into the content area of your browser-based web application. The Media Library enables you to do this in two different ways:

  • Media editor: modify the actual image.

    Using the Media editor, you can crop and resize an image to suit your design, and save your changes to overwrite the original image. Then, you can select the changed image to insert in your content area.

    For more details, see Media editor in the Digital Asset Management Guide.

  • Transformation editor: create a copy of the original image with transformations applied while keeping your original image unmodified.

    Using the Transformation editor, you can apply image overlays, edits, transformations, and optimizations to a copy of an original image. You can preview the transformed copy, and when satisfied, click Insert to pull the image you generated into your content area.

    For more details, see Transformation editor in the Digital Asset Management Guide.

Navigate to either the Media editor or the Transformation editor by double clicking the desired image in the Media Library to open the Asset management page. From there, click Edit Image to open the Media editor or Transform to open the Transformation editor.

Related topics

Guide to Building the Ultimate E-Commerce Website

You may also want to take a look at Cloudinary's five-chapter Guide to Building the Ultimate E-Commerce Website. The guide includes suggestions by e-commerce and technical experts on how to build a versatile marketplace by selecting automated e-commerce and CMS platforms that help you create, modify, and deploy adaptable user experiences.

✔️ Feedback sent!

Rate this page: