![Bluestone_PIM_white_logo_RBB-3.png]](https://help.bluestonepim.com/hs-fs/hubfs/Bluestone_PIM_white_logo_RBB-3.png?height=50&name=Bluestone_PIM_white_logo_RBB-3.png){kind=logo}
Media service (Bluestone CDN)
Fetch product assets efficiently
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.
The following transformation parameters can be used to retrieve manipulated image content:
Auto Gamma Correction
This parameter automatically adjusts the brightness and contrast (gamma levels) of an image to ensure optimal exposure and lighting balance.
| Parameter | Type | Description |
ag |
Flag | Auto Gamma. Automatically normalizes the lighting and gamma levels of the image to improve visibility, especially in under-exposed or dark photos. |
Tip! Ideal for product photography where lighting conditions may vary, ensuring a consistent look across your digital catalog without manual editing.
Example:
https://media.bluestonepim.com/orgID/PID/product_shot.jpg?ag
Auto Level Adjustment
This parameter automatically improves the contrast and color balance of an image by "stretching" its histogram to the full available range, making the darkest pixels black and the lightest pixels white.
| Parameter | Type | Description |
al |
Flag | Auto Level. Maximizes the tonal range of the image to enhance contrast and remove color casts caused by poor lighting. |
Tip! Can be combined with ag (Auto Gamma) for a comprehensive one-touch optimization of raw product images.
Example:
https://media.bluestonepim.com/orgID/PID/product_shot.jpg?al
Image Cropping
Use these parameters to extract a specific rectangular area from an image. This is ideal for focusing on a specific subject or removing unwanted borders from a larger file.
| Parameter | Type | Description |
cw |
Integer | Crop Width. The width of the area to be extracted. Required. |
ch |
Integer | Crop Height. The height of the area to be extracted. |
cx |
Integer | X Offset. The horizontal starting point (from the left). |
cy |
Integer | Y Offset. The vertical starting point (from the top). |
Note! Note that cropping defines the source area for the output. If you combine cropping with resizing parameters (w or h), the system will first crop the image and then resize the resulting area to your target dimensions.
Example:
https://media.bluestonepim.com/orgID/PID/product_shot.jpg?cw=100&ch=100&cx=10&cy=10
File Format Conversion
This parameter allows you to convert the output image into a different file format. This is particularly useful for optimizing images for the web or ensuring compatibility across different platforms.
| Parameter | Type | Description |
f |
String | Output Format. Specifies the file format of the transformation result. Supported values: jpg, png, gif, webp, avif. The default format is jpg. |
Tip! We highly recommend using avif or webp for web-based delivery, as it provides superior compression and quality compared to traditional formats.
Note! If you are working with images that require transparency, ensure you specify png, webp or avif as jpg does not support alpha channels.
Example:
https://media.bluestonepim.com/orgID/PID/product_shot.jpg?f=webp
Custom Filename
This parameter allows you to specify a custom name for the file when it is downloaded. This is particularly useful for ensuring that exported assets follow your internal naming conventions or include relevant product metadata.
| Parameter | Type | Description |
targetFileName |
String | Download Filename. Sets the name of the file as it will appear on the user's device upon download. |
Note! If your desired filename contains spaces or special characters, ensure they are properly URL-encoded (e.g., a space becomes %20).
Example:
https://media.bluestonepim.com/orgID/PID/product_shot.jpg?targetFileName=Banner.jpg
Imagga Smart Crop
Smart cropping uses AI-driven analysis to automatically identify the most important parts of an image - such as faces, products, or main subjects - and crops the frame around them. This ensures the focal point is never cut off, regardless of the original composition.
This is perfect for generating square thumbnails or portrait/landscape banners from a variety of source images where the subject’s position may vary. Read more about smart cropping.
| Parameter | Type | Description |
scw |
Integer | Smart Crop Width. The target width of the final cropped area. |
sch |
Integer | Smart Crop Height. The target height of the final cropped area. |
Note: Unlike standard cropping, both scw and sch must be specified to activate the Imagga smart cropping logic.
Example:
https://media.bluestonepim.com/orgID/PID/product_shot.jpg?scw=800&sch=600
Resize
Use the following query parameters to control the dimensions of your assets. The system always preserves the original aspect ratio, so you only need to define the dimension(s) you wish to change.
| Parameter | Type | Description |
w |
Integer | Target width in pixels. |
h |
Integer | Target height in pixels. |
only-shrink-larger |
Flag | Optional. Restricts resizing to down-scaling only. Prevents the system from stretching images that are already smaller than the target dimensions. |
Note! You must specify at least one parameter (w or h) to trigger a resize.
Caution: If you provide a width or height larger than the original image, the system will upscale the image by default.
Tip! To ensure images are never upscaled, append the only-shrink-larger flag. In this mode, the image will only be modified if it is larger than your specified dimensions.
Example:
https://media.bluestonepim.com/orgID/PID/product_shot.jpg?h=2600&only-shrink-larger
Image Trimming
The trim parameter automatically removes borders or "empty space" surrounding an image. It identifies the background color by looking at the pixels in the corners and crops inward until it reaches the actual subject.
| Parameter | Type | Description |
trim |
Flag | Trigger. Initiates the "best guess" crop to remove solid color backgrounds from the edges. |
trim-fuzz |
Float | Optional. Defines the tolerance for the trim. Useful for images with "noisy" backgrounds or JPEG compression artifacts. Valid range: 0.0 to 1.0 (Default: 0.0). |
Tip! JPEG compression often creates subtle variations in "solid" colors (anti-aliasing). If a standard trim doesn't remove the entire border, use trim-fuzz (e.g. 0.12) to increase the sensitivity and catch those nearly-identical pixels.
Note: The initial request for a trimmed image may take a few seconds as the system analyzes the pixel data. However, the result is cached, meaning subsequent requests will load instantly.
Example:
https://media.bluestonepim.com/orgID/PID/product_shot.jpg?trim&trim-fuzz=0.12
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.