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
The standard image of each catalog entry
(product, SKU, bundle, or kit) is required in six different sizes:| Image size (width is fixed, height is variable) | Where image is used |
|---|---|
| 447 pixels wide | Product details page (B2C) – full image of the product or SKU |
| 330 pixels wide |
|
| 160 pixels wide |
See examples of this thumbnail in the product listing that is shown: Subcategory page (B2C) |
| 70 pixels wide |
See an example of the thumbnail: Order Details page |
| 105 pixels wide | Thumbnail image that is shown on the shopping cart pop-up window that displays when a customer adds an item to the cart. |
| 1000 pixels wide | Note: An image of this size is not currently
used on the storefront. However, the code in the store pages uses
the path to this image to locate other catalog entry images in different
sizes. Therefore, when you are creating catalog entries in Management
Center or loading CSV or XML files, you must specify a path to this
image as the Full image, even if you do not
upload the image itself. For more information, see the next section
titled Path naming convention for catalog entry images. |
Beginning with Feature Pack
7 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
| Catalog entry image | Path must have this character string in a directory name | Path example (bold text indicates the required character string) |
|---|---|---|
| 447 pixels wide | 447x447 | /storedir/images/catalog/apparel/women/womens_dresses_447x447/WD_033_c_red.jpg |
| 330 pixels wide | 330x330 | /storedir/images/catalog/apparel/women/womens_dresses_330x330/WD_033_c_red.jpg |
| 160 pixels wide | 160x160 | /storedir/images/catalog/apparel/women/womens_dresses_160x160/WD_033_c_red.jpg Note: You must specify the path to
this image as the Thumbnail path in Management Center or when you are loading
catalog entry data with CSV or XML files. Your storefront locates images in other sizes that are
based on this path and replaces the 160x160 directory with the
appropriate directory. |
| 70 pixels wide | 70x70 | /storedir/images/catalog/apparel/women/womens_dresses_70x70/WD_033_c_red.jpg |
| 105 pixels wide | 105x105 | /storedir/images/catalog/apparel/women/womens_dresses_105x105/WD_033_c_red.jpg |
| 1000 pixels wide | 1000x1000 | /storedir/images/catalog/apparel/women/womens_dresses_1000x1000/WD_033_c_red.jpg Note: You must specify the path to
this image as the Full image path in Management Center or when you are
loading catalog entry data with CSV or XML files. Your storefront locates images in other sizes that
are based on this path and replaces the 1000x1000 directory with
the appropriate directory. |
Beginning with Feature Pack
7, the path naming convention for catalog entry images is changed.
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. |