Get started with Media Optimizer

Cloudinary's Media Optimizer simplifies the process to optimize and deliver high-quality media with high performance, low latency and massive scalability.

Media Optimizer high-level view

Map your existing media storage to Cloudinary delivery endpoints and instantly enjoy the benefits of:

  • Smart media compression
  • On-the-fly optimization transformations
  • High-speed delivery via multi-CDN
  • Valuable insights into your media's performance

Watch this webinar to learn more about why media optimization is important and see Media Optimizer in action.

Webinar banner

For a complete overview of Media Optimizer and how it can help you to optimize the media on your site, see the Media Optimizer Overview. To get started quickly with Media Optimizer, follow these steps:

1. Contact us to create a Media Optimizer account

Contact us to chat with our sales team, who will then guide you through the process of creating your Media Optimizer account.

You will be asked to select the cloud name for your account. Pick a cloud name that's a good representation of your organization, application or website.

By default, the cloud name is used in your media delivery URLs, which take the form: https://<cloud_name><path to media>.

If you have an existing Cloudinary account with a Media Library that you want to continue to use, you need to have a separate cloud set up for Media Optimizer. This can be a new sub-account within your main Cloudinary account, if your account supports sub-accounts.

2. Log in and get to know your console

Once your Media Optimizer cloud has been set up, you can log in to your account, and familiarize yourself with the console. Use the links below to learn more about each of the pages:

  • Dashboard: See an overview of how your media is performing, including a scatter plot map of your assets based on their delivered quality and file size so you can identify areas of improvement quickly.
  • Transformations: Manage and create new transformations that you can apply to your assets.
  • Reports: Monitor and analyze quality, performance, bandwidth and other metrics.
  • Configuration: Set up Media Optimizer to work with your site by configuring your media sources, delivery profiles and mapping functions.
  • Settings: Manage your account, delivery, security, user and billing settings.

3. Create a media source

A media source defines where your media is stored and how to access it.

To create a media source:

  1. In the console, navigate to Configuration > Media Sources and click Add New.

    Add new media source

  2. Complete the form:
  3. Click Save.

4. Test your setup

Your media can now be delivered from its original location, through Media Optimizer, by replacing the base part of your media URLs with the default delivery endpoint, https://<cloud_name>

For example, if your cloud name is mycloud, given the path to the original media, you can see what the new delivery URL would be:

Media Source Path to Original Media Media Optimizer URL
With Programmable Media mapping function:

With Media Optimizer mapping function:

With Programmable Media mapping function:

With Media Optimizer mapping function:
rest/of/the/path + extension

Web Address
HTTP Proxy
AWS S3 s3://bucket_name/bucket_folder/
Google Storage gs://bucket_name/bucket_folder


  • The default delivery endpoint is defined in the default Media Optimizer delivery profile that is created when you create your first media source.
  • The default Media Optimizer delivery profile applies automatic format and automatic quality to all your media by default.
  • If you selected Cloudinary as your media source and you want to use Programmable Media transformations, you should edit the delivery profile, setting Mapping Function to Programmable Media.

    Mapping function selection

  • Only the first created media source is added automatically to the default Media Optimizer delivery profile. If you create another media source, you need to add it to the delivery profile manually.

To verify your configuration, enter the URL into a browser and check that it returns an image or a video. If you get an error, check out troubleshooting.

5. Deliver optimized media

Update the media URLs on your website to Media Optimizer delivery URLs, and start enjoying the performance benefits of optimized media immediately!

Original image of shoes Served from web address
186 KB (JPEG)
Optimize icon Image of shoes (served through Media Optimizer) Served through Media Optimizer
60 KB (AVIF)*

*Depending on your browser, you may see a different format and size.

In this example:

  • The original web address is:
  • The Media Optimizer account has cloud name demo-mo-docs.
  • The configured media source is of type Web Address with URI Base set to
  • The default Media Optimizer delivery profile is used.
  • The Media Optimizer delivery URL is therefore:

There's a lot more to learn about Media Optimizer, for example:

  • If you want to use a custom domain, rather than <cloud_name>, you can configure a domain and use this in your delivery profile.
  • If you are migrating from a platform that performs media optimizations, you can create a mapping function to avoid having to update every URL on your site manually.
  • If you want to customize the transformations applied to your media, you can create named transformations and add these to your delivery profile.

Head over to the Media Optimizer Guide for all the details.

✔️ Feedback sent!

Rate this page: