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. Sign up to create a Media Optimizer account

Sign up for free to create your Media Optimizer account.


  • If you have an existing Cloudinary account not on an Enterprise plan, you currently need to set up a separate account for Media Optimizer. This requires a different email address for your login.
  • If you have an existing Cloudinary account on an Enterprise plan, contact our sales team to set up your Media Optimizer account if you want it to be added as a sub-account of your main Cloudinary account.

In the sign up form, select Media Optimizer from the product selection list.

We recommend that you edit the assigned 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>.

After you sign up, look out for the welcome email from Cloudinary and click the link inside to set your account as active.

2. Log in to your Media Optimizer account

The first time you log in to your Media Optimizer account, you'll be guided through a set of steps to determine:

  • Your main role - for us to provide you with the best user experience.
  • Your cloud name - giving you another opportunity to set your cloud name, if you didn't do so on sign up.
  • Your closest region - for fetching and delivering your media in the most efficient way. Select the location that is closest to your existing media storage and/or the majority of your users.

The initial Get Started with Media Optimizer screen gives you a chance to learn more about Media Optimizer concepts. From here, you can start configuring Media Optimizer, using the Configure Media Optimizer wizard.

Getting started page

You can access the Getting Started page at any time using the lightbulb icon on the main toolbar of the console. Getting started icon

3. Start configuring Media Optimizer

From the Get Started with Media Optimizer screen, click Start Configuring. There are two steps to the wizard:

Step 1. Create a media source

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

Complete the form:

  • Media Source Name: Enter a name for your media source.
  • Type: Select where your media is stored. You can choose from:
    • Web Address - fetch originals from a web-server
    • HTTP Proxy - fetch originals specified by any http/https URL
    • AWS S3 - fetch originals from your S3 bucket
    • Google Storage - fetch originals from your GS bucket
  • Enter details about your media source based on the type.

Step 2. Update your media URLs

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>

With the Scale plan you can set up your own custom domain.

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
Web Address
HTTP Proxy
AWS S3 s3://bucket_name/bucket_folder/
Google Storage gs://bucket_name/bucket_folder

Note: This structure can vary - learn more.

By default, Media Optimizer applies automatic format and automatic quality to all your media.

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.

4. 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)*

See the size and format for yourself using whatever media inspection tools your browser provides when you right-click on each image, or try the Cloudinary Media Inspector Chrome extension.

*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 Media Optimizer delivery URL is therefore:

5. Get to know your console

Use the links below to learn more about each of the pages in the console:

  • Dashboard: See an overview of how your media is performing, your usage and plan details.
  • 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.

Learn more about Media Optimizer

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

  • You can apply different transformations to different types of media using delivery profiles.
  • You can define more than one media source and add them to the same or different delivery profiles.
  • 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: