Akeneo Integration
Using Raspberry with Akeneo
Raspberry AI integrates with Akeneo, the Product Information Management platform used by large retail and fashion brands to manage product catalogues, media assets, and storefront-ready content. Export AI-generated images directly onto specific assets in your Akeneo catalogue — targeted to the exact Asset Family, Asset, and Media Attribute where the image belongs.
PIM Platform
Jump to
Raspberry Capabilities for Akeneo Customers
Akeneo is the system of record for product data — including the media assets attached to each product. Teams use it to enrich product catalogues with descriptions, attributes, and images before pushing them to storefronts and marketplaces.
The Raspberry AI integration removes the friction of downloading images and manually uploading them through the Akeneo UI. Instead, exports target the precise location in your catalogue — Asset Family → Asset → Media Attribute — and place the image there in one action, at full quality.
Key benefits
Export Directly to a Specific Akeneo Asset
Send any AI-generated image to an exact location in your Akeneo catalogue. No downloads, no manual uploads, no navigating the Akeneo UI to find the right asset.
Precise Catalogue Targeting
Every export targets a specific Asset Family, Asset, and Media Attribute so images land exactly where they belong within your existing catalogue structure.
Live data from Your Akeneo Instance
Asset families, assets, and media attributes are fetched live from your Akeneo instance at the point of export so you're always working with your current catalogue, not a cached snapshot.
No Quality Loss
Images are uploaded at full quality with no compression or conversion applied during transfer.
How teams use the Akeneo integration
Team
How they use the integration
Design
Export AI-generated product visuals directly onto the correct Akeneo asset without leaving Raspberry AI
E-commerce
Keep product catalogue media up to date with the latest approved visuals as soon as they're generated
Marketing
Attach campaign and lifestyle imagery to the right product assets for storefront and marketplace distribution
Cross-functional
Work from a shared asset library that supports faster delivery across channels
How to connect
Akeneo uses API credentials tied to your specific Akeneo SaaS instance. You will need the following before connecting:
Credential
Description
Store name
Your Akeneo subdomain — e.g. yourstore → base URL becomes https://yourstore.akeneo.cloud
Username
Your Akeneo user account username
Password
Your Akeneo user account password
Client ID
Akeneo instance → Settings → Connections → select or create a connection
Client Secret
Akeneo instance → Settings → Connections → select or create a connection
Steps:
Go to Organization Settings → Integrations.
Find Akeneo and click Connect.
Enter your store name, username, password, Client ID, and Client Secret
Click Connect — Raspberry authenticates and stores your credentials
Close the popup — you're connected
Note: Only Akeneo SaaS subdomains (*.akeneo.cloud) are supported. Self-hosted Akeneo instances are not currently supported.
Connecting is an admin action. Once an admin connects the organization's Akeneo account, all members of the org can use the integration to export.
To disconnect, return to Organization Settings → Integrations and click Disconnect.
Exporting to Akeneo
You can export from two places:
From the Create Module, right-click any generated image → Export To → Akeneo
From the Library — select one or more images → Export → Akeneo
Once you click export:
A form appears with three cascading dropdowns — each populated live from your Akeneo instance
Asset Family — select the family the target asset belongs to (e.g. packshots, lifestyle_images)
Asset — select the specific asset within that family (loads after a family is chosen)
Media Attribute — select which attribute on the asset should receive the file (e.g. main_image, thumbnail)
Click Export — the image is uploaded and attached to the asset
All three fields are required. The Asset and Media Attribute dropdowns only populate once an Asset Family has been selected.
Token Refresh
Akeneo access tokens expire automatically. The integration handles this in the background — tokens are refreshed using your stored credentials before the next request goes out. You should not need to reconnect unless you change your Akeneo password or revoke the API connection.
If you see an "Akeneo authorization expired" error, reconnect from Organization Settings.
Troubleshooting
Problem
What to try
"Invalid credentials" on connect
Double-check your store name, username, password, Client ID, and Client Secret — all five are required
Store name field shows wrong base URL
The preview auto-updates as you type — make sure the subdomain matches your Akeneo URL exactly
Asset Family dropdown is empty
Your API connection may not have read access to asset families — check permissions in Akeneo → Settings → Connections
Asset dropdown is empty after selecting a family
That family may have no assets yet — create assets in Akeneo first
Media Attribute dropdown is empty
That family may have no media-type attributes — check the family's attribute definitions in Akeneo
"Akeneo authorization expired" error
Reconnect from Organization Settings — your credentials or API connection may have changed
Export fails with "Unauthorized"
Your Akeneo API connection may have been revoked or the password changed — reconnect with fresh credentials
Export fails for a specific asset
The asset code or family may have been renamed in Akeneo — refresh and reselect the destination
Frequently asked questions
Do I need a separate Akeneo account?
Yes. The integration connects to your existing Akeneo SaaS instance. If you don't have an active Akeneo license, contact Akeneo's sales team directly.
Is self-hosted Akeneo supported?
Not currently. The integration supports Akeneo SaaS subdomains (*.akeneo.cloud) only. Contact your Raspberry AI account manager if you need support for a self-hosted instance.
Can multiple team members export to Akeneo?
Yes. Once an admin has connected the integration, all members of the organization can export assets to Akeneo.
What file formats can I export to Akeneo?
All standard Raspberry AI export formats are supported — PNG, JPEG, TIFF, PSD, and Adobe SVG. Assets are exported at full quality with no compression applied.
Does Akeneo have access to my other Raspberry AI generations?
No. Only the assets you explicitly export are sent. Nothing is shared in the background.
Can I disconnect the integration?
Yes. Go to Organization Settings → Integrations, find Akeneo, and click Disconnect. Your stored credentials are deleted immediately.
