> ## Documentation Index > Fetch the complete documentation index at: https://cloudinary.com/documentation/llms.txt > Use this file to discover all available pages before exploring further. # Akeneo PIM Integration ## Overview > **INFO**: Effective August 29, 2024, Cloudinary discontinued support for the legacy Cloudinary Akeneo PIM integration. No new functionality or fixes are available. Although existing users may continue to utilize the legacy integration app AS IS, we highly recommend syncing your Akeneo media to Cloudinary using the [MediaFlows](https://home.mediaflows.cloudinary.com/sync-assets-to-akeneo) low-code workflow engine. MediaFlows enables seamless integration between Cloudinary and third-party services like Akeneo, empowering you to streamline media processing across platforms. For more information, see the [MediaFlows - Akeneo](mediaflows_block_reference#integrations) documentation. The **Cloudinary Akeneo PIM integration** provides a solution for connecting your Cloudinary media to your products in your PIM. Take advantage of Cloudinary's advanced media management features to manage your product media before linking it with Akeneo. Your media will be automatically added to the Akeneo Asset Manager and linked to a product. > **INFO**: > > * The Akeneo integration must be enabled by Cloudinary before you can start using it. Contact [customer support](https://support.cloudinary.com/hc/en-us/requests/new) or your Cloudinary Customer Success Manager for more information. > * The Cloudinary Akeneo PIM integration is only available for the Akeneo Enterprise Edition. ## Setup The Akeneo PIM integration setup must be completed with the assistance of our support team. If you want to enable the integration [open a ticket](https://support.cloudinary.com/hc/en-us/requests/new) and the team will help you through the required steps, as outlined below. Open the Akeneo PIM integration setup wizard. This wizard walks you through the following: 1. **Configuring the Cloudinary notification URL** - The wizard provides you with a dedicated webhook notification URL. Copy this URL and paste it into the **Notification URL** field in the [Webhook Notifications](https://console.cloudinary.com/app/settings/webhooks) page of the Console Settings. ![Where to add notification URL](https://cloudinary-res.cloudinary.com/image/upload/f_auto/q_auto/bo_1px_solid_grey/v1695799089/docs/integrations/akeneo_setup_webhook.png "thumb: w_600,dpr_2, width:600, popup:true") 2. **Connecting to Akeneo** - Create a new [Akeneo connection](https://help.akeneo.com/pim/serenity/articles/manage-your-connections.html#create-a-connection). Add the credentials from your new connection the relevant fields in the wizard. Enter the name of your Akeneo installation in the **Service Account** field, for example `my-akeneo-instance.cloud.akeneo.com`. > **INFO**: Ensure that your connection is assigned a role and group with the [correct permissions](https://help.akeneo.com/pim/serenity/articles/manage-your-connections.html#set-the-permissions). ![Akeneo connection settings](https://cloudinary-res.cloudinary.com/image/upload/q_auto/f_auto/docs/Akeneo/pim_settings.png "thumb: w_600,dpr_2, width: 600") 3. **Connecting to Cloudinary** - Connect Akeneo to your Cloudinary account by clicking the **Connect to Cloudinary** button. Follow the instructions to log in to your account and select your product environment. After you complete the Akeneo PIM integration setup wizard, Cloudinary will enable the Akeneo integration DAM app. This will add an additional option to your Media Library to support [linking your media](#link_your_media) to your products. ## Link your media Once setup is complete and the Akeneo DAM app is enabled, you can start linking your media to your products. To link an asset, open the [Media Library](https://console.cloudinary.com/console/media_library) and find the asset you want to link. Right-click the asset and select the **Link to Akeneo** option, as shown below. ![Link to Akeneo option](https://cloudinary-res.cloudinary.com/image/upload/q_auto/f_auto/w_0.8,c_crop/docs/Akeneo/link_to_akeneo.png "thumb: w_600,dpr_2, width: 600") You will then be presented with a UI that allows you to specify the relevant Akeneo product information, such as the SKU for the product you want to link the media to. ![Add media link](https://cloudinary-res.cloudinary.com/image/upload/f_auto/q_auto/v1695799608/docs/integrations/akeneo_image_linking.png "thumb: w_600,dpr_2, width: 600, popup:true") The available fields are: * **SKU** - *Required*. The SKU of the product you want to link the media to. * **Product attribute** - *Required*. The product attribute of the product you want to link the media to. e.g. "images". * **Asset attribute** - *Required*. The asset attribute to add the media link to. e.g. "link_atmosphere". * **Asset family** - *Required*. The asset family to add the media to, e.g. "atmosphere". [//]: # (These fields are not currently supported:) [//]: # (* **Locale** - *Optional*. The locale of the product you want to link the media to. e.g. "en_US".) [//]: # (* **Category** - *Optional*. The category of the product you want to link the media to. ) > **NOTE**: There is a 200 character limit for all fields combined when adding a link. Once you've filled in the relevant fields, click the **Add new link** button. Your media will now include an additional tag which contains all the information Akeneo needs to process the link. Your media will be added to the Akeneo Asset Manager and your products will be updated with the media asset. You can now browse to Akeneo and see all your media assets in the Akeneo Asset Manager and linked with your products: ![Asset in Akeneo](https://cloudinary-res.cloudinary.com/image/upload/q_auto/f_auto/bo_1px_solid_gray/docs/Akeneo/akeneo_asset.png "thumb: w_600,dpr_2, width: 600") ![Product in Akeneo](https://cloudinary-res.cloudinary.com/image/upload/q_auto/f_auto/bo_1px_solid_gray/docs/Akeneo/akeneo_product.png "thumb: w_600,dpr_2, width: 600") ### Add links in bulk To add links in bulk, programmatically add tags to your assets using the `tags` method of the [Cloudinary Upload API](image_upload_api_reference) or `add_tag` method of one of our [Backend SDKs](backend_sdks). The tags should resemble the tags that get added to your media when linking using the **Link to Akeneo** UI option in the Media Library, as explained above. The structure is as follows: sync_akeneo;id_\;pa_\;aa_\;af_\;l_\;c_\ To add the tags in bulk, create a script that loops through the public IDs of the assets and adds the tags with the relevant information to them. ### Delete links You can remove any links you have created through Cloudinary from the same **Link to Akeneo** option. From here, open the menu on the link you want to remove and select **Delete link**. Once you've deleted a link, your Akeneo products will be updated accordingly. However deleting a link will not remove the media from the Akeneo Media Manager.