When you set the Assets Target Mode to Standard in your global settings, the connector bypasses the Akeneo custom media objects. Instead, it injects your PIM images, manuals, and documents directly into the native Salesforce CMS Framework and links them as standard ProductMedia records.

Prerequisites

Before switching your assets synchronization to Standard mode, you must prepare your Salesforce CMS infrastructure.

Enable Salesforce CMS & Create an Enhanced Workspace

Your PIM assets need a dedicated home inside Salesforce. You must set up a CMS Workspace:

1. Open the Salesforce CMS app from the App Launcher
2. Click Add Workspace
3. Choose an Enhanced CMS Workspace, name it clearly (e.g., Akeneo Assets), and complete the wizard
4. Important: Note down your CMS Workspace ID, as you will need it for the connector's settings

Request CMS API Access Permissions

Salesforce enforces strict security guardrails on its CMS integration endpoints.

• Critical Requirement: Your organization must have the specific backend permission named Salesforce CMS: PIM integration APIs active. If this feature is missing or disabled, the connector will throw an explicit error during asset transfers.

Configure Channels and Trusted URLs (CSP)

Because Akeneo delivers media via external asset URLs, Salesforce CMS needs permission to fetch and render these files:

• Ensure your CMS Workspace is mapped to the correct Channel (your B2B/B2C Commerce Storefront channel)
• Go to Setup > Trusted URLs. Whitelist your Akeneo PIM instance domain name and enable the img-src (Images) directive. This allows Salesforce to securely display images on your storefront without security policy violations.

Configuration & Activation Steps

To successfully route assets to Salesforce CMS, follow this two-step process:

1. Map your Asset Collections: You must define your media categories (e.g., PDP, PLP) and switch their technical structure to Object or Array of Objects to support rich CMS metadata (Name, URL, Alt Text). Please follow the step-by-step fields guide in our main section: App Settings & Advanced Configuration > Configure Product Asset Mappings
2. Open the Akeneo Connector Configuration (either via the App Homepage or via Salesforce Setup > Custom Metadata Types > Akeneo Connector Configuration > Manage Records)
3. Open your main Akeneo Connector Configuration record
4. Locate the Assets Target Mode field
5. Change the value from Akeneo Custom Objects to Standard
6. Locate the CMS Workspace ID field and paste your Salesforce Enhanced CMS Workspace ID
7. Click Save

Data Mapping Reference

When Standard mode is active, the connector automatically transforms Akeneo assets into native Salesforce CMS components using this logic:

• Asset Name ➔ CMS Content Name / Title: Becomes the searchable name within your CMS workspace
• Asset URL ➔ CMS Image Source URL: Must be a durable, publicly accessible URL so that Salesforce CMS can render it live on the storefront
• Alt Text ➔ CMS Image Alt Text: Automatically mapped to preserve storefront accessibility compliance
• Media Type ➔ Product Media Usage: Maps your custom media type (e.g., PDP, PLP, Attachment) directly to standard storefront display locations

Validation Strategy

To verify that your media pipeline is fully operational:

1. Run a test transfer on a single product that contains at least one image asset in Akeneo.
2. Go to your Salesforce CMS Workspace and verify that a new managed content record has been created with the correct title and external public URL.
3. Open the standard Product2 record in your Commerce App, check the native Media tab, and confirm that the image renders properly as a storefront-ready asset.