Digital Showroom displays the product data of your Akeneo PIM, so the way your PIM is set up shapes what your teams and buyers see. Check these prerequisites before you create your first Portfolio: they make sure products have images, can be browsed by Category, and show the right values in the right language.
Enable the Digital Showroom catalog
When you activate Digital Showroom, it creates a catalog named Digital Showroom in your PIM. Digital Showroom only shows the products this catalog selects, and nothing appears until the catalog is enabled.
- Enable the catalog. Akeneo PIM always creates it disabled.
- Set its product selection criteria to the products you want to share.
- In its value filters, select the Channels, Locales, and currencies you want to use.
To open the catalog, go to Admin > Portfolios > PIM settings in Digital Showroom and click PIM Catalog. See Connect your PIM.
Channels, Locales, and currencies
A PIM value is defined for a Channel and a Locale. Each Portfolio uses one Channel, so the Channel decides which values, Category tree, Locales, and currencies its users see.
- Check that the Channel you plan to use has the right Locales and currencies enabled in your PIM.
- Select this Channel, its Locales, and its currencies in the catalog value filters.
- Translate product values, Attribute labels, Attribute Group labels, and Category labels into each Locale you plan to offer.
- Fill in price Attributes in each currency you plan to display.
Only offer Locales in which your products are well translated. A Locale with few values shows mostly empty product pages.
To learn more, see What is a channel? in the Akeneo PIM Help Center.
Categories
Users browse a Portfolio through its Category tree. The Category tree is the one linked to the Portfolio's Channel, and you can start the navigation from a specific branch.
- Classify your products and product models in the Category tree of the Channel you use. A product model that is not classified in this tree cannot show its details in Digital Showroom.
- Translate Category labels into all the Locales you offer.
Families and Attribute Groups
- Families: make sure every product belongs to a Family. Users can filter products by Family, and the Family defines which Attribute is used as the product's main image.
- Attribute Groups: the product details page groups Attributes by Attribute Group. Give your Attribute Groups clear labels in every Locale.
Product images and media
Product thumbnails in the product grid and the main image of the product details page come from your Family's attribute used as main picture in Akeneo PIM.
Supported Attribute types
The table shows where each Attribute type can be used in Digital Showroom.
| Attribute type | Product details page | Product grid column or card | Navigation filter |
|---|---|---|---|
| Identifier | Yes | Yes | Yes |
| Text | Yes | Yes | No |
| Text area | Yes | Yes | No |
| Number | Yes | Yes | Yes |
| Measurement | Yes | Yes | Yes |
| Price | Yes | Yes | Yes |
| Yes/No | Yes | Yes | Yes |
| Date | Yes | Yes | No |
| Simple select and multi select | Yes | Yes | Yes |
| Reference entity single link and multiple links | Yes | Yes | Yes |
| Product link | Yes | Yes | No |
| Table | Yes | No | Yes, on its select, Yes/No, and reference entity columns |
| Asset collection | Yes, in Files and Media | As the product thumbnail only | No |
| Image and file | Yes, in Files and Media | No | No |
Attribute types that are not listed here are not displayed in Digital Showroom.
Products
- Fill in values for the Channel and Locales you plan to use.
- Classify products in the Channel's Category tree.
- Assign each product to a Family.
- Aim for high Completeness: empty Attributes appear as empty values in Digital Showroom.
To learn more, see Follow your product's completeness in the Akeneo PIM Help Center.