Configure the product details page

Summary

The product details page is what users see when they open a product from the gallery. For each Portfolio, you choose which Attribute names products and product models, how users switch between variants, and which key Attributes appear at the top of the page, so buyers find the essential information without scrolling.

For example, a sporting goods brand can name products with their marketing name, let buyers pick a shoe's color and size with buttons, and feature the price, the main material and the weight right next to the product image.

You need the Administrator role to configure the product details page.

 

Open the product details settings

  1. Go to Admin > Portfolios and click the Portfolio you want to configure.
  2. Click Product details in the left sidebar.

The settings are on the left. If the Portfolio contains products with variants, a live preview on the right shows a Product Page preview and a Model Page preview based on one of its products, and updates as you change the settings.

Product details settings with label and variant options on the left and page previews on the right

All settings on this page are saved together when you click Save.

Set the product label

The product label is the name of a product throughout Digital Showroom: on product cards, at the top of the product details page, in PDF exports, and in the product label sort option of the gallery.

  1. Click the Product label attribute selector.
  2. Search for an Attribute by label or code, or browse the list. Attributes are grouped by Attribute Group.
  3. Click the Attribute to use.
  4. Click Save.

Choose an Attribute that is filled in for all your products, such as a product name or title. When a product has no value for this Attribute in the user's Locale, or when no product label is set, Digital Showroom displays the product identifier instead.

Set the product model label

If your catalog groups variants under product models in Akeneo PIM, the product model label names each model: on model cards when users group the gallery by model, and at the top of the model page.

  1. Click the Product model label attribute selector.
  2. Search for and click the Attribute to use.
  3. Click Save.

If no product model label is set, Digital Showroom uses the product label Attribute for models too. When the model has no value for the Attribute, the model code is displayed.

Only Attributes visible in the Portfolio appear in the label selectors. To use another Attribute, add it in the Attribute selection section first. If you remove the selected Attribute from the Attribute selection, the label setting is cleared.

 

Choose how users select variants

For products with variants, a variant selector appears at the top of the product details page. Choose the layout that fits the variation axes of your catalog.

  1. Open the Variant display mode dropdown.
  2. Select a mode.
  3. Click Save.
Mode What users see Best for
Dropdown (default) One compact list of all variants. Many variants, or a single variation axis.
Buttons Each variation axis as a row of buttons, rows stacked vertically. A few axes with few values each, such as color or size.
Horizontal dropdowns One dropdown per variation axis, side by side. Several variation axes.

Use the preview to check that the selected mode suits your variation axes before you save.

Featured Attributes appear at the top of the product details page, next to the product image and under the product label, so users see the most important information first.

  1. In the Featured attributes section, find an Attribute in Available Attributes. Use the search field to search by label or code.
  2. Select the checkbox next to the Attribute. It moves to Selected Attributes.
  3. Repeat for up to 5 Attributes.
  4. Drag the handle next to a selected Attribute to change its position.
  5. Click Save.
Featured attributes section with available and selected Attributes, drag handles and a counter

Featured Attributes appear in the order of the Selected Attributes list. When you reach 5, the remaining checkboxes are disabled until you clear one. To remove a featured Attribute, clear its checkbox in Selected Attributes and click Save.

Only Attributes visible in the Portfolio can be featured. If the list is empty, click Go to attributes selection to add Attributes to the Portfolio.

How the rest of the page is organized

Below the product header, users see the Details, Files and Media and Associated products tabs. These tabs are configured elsewhere:

Tab Where you configure it
Details All visible Attributes, in one section per Attribute Group. You choose the visible Attributes, and the order of Attribute Groups and of Attributes within each group, by drag and drop in Attribute selection. Until you reorder them, the order defined in Akeneo PIM applies. See Portfolio settings and Attribute selection.
Files and Media The product's assets come from Akeneo PIM. You choose the filters users can apply in Asset filters. See Configure asset filters.
Associated products Associations come from the Association Types defined in Akeneo PIM; there is nothing to configure in Digital Showroom. In list view, associated products use the table columns set in Product gallery. See Configure the product gallery.

To see the page as your users do, click Preview Portfolio at the top of the page.

Want to find out more? Take a look at these related articles