When the Akeneo App runs in Custom Objects Mode, product information is written into the application's custom tables instead of native Salesforce Commerce structures. This guide explains how a Salesforce administrator can display this custom data—Variations, Translations, Media, Categories, and Associations—on the Product2 record page using the packaged components included in the Akeneo bundle.
Architectural Note
The app does not ship, activate, or modify any Product2 Lightning record pages or classic page layouts. You must manually add these custom components using the Salesforce Lightning App Builder. For the native Salesforce Commerce layout guide, please see Configuring the Product Display Layout (Standard Mode).
Domain Mapping Quick Reference
The following table summarizes which custom tables hold your Akeneo data and the matching package components required to render them on the layout:
| Domain | Akeneo Custom Salesforce Object | Custom Record Page View / Component |
|---|---|---|
| Variations | Akeneo_Product_Variant__c | Akeneo Product Variants List |
| Translations | Akeneo_Product_Translation__c | Akeneo Product Details (with built-in locale switcher) |
| Media | Akeneo_Product_Asset__c | Akeneo Product Media Gallery |
| Categories | Akeneo_Product_Category_Assignment__c | Akeneo Product Categories List |
| Associations | Akeneo_Product_Association__c | Akeneo Product Associations List |
Before You Start
Before modifying your product page layouts in the Lightning App Builder, you must ensure your app settings match your desired technical architecture:
- Verify the Domain Configuration: Ensure your app target modes are left blank or explicitly configured to leverage custom tables. For detailed, step-by-step guidance on how to verify these properties in your Custom Metadata Types, please see our dedicated Post-Installation Configuration Guide.
- Hybrid & Mixed Mode Capability: Please note that target modes can be defined independently per data domain. Depending on your business requirements, it is fully supported to mix object types—for example, you can choose to run Standard Mode for Variations and Categories to fuel native commerce features, while remaining in Custom Objects Mode for Translations and Media. Always ensure your layout components match the specific target mode of each domain.
Structural Warning
The custom-packaged components shipped with the app (such as Product Media Gallery and Product Variants List) are hardcoded to read legacy custom tables. If a specific domain's target mode is switched to Standard, these custom components will remain completely empty on your layout and must be replaced by native Salesforce Commerce components.
Product Assets Visibility
To view your Akeneo Product Assets for each of your products, you'll need to adjust the Product2 object layout.
This is important because it ensures that the product assets from Akeneo are visible for each record. To do this, just follow these simple steps:
- Go to Setup and search for Object Manager
- Click on Product2 to open the object manager page
- Click on Page Layouts and select the layout that you want to edit
- Drag and drop the Akeneo Product Assets related list onto the layout
- Adjust the columns to display Name, Asset Type, and Asset URL
- Save the layout, and you should see the related list now
Once you complete a transfer of Akeneo Product Assets, you will be able to access each product asset directly from your related lists.

Product Translations Visibility
To view your Akeneo Product Translations for each of your products, you'll need to adjust the Product2 object layout.
This is important because it ensures that the product translations from Akeneo are visible for each record. To do this, just follow these simple steps:
- Go to Setup and search for Object Manager
- Click on Product2 to open the object manager page
- Click on Page Layouts and select the layout that you want to edit
- Drag and drop the Akeneo Product Translations related list onto the layout
- Adjust the columns to display Name, Language, Field API Name, Translation
- Save the layout, and you should see the related list now
Once you complete a transfer of Akeneo Product Translation, you will be able to access each product attribute with the related locale directly from your related lists.

Product Models and Variations Visibility
To view your Akeneo Product Variations and Axis Details for each of your variant products, you'll need to adjust the Product2 object layout.
This is important because it ensures that the product variations from Akeneo are visible for each record. To do this, just follow these simple steps:
- Go to Setup and search for Object Manager
- Click on Product2 to open the object manager page
- Click on Page Layouts and select the layout that you want to edit
- Drag and drop the Akeneo Product Variant Axis Details related list onto the layout and Akeneo Variant Products
- Adjust the columns of the Akeneo Product Variant Axis Details related list to display Locale, Attribute Label, and Attribute Value
- Save the layout, and you should see the related list now
Once you complete a transfer of Akeneo Product Models and variants, you will be able to access each product variant axis with the related information directly from your related lists.

Product Categories Assignments Visibility
To view your Akeneo Category assignments for each of your products, you'll need to adjust the Product2 object layout.
This is important because it ensures that the product categories from Akeneo are visible for each record. To do this, just follow these simple steps:
- Go to Setup and search for Object Manager
- Click on Product2 to open the object manager page
- Click on Page Layouts and select the layout that you want to edit
- Drag and drop the Akeneo Product Category Products related list onto the layout
- Adjust the columns of the related list to display Name, Product Category
- Save the layout, and you should see the related list now
Once you complete a transfer of a category tree from Akeneo, you will be able to access each category to which the product is assigned directly from your product-related lists.
