PIM prerequisites
Before your team can start browsing products in Digital Showroom, your Akeneo PIM needs to be properly configured. Digital Showroom reads product data from your PIM, so the quality and completeness of your PIM setup directly affects the experience your users will have.
This article walks you through each area of your PIM that Digital Showroom relies on.
Channels
A Channel in Akeneo PIM represents a distribution context — it defines which locales, currencies, and category tree are associated with a particular way of distributing your product data. When you create a portfolio in Digital Showroom, you must select a Channel, and that Channel determines which locales and currencies are available.
Make sure at least one Channel is configured in your PIM, and verify that it has the correct locales and currencies enabled.
To learn more about channels, see What is a channel? on the Akeneo PIM help center.
Locales
Locales determine which languages are available for your product data. Digital Showroom displays product information in the locales you select when creating a portfolio. These locales come from the Channel you choose, so make sure the right locales are enabled on your Channel.
Enable all the locales you want available in Digital Showroom on your PIM Channel, and ensure your product data is translated into those locales for a complete experience.
If your products are only complete in certain locales, consider enabling only those locales in your portfolio to avoid showing empty values to users.
To learn more, see Manage your locales on the Akeneo PIM help center.
Currencies
Currencies determine how prices are displayed in Digital Showroom. Like locales, the available currencies are determined by the Channel you select for a portfolio.
Enable the currencies you need on your PIM Channel, and make sure product price Attributes have values in the currencies you plan to use.
To learn more, see Manage your currencies on the Akeneo PIM help center.
Attributes
Attributes are the building blocks of your product data. Digital Showroom supports the following Akeneo PIM Attribute types:
- Identifier — The product identifier (SKU or reference code)
- Text and Textarea — Descriptions, names, and other text content
- Number — Numeric values such as weight, dimensions, or quantities
- Boolean — Yes/no values like "Is recyclable" or "In stock"
- Date — Date values such as launch date or expiration date
- Price — Product prices in one or more currencies
- Metric — Measurements with a unit (e.g., 2.5 kg, 100 cm)
- Simple select and Multi select — Single-choice and multi-choice option lists (e.g., color, material)
- Reference entity and Reference entity collection — Links to reference entity records (e.g., brand, designer)
- Image and File — Media files attached directly to products
- Asset collection — Linked assets from Asset Families (images, videos, documents)
- Table — Structured tabular data
- Product link — Links to other products in the PIM
Ensure the Attributes you want displayed, filtered, or searched in Digital Showroom have data in the relevant locales and Channel scope. Attributes without values will appear empty in Digital Showroom.
Table Attributes are displayed on the product details page but cannot be used as portfolio product filters.
To learn more, see What is an attribute? on the Akeneo PIM help center.
Attribute Groups
Attribute Groups organize your Attributes into logical sections. In Digital Showroom, the product details page displays Attributes grouped by their Attribute Group. This helps end users find the information they need quickly.
Organize your Attributes into meaningful groups (e.g., "Technical specifications", "Marketing", "Dimensions"), and give your Attribute Groups clear, descriptive labels in all relevant locales.
To learn more, see Manage your attribute groups on the Akeneo PIM help center.
Categories
Categories provide the hierarchical navigation structure in Digital Showroom. When browsing a portfolio, end users navigate through category trees to find products. The administrator chooses a root category for each portfolio, and only products within that category branch are visible.
Set up a well-structured category hierarchy in your PIM, make sure category labels are translated into all locales you plan to use, and assign your products to the appropriate categories.
You don't need to use your entire category tree. When configuring a portfolio in Digital Showroom, you can select a specific branch as the root category, which limits the navigation to only that part of the tree.
To learn more, see What is a category? on the Akeneo PIM help center.
Families
Families define the set of Attributes that apply to a group of products. In Digital Showroom, the Family determines which Attributes appear on the product details page. Families are also available as a filter option so end users can quickly narrow down products by type.
Create Families for each type of product in your catalog, assign the appropriate Attributes to each Family, and make sure every product belongs to a Family.
To learn more, see What is a family? on the Akeneo PIM help center.
Asset Families
Asset Families are essential for displaying media in Digital Showroom. Product images, videos, PDFs, and other documents shown in the Medias & Files tab and used as product gallery thumbnails are all sourced from Asset Families in your Akeneo PIM.
- Create Asset Families in your PIM for each type of media you want to manage (e.g., "Product Photos", "Technical Documents", "Videos").
- Link assets to your products using Asset collection Attributes.
- Ensure the media files are uploaded and properly linked.
- Make sure each product Family's attribute used as the main image is set to an Asset collection Attribute.
Without Asset Families and Asset collection Attributes, products will have no thumbnails in the product gallery, no main image on the product details page, and an empty Medias & Files tab in Digital Showroom.
To learn more, see What is an asset family? on the Akeneo PIM help center.
Catalogs for Apps
Digital Showroom uses the Akeneo PIM Catalogs for Apps feature to define the scope of products shared with the application. A catalog must be set up and enabled in your PIM for the Digital Showroom Connect App after the connection is activated.
After activating the Digital Showroom Connect App, open the catalog configuration in your Akeneo PIM — you can navigate there directly by clicking PIM Catalog in Admin > PIM Settings in Digital Showroom. Enable the catalog and configure the Channel, locales, and any product selection criteria you want to apply.
Make sure the catalog is enabled before expecting products to appear in Digital Showroom.
To learn more, see How to configure a catalog for an App on the Akeneo PIM help center.
Products
Make sure your products are ready for Digital Showroom:
- Products should have data filled in for the Channel and locales you plan to use.
- Products should be assigned to categories.
- Products should belong to a Family.
- For the best experience, aim for high product completeness — products with many empty Attributes will not look great in Digital Showroom.
Use the PIM's Completeness feature to check which products still need data before making them available in Digital Showroom.
To learn more, see Monitor product completeness on the Akeneo PIM help center.