File Sources External HTTP URL
Optimize and process files hosted elsewhere by creating an "External HTTP URL" file source.
Process files hosted elsewhere.
Optimize images to reduce page load times.
Benefit from edge caching and permanent caching.
Learn about: Edge Caching, Permanent Caching, and Image Optimization to reduce page load times.
Requests to transform files from external HTTP URLs may incur additional latency due to internal download operations:
Video and audio transformations will incur an additional latency of ~1 second per 75MB of input file size when using external HTTP URLs.*
Image transformations from external HTTP URLs do not incur latency: the performance is the same as using Upload's Built-in Storage.
*
Applies to the first request only: once the result is cached all subsequent requests to the same URL will return near-instantly.
Upload supports two options:
To process files from a fixed base URL:
Create a folder in the Upload Dashboard.
Edit the folder's settings.
Click on "Storage Settings".
Change "Storage Type" to "External HTTP URL".
For "Use a Base URL" select "Yes"
Enter the base URL to fetch files from.
Click on "Save Changes". (Don't forget this step before continuing!)
Try it out:
Copy the "Example CDN URL" from the form.
Replace "example.jpg" with a relative path you want to fetch from the underlying URL.
To process the file, try using the Image Processing API.
To process files from any URL at runtime:
Create a folder in the Upload Dashboard.
Edit the folder's settings.
Click on "Storage Settings".
Change "Storage Type" to "External HTTP URL".
For "Use a Base URL" select "No"
Click on "Save Changes". (Don't forget this step before continuing!)
Try it out:
Copy the "Example URL" from the form.
Replace "https://assets.upload.io/example.jpg" with a URL you want to fetch.
To process the file, try using the Image Processing API.
For reference, the "Storage Settings" section of the "Folder Settings" page is shown below:
These pages may also be helpful:
