Structure of Custom Domain URL
The Custom Domain CDN URL that is used to transform or deliver assets has the following structures.
https://{CUSTOM_DOMAIN}/v2/{PATTERN}/{FILE_PATH}
https://{CUSTOM_DOMAIN}/v2/wrkr/{FILE_PATH}
https://{CUSTOM_DOMAIN}/v2/{ZONE_SLUG}/{PATTERN}/{FILE_PATH}
https://{CUSTOM_DOMAIN}/v2/{ZONE_SLUG}/wrkr/{FILE_PATH}
Each PixelBin CDN URL is a Zone URL. If a PixelBin CDN URL does not have the ZONE_SLUG
parameter, that means that it is a Default Zone URL.
Parameters
{CUSTOM_DOMAIN}The domain that you chose to use with PixelBin. To learn more about the Custom Domains, click here.
{PATTERN}The pattern parameter corresponds to the transformations that need to be applied to the input file. You can apply a single transformation or a combination of transformations, add-ons and presets. Learn more.
If the original
keyword is used in place of the pattern, the returned file will be the original asset without any modifications.
The relative path of the file from the root folder of the storage along with the extension.
{ZONE_SLUG}Unique ID of a zone if using external storage to deliver a file. The default zone has no slug parameter.
For more information on optional parameters, CDN Response, transformation patterns or transforming Images using URL which is common to both the Custom Domain CDN URL and the PixelBin CDN URL, please refer to the URL Structure guide.
Examples
Let's say you have a custom domain assets.example.com
and you want to deliver the file logo.png
from the root folder of the storage. Following are some examples for possible PixelBin CDN URLs and their equivalent Custom Domain CDN URLs.
CDN URL for default Zone
- Custom Domain
- PixelBin Domain
- Original
- Transformed
https://assets.example.com/v2/original/images/logo.png
https://assets.example.com/v2/erase.bg()/images/logo.png
- Original
- Transformed
https://cdn.pixelbin.io/v2/dummy-cloudname/original/images/logo.png
https://cdn.pixelbin.io/v2/dummy-cloudname/erase.bg()/images/logo.png
CDN URL for default Zone with URL Translation Worker
- Custom Domain
- PixelBin Domain
- wrkr
https://assets.example.com/v2/wrkr/images/logo.png
- wrkr
https://cdn.pixelbin.io/v2/dummy-cloudname/wrkr/images/logo.png
CDN URL for non-default Zone
- Custom Domain
- PixelBin Domain
- Original
- Transformed
https://assets.example.com/v2/FIDrmb/original/images/logo.png
https://assets.example.com/v2/FIDrmb/erase.bg()/images/logo.png
- Original
- Transformed
https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/logo.png
https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/erase.bg()/images/logo.png
CDN URL for non-default Zone with URL Translation Worker
- Custom Domain
- PixelBin Domain
- wrkr
https://assets.example.com/v2/FIDrmb/wrkr/images/logo.png
- wrkr
https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/wrkr/images/logo.png