You can add multiple origins in the same account. URL endpoints allow you to configure which origins are accessible through your account and set their preference order as well.

Default URL-endpoint

When you signup, a default URL endpoint is created in your dashboard. The default URL endpoint is always The first origin that you add automatically becomes accessible through this default URL endpoint.

How to add a new URL-endpoint?

You can add multiple URL endpoints and control which origins are accessible over which URL endpoint. You can create a one-to-one mapping between origin and URL endpoints or add multiple websites (origins) behind a single URL endpoint.
Here are the steps to add a new URL endpoint:
  1. 1.
    Go to the URL Endpoints section in your dashboard, and click on the "Add New" button.
  2. 2.
    Fill the identifier field. It will become part of the URL endpoint. So, suppose you want to create a URL-endpoint just to access product images bucket, and you want it to be like , then enter product-images in this field.
  3. 3.
    Enter a description. This is just for you to add a note for the URL endpoint and will appear in the list of endpoints.
  4. 4.
    Now define the sequence of origins for this URL endpoint.
  5. 5.
    The first origin is always Media Library (or internal cache) and cannot be changed.
  6. 6.
    Choose the second origin, which would be our Product images bucket.
  7. 7.
    Click "Save".
Add a URL pattern exclusive for one category (eg. product images)

Image origin preference

A single URL endpoint can be configured to fetch an image from multiple image origins. You can decide the order in which should try to access images from these origins.
Let's understand this with an example. When an image is requested at, here is what happens:
  1. 1.
    rest-of-the-path.jpg is first looked at in our internal caches and storage, i.e., Media Library. If the image is found, a response is returned. If not:
  2. 2.
    Second image origin is accessed, i.e., S3 Bucket Product Images. If the image is found, a response is returned. If not, we move to the third origin.
  3. 3.
    Third image origin is accessed, i.e., Backup S3 Images Bucket. If the image is found, a response is returned. If not, a default image, or 404 response is returned as there are no more image origins configured with this URL-endpoint.
Image Origin Preference

Mapping custom domain for a URL endpoint

You can configure a custom domain for a particular URL endpoint. Once a custom domain is configured on your account, it is an alias for the default URL endpoint So, if you create new URL endpoints, with different Identifier values, then you would just need to add the identifier in your image URL along with the custom domain name. or the ID no longer appears in the URL.
You can also configure multiple custom domains and create a one-to-one mapping with the URL endpoints.
For example, in the screenshot below, we have two URL-endpoints:
  1. 1.
    One is default URL-endpoint - This is associated with a custom domain So your image URL would become
  2. 2.
    And the second one is - This is associated with a custom domain So your image URL would become Note that with, which is mapped to a particular URL endpoint, you do not have to add the endpoint identifier (product-images) in the image URL.
Custom domain mapping with URL-endpoints
How to add new custom domain names or map a custom domain to a URL endpoint? ****This addition and mapping of custom domain names is currently done by the support team. Please create a support ticket using chat or by dropping us an email at [email protected].