CommerceHub recommends that suppliers add as much product data as possible so that retailers have all the data necessary to list products on their website. This article describes the image requirements for those using basic catalog to upload product data to CommerceHub’s Dsco platform.
Product Images vs. Item Images
Product images should be used to showcase the various products you sell. You can add many different product images to each item in the Dsco platform.
TIP: Product images should only be used if you're also using the Product Groups feature. See Variant SKUs and Product Groups for more information. If you're not using the Product Groups feature, use the item images option when adding images to an item.
Item images should be used to showcase the individual items/variations within a product group. Unlike product images, item images should be specific for each item in the Dsco platform.
- CommerceHub supports any size images in the following file formats:
- We recommend providing very high resolution images as we will resize them for your trading partners so that they get the best size for their needs.
- You must not include spaces in the image title. Using hyphens (-) or underscores ( _ ) is recommended to create more stable image links. Here’s an example: ABCDE_1234-1234.jpg.
- Some retailers have their own minimum sizing requirements, so be sure to follow your retailer’s requirements.
Image Hosting Requirements
Images must be hosted in a PUBLIC repository/site. If you aren't sure how to host images online or do not have an internal hosting site that's public, you can use one of the following services:
- Google Photos
Important: Be aware that public hosting repositories/sites may have their own restrictions and limitations for data downloads, and this may affect how, or the speed at which, your images are downloaded. In some cases, the Basic/Level 1/Free contract with any service may not meet the Dsco platform's expectations for availability.
Image URL Requirements
- You must use HTTPS. Here's an example: https://www.dropbox.com/s/85dxl67o4xinmlj/FW5033-MFW5223-M1.jpg.
- You must not include spaces in the URL. Using hyphens (-) or underscores ( _ ) is recommended to create more stable image links. Here’s an example: https://www.dropbox.com/s/0099/ABC_12-12.jpg.
- The image URL must:
- Be a valid format.
- Link to raw image data (not an image view).
- Lead to a downloadable image file. If the system cannot download the image, the URL will fail.
- Be an actual image file (JPG, JPEG, PNG, or GIF. Not a PDF) when downloaded by the system.
- If images are rejected by the upload tool, you can visit the URL provided in the file to confirm the image will render in the browser (you must not be logged in to your image hosting site). When viewing images, there should not be additional navigational links/buttons on the page; only the image should show in the browser window.
- Be aware that image preview pages with download buttons and other icons are not direct links to the images.
If you're using Dropbox to host your images:
Dropbox will automatically create a direct image link with a dl=0 extension at the end of each URL, which will result in an image error. You must change the dl=0 value to dl=1. Valid image URLs should look like this: https://www.dropbox.com/s/85dxl67o4xinmlj/FW5033-MFW5223-M1.jpg?dl=1.