By default, you would upload and store all files in your Uploadcare projects. Sometimes all files are already uploaded on the web, so there's an extra step to get them into your Uploadcare storage.
Media Proxy allows you skip this step so you can deliver your files via
Uploadcare CDN instantly. This way, you can integrate Uploadcare
into your solution with only minor image
src modifications and without moving
any files. The older links will still work. Also, you can use Image Transformations
and other features over this delivery mehtod.
By the way, Adaptive Delivery feature has Media Proxy under the hood. If you want to have an automatic workflow with minimal configuration, try Adaptive Delivery first. Continue to Media Proxy for a more manual approach.
Note: The feature is still in alpha, and therefore, it's not added to the Dashboard yet.
To start using Media Proxy, please contact our support and we'll process your request individually.
We'll generate a Proxy Endpoint (e.g.,
ucr.io.) for a specific Uploadcare
project. Also, you can add a custom CNAME to have a subdomain like
mydomain.ucr.io. This Endpoint will be a part of URL for all files you want
to deliver with Media Proxy.
Also, we'll ask you to provide domain names you’d want the proxy to fetch files from. It can be your website or another domain with your media files.
Here's how to use Media Proxy after it's set up.
Add the Media Proxy prefix that contains your Endpoint to a file URL on the allowed domain. For example:
https://yoursite.ucr.io/ + https://yoursite.com/assets/image.jpg = https://yoursite.ucr.io/https://yoursite.com/assets/image.jpg
image.jpg will be delivered via Uploadcare CDN.
The original file will remain at its original place, so that older references
will work as well.
This CDN operation will resize
500 px in width by adding
As a result,
image.jpg will be resized and delivered with Uploadcare CDN.
Now you can add prefixes to all images using your IDE or text editing tool. Apply CDN operations when needed.
You can also optimize your responsive image handling workflow and free up some storage space by deleting image versions in different sizes for adaptive layouts.
Uploadcare resizes images on the fly and you don't have to save all versions beforehand. Here's how to generate multires images:
1260 pixels in width: https://yoursite.ucr.io/-/preview/-/resize/1260x/https://yoursite.com/assets/image.jpg 760 pixels in width: https://yoursite.ucr.io/-/preview/-/resize/760x/https://yoursite.com/assets/image.jpg 512 pixels in width: https://yoursite.ucr.io/-/preview/-/resize/512x/https://yoursite.com/assets/image.jpg
Find out more on implementing Responsive Images with Uploadcare in our blog.
You can compare page load time and traffic optimization with Uploadcare CDN and without. Use tools like chrome-devtools for local tests. Play around with the image quality and find a sweet spot for the best visual traffic compression results.
Note that the first request for each media file over Media Proxy URL will copy it to Uploadcare CDN. Therefore, there won't be a performance improvement yet. However, once it gets copied to our servers, all subsequent requests will fetch the file from the closest CDN node.
We picked a collection of the most popular Media Proxy use cases. These cases are about optimizing traffic, improving load time, and handling your assets the way you need.
Media Proxy fetches your assets and delivers them via Uploadcare CDN. That alone improves load time of your assets because they get served from a CDN node best for your client’s location.
When handling media, Media Proxy provides further load time improvement by letting you cut file sizes at no visual quality loss. With images, that can be done via our Image Transformations feature.
Specifically, take a look at the following on-the-fly operations:
format, convert images to WebP, PNG or JPEG. It's recommended to use
quality, adjust image quality.
resize, adjust image size.
This set of tools can help accelerate your images up to 9x.
After you set up delivery with Media Proxy, there's just one step to build a
responsive design. Responsive images require that you prepare images in
different sizes and later list them in the
srcset attribute or the
Check out our blog article on Image Transformations that covers responsive techniques.
While accelerating your media improves your conversions, using less bandwidth cuts your traffic costs.
A possible case is that you already use a File API or cloud storage for your assets. In both cases, it is easy to migrate. Set up Media Proxy, make a list of your asset URLs, and replace thm with their optimized versions.
Here's a list of errors you might get when using Media Proxy:
You did not register a Media Proxy domain for your sites by dropping us a line at firstname.lastname@example.org.
You tried fetching a file from a domain that was not allowed. Check settings or contact us to add the domain as allowed for your account.
Your prefix was added to an invalid URL. Consider checking that URL.
You tried fetching an unreachable file. Consider checking its URL.
A problem occurred when trying to upload a file to our storage. Try again later and if it didn't help you always can contact us.