Media Transformations

Self Hosted Commerce Platforms

In an effort to reduce the impact on the systems of merchants using self-hosted commerce platforms we upload all of their Offer and Sku media to a Cloudinary CDN bucket. Once an image has been uploaded to the CDN, the url property on the media element will change to a Cloudinary URL. The original URL of the media can still be found in the source_url property of the media element.

Self Hosted Commerce Platforms Include:

• WooCommerce
• Magento / Adobe Commerce
• Prestashop
• Spree Commerce

SaaS Commerce Platforms

The SaaS commerce platforms Violet is currently integrated with provide a CDN by default. At this time Violet does not upload the media from these platforms to our Cloudinary instance. Instead both the url and source_url property will reflect the original path to the CDN hosted version of the media provided directly by the commerce platform.

SaaS Commerce Platforms Include:

• BigCommerce
• Shopify
• Ecwid
• Swell
• Vendo
• SFCC
• Wix

Transformations

Currently transformations are possible on some commerce platforms.

Self Hosted Platforms

For self-hosted platform sourced media you can utilize the basic transformations made available Cloudinary. These include resizing and cropping.

To resize an image from a self-hosted platform, add or modify the w_*,h_* part of the media url which exists in the file path following the /upload/ part of the file path. The values should be integers and represent pixels. The following path shows an image that has been resized to a width of 100 and a height of 150:

https://res.cloudinary.com/violetlocal/image/upload/w_100,h_150/v1691555244/offer_media/10116_16181_6456.jpg

Shopify

For Shopify sourced media you can utilize the built in transformations provided by the Shopify CDN. These include resizing and cropping.

To resize a Shopify image, add width and/or height query params to the end of the media url. The values should be integers and represent pixels. The following path shows a Shopify image that has been resized to a width of 100 and a height of 150:

https://cdn.shopify.com/static/sample-images/garnished.jpeg?width=100&height=150

Wix

For Shopify sourced media you can utilize the built in transformations provided by the Wix CDN. These include resizing and quality level.

To resize a Wix image, modify the w_*,h_* part of the media url which exists in the file path between /fit/ and /file.jpg. The values should be integers and represent pixels. The following Wix path shows an image that has been resized to a width of 100 and a height of 150: https://static.wixstatic.com/media/3c76e2_5062e9cc9b3f45dd84ec9bc9dcedde63~mv2.jpg/v1/fit/w_100,h_150/file.jpg

Swell

For Swell sourced media you can utilize the built in transformations provided by the Swell CDN. These are currently limited to resizing.

To resize a Swell image, add width and/or height query params to the end of the media url. The values should be integers and represent pixels. The following path shows a Swell image that has been resized to a width of 100 and a height of 150:

https://cdn.schema.io/violet/620052bf11d803013dc8c608/2aea5722002ec20d566265a012a5f4f4?width=100&height=150

Vendo

Vendo utilizes Cloudinary for their media so the same transformation strategy used by the self-hosted commerce platforms can be used with Vendo.

To resize an image from Vendo, add or modify the w_*,h_* part of the media url which exists in the file path following the /upload/ part of the file path. The values should be integers and represent pixels. The following path shows a Vendo image that has been resized to a width of 100 and a height of 150:

https://res-4.cloudinary.com/vendo-production/image/upload/c_limit,f_auto,h_150,q_auto,w_100/v1/11cf5801-f7c8-4b7a-aedc-12a9d20162df/KAWSHOLIDAYSPACEBlack_1_1024x1024_2x-1-1024x1024-1_tgaurp

Unsupported Platforms

The following platforms do not support transformations at this time. We are actively looking at ways to enable transformations on these platforms.

• BigCommerce
• Ecwid
• SFCC

Future functionality will allow you to provide your desired dimensions when querying offers and have any media returned in the response with the dimensions already applied to the URL regardless of platform.