Media service (Bluestone CDN)

Fetch product assets efficiently


Overview

Transformation parameters

Custom media subdomain


Overview

When fetching product information, a link to all public assets assigned to the product will be returned.

Our service offers powerful query parameters, allowing you to efficiently transform and format images. We encourage customers to utilize these parameters to optimize their workflows and minimize data transfer. Please see the Transformation parameters section below for details.

Transformation parameters

When fetching images from Bluestone's mediabank/CDN, transformation parameters can be added to the request for manipulating how the image should be converted.

This conversion will be performed before the image is transferred to your system, and will therefore allow for a more cost-effective and performance-optimized experience for your applications.

Please note: Fetching media from Bluestone's mediabank/CDN counts towards your monthly data transfer quota, as outlined in your agreement. Exceeding this limit will incur additional charges based on the terms of your contract.

It is therefore recommended to optimize the use of images so that they are not downloaded to clients larger than necessary, by using the transformation parameters available in the media service.


The following transformation parameters can be used to retrieve manipulated image content:

Auto gamma

Query param: ag
Example: ag

Auto level

Query param: al
Example: al

Crop

Query params: cw:width, ch:height, cx:x offset, cy=y offset
Example: cw=100&ch100&cx=10&cy=10
Remarks: At least cw is required to activate cropping.

File format

Query param: f
Example: f=webp
Remarks: The format of the picture transformation result. Possible values jpg, png, gif, webp. Default format jpg.

Imagga smart crop

Query Params: scw: width, sch: height
Example: scw=100&sch=100
Remarks: Both scw and sch are required to activate smart cropping. Read more about smart cropping.

Resize

Query params: w: width, h: height
Example: w=100
Remarks: At least one of two must be specified to activate any resizing. This will upscale the image if the original is smaller than the defined resize dimension, and it will not change the image ratio.

Trim

Query param: trim
Example: trim&trim-fuzz=0.12
Remarks: Makes a ‘best guess’ crop to upper-left and lower-right corners. For example, if you have an image with a white border around it, and you want that area to be removed.

Optional:
trim-fuzz: Use 'trim-fuzz' in addition to fuzz the trimming edge. For JPEGs, due to compression or anti-aliasing, edges are often not clean. The fuzz value allows you to trim with a slight extra fuzz around the trim area. Valid values are 0.0 - 1.0 (default 0.0).

Note: The conversion might take some seconds the first time, but the converted image will be cached, thus any further requests will be fast.

Custom media subdomain

If you use media from Bluestone PIM's mediabank/CDN for your website, URLs will be served via CloudFront. This ensures quick loading times and efficient media delivery to your site.

To maintain this efficiency and at the same time serve media from your own domain, we advise creating a custom subdomain for each channel that uses media from media.bluestonepim.com.

Please see Custom subdomain for media/assets for more information.