Audience: Retailers and Suppliers

Rithum provides load-balanced image servers that can be used by retailers to download product images of various sizes and dimensions to their eCommerce system. We do this by allowing you to append certain parameters to the end of the image URL and, based on the parameters and values you provide, our image servers will return the image you request in the size and dimensions you need.

Rithum recommends that all retailers download and store supplier images on their own servers. We recommend this so that each retailer always has direct access to the images versus calling out to the  servers to display those images on the website.

Product and item images

Product images

Product images in the platform are used by suppliers to showcase the various items you can sell on your site. Suppliers can add many different product images to each item in the platform. 

Rithum supports any sized image in JPG, PNG or GIF format. We recommend that suppliers provide very high resolution images so that Rithum can resize them for you and deliver the best images for you to use on your site.

Item images

Item images in the platform are used by suppliers to showcase the individual items within a product group. Unlike product images, item images will be specific for each item in the platform. 

URL parameters

maxX: The "maxX" parameter specifies the maximum width, in pixels, for the given image that you would like returned.

maxY: Specifying "maxY" instructs the image servers to return an image with the given value as the maximum height, in pixels.

If an image is not square, the image will be resized to its original proportions with the maxX and maxY being applied to the maximum width and height of the final image.

pad=1: Some systems may require that images be a specific width and height. Specifying "pad=1" within the request URL instructs the image servers to resize the image so that the height and width match the maximum height or width specified. For example, if you specify a maximum width of 100 and the original image is 300 by 200, the resulting image will be 100 by 100 pixels. If you don't specify a maximum width or height and you specify "pad=1" then the resulting image will be 300 by 300 pixels. When using the "pad=1" option, both the "maxX" and "maxY" parameters must be used as well.

When requesting specific sizes, if the original image format supports transparency, the space that is "filled in" by the image servers when padding the image width or height, depending on the dimensions of the original image, will be transparent. If the image format does not support transparency, the padded area will be white. For example, images with a PNG or GIF extension may support transparency although JPG does not.

Example URLs

Here are a few example image URL's that employ each of the different image resizing options provided by the platform:

Maximum X and Y:

Square Image:

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.