Catalog image requirements for the Aurora starter store
For each catalog entry (product, SKU, bundle, and kit), the Aurora starter store displays images in various sizes in different locations. The catalog entry images must be at a path that follows a naming convention. For a catalog entry, images of various sizes must have the same file name.
For each category, the Aurora starter store supports only a single category image. There are no restrictions for the path naming convention or file name for the category image.
Note: High-quality images might
degrade site performance, since images that are too large are slow
to download on the storefront. Ensure that you monitor pages with
large images, or optimize your image files to reduce their file sizes.
Images for catalog entries
Only two image sizes are required for each catalog entry (product, SKU, bundle, and kit):
| Image size (width is fixed, height is fixed) | Where image is used |
|---|---|
| 200x310 pixels | All thumbnail images of catalog entries. For example, this image can be used in any widget that displays a list of catalog entries, such as the Catalog Entry List and Catalog Entry Recommendation widget. |
| 646x1000 pixels | All full images of catalog entries. This image is used in any Commerce Composer widget that displays the full images of the catalog entry, such as the Full Image widget. |
Path naming convention for catalog entry images
The Aurora store requires catalog entry images to be at a path that contains a specific character string in a directory name. For a catalog entry, the JSP page code tries to match the character string in the path to retrieve an image in the correct size. If the character string is not found in one of the directory names, the store pages display images that are the wrong size.The
example paths in the following tables begin with:
WCDE_installdir/Stores/WebContent
WC_eardir/Stores.war
The image paths and files names for the catalog entry thumbnail and full images use the
following patterns:
| Catalog entry image | Path must have this character string in a directory name | Path example (bold text indicates the required character string) |
|---|---|---|
| thumbnail images | 200x310 | /storedir/images/catalog/apparel/women/wc1000_dresses/200x310/wc1000_0001_1_blue.jpg |
| full images | 646x1000 | /storedir/images/catalog/apparel/women/wc1000_dresses/646x1000/wc1000_0001_1_blue.jpg |
File names for catalog entry images
For each catalog entry, all images in different sizes must have the same file name. In the previous table, the images in the path examples meet this requirement.Images for categories
For each category in the catalog, the following image is required:| Image size (width is fixed, height is variable) | Where image is used |
|---|---|
| 160 pixels wide | The category thumbnail image is displayed in
e-Marketing Spots that display categories arranged horizontally across
a page. See an example in the e-Marketing Spot named [category]Row3_Categories: Department page (B2C) |
| 256 x 160 pixels | The category thumbnail image is displayed in the Commerce Composer e-Marketing Spot widgets
that display categories arranged in either horizontal or vertical orientation in a layout. See an example in the layout that is named DepartmentPageLayout, and the widget that is named CategoryRecommendationWidget, and the e-Marketing spot [category]Row3_Categories. |