Product and category media types and where they display
Key Takeaway
Each media type has its own place. Product detail images show on the product detail page. The single product list image represents the product in search results, the cart, and the category view. A category's banner image shows on its category page after you set the Banner component's Image URL or Expression property to Banner Image.
In B2B Commerce, you can add images, videos, and attachments to products and categories to give buyers more information. Each image type has its own job and shows in a specific place in the store, such as the product detail page, search results, the cart, or a category page. An administrator who knows which type shows where can put the right media in the right slot.
Product detail images and the product list image
You can add media to both parent products and variation products. For product images, the most important difference is between product detail images and the product list image, because they show in different places.
Product detail images are the alternate views of a product on the product detail page. A product can have up to nine product detail images. You choose the order they appear in.
The product list image is the single image that represents a product in search results, the cart, and the category view. Each product can have only one.
Unlike product detail images, which only show on the product detail page, the product list image is what buyers see while they browse and buy.
Priya manages a B2B store that sells industrial safety helmets. For one helmet, she adds a front view, a side view, a back view, and a close-up of the chin strap as product detail images, and she drags them into that order. She also adds one clean front shot as the product list image. A buyer who searches for "helmet" sees the front shot in the search results. The same front shot appears when the buyer browses the helmet's category and after the buyer adds the helmet to the cart. The four alternate views appear when the buyer opens the helmet's product detail page.