Manage Your Akeneo Store

Import and manage your Akeneo products in Describely!

In this article

Connect your Akeneo store

Before you connect: Akeneo takes their security seriously so there is a multi-step setup process to connect with Describely. We've provided both a video and written walkthrough for you below, but you can also schedule 25 minutes with our team to go through the steps together. This connection only needs to be set up once!

  1. From the left-hand toolbar, click Import Products. If you're connecting your store through our initial onboarding, skip to step 2.
  2. Select Akeneo as your Catalog type.

  3. You'll be prompted to connect your store using your Akeneo URL, Client ID, Secret code, Username, and Password. To access this information, log in directly through the Akeneo website and follow the steps below.
  4. Within Akeneo, click System on the left sidebar. Under the Users Management Navigation, select Users.

  5. On the left, look for the User Management Navigation section and click Roles.
  6. On the top right, click the green Create Role button to set up a new role for Describely.
  7. Select the General tab and enter a name for the role. You can name it anything, but we recommend "Describely."
  8. Select the Web API permissions tab. Check the boxes next to ALL fields to be sure everything is successfully imported from your store.
  9. On the top right, click the green Save button.
  10. Now that Describely's role has been created, click Connect on the left sidebar to begin setting up your Describely store connection.
  11. Under the Connect Navigation on the left, select Connection settings.


  12. On the top right, click the green Create button.
  13. Enter a name for your connection label (we recommend "Describely Connection", choose Flow type "Other" from the drop-down, and click the green Save button.
  14. On the next page, navigate to the Permissions section on the bottom right.
  15. Under Role, choose Describely (or the name of the new role you created in step 7) from the drop-down.
  16. Under Group, choose your account's user group that grants permission to view and edit ALL of your store's attribute groups. 
    Note: The group you need to select will depend on how your user and attribute groups were customized in Akeneo. To manage your store's attribute groups, click Settings from the left sidebar and navigate to Attribute Groups.
  17. Click the green Save button on the top right.
  18. Copy your website's main domain URL from your search bar and paste it into Describely's Akeneo URL field. DO NOT include the https:// portion of the URL. 

  19. Back in Akeneo, navigate to the Credentials section on the right to view your Client ID, Secret code, Username, and Password. 
    Note: This code will only appear once before Akeneo hides it from view. If you don't successfully copy this code into Describely or save it elsewhere, you'll have to delete the connection and start the process from scratch to generate new credentials.
  20. Click the icon to the right of each field to copy it and paste it in Describely.
  21. Within Describely, click the gray Next Step button.
  22. Select your Akeneo store's locale and channel from the drop-down. 
    Important: Currently, only one locale and one channel can be imported to each Describely catalog. You can import multiple Akeneo catalogs for additional locate/channel combinations.


  23. Click the gray Next Step button. 
  24. Match the fields in Describely to your Akeneo attributes by selecting them from the drop-downs. This step is to control where your store's product information will import into Describely.
    Note: If you'd like to add images, click the +Add Image button at the bottom and choose the matching attribute.

  25. Click the gray Import Products button.
    Note: Product images cannot be imported into Describely in bulk. These can be synced after import from the Product Details tab of each individual product.

Voila! Your Akeneo store is now connected to Describely. Now you're ready to jump right into creating your content rules and generating content in bulk!

Need to import new products after you've connected? Within your catalog, click the Sync button at the top! Select Continue to Download to import batches of 5,000 products at a time. Learn more about syncing from your store here.

Note: If you need to change how your fields are matched after your products are imported, click the Field Matching button on the top right of your catalog. After saving your changes, click Sync to re-sync your Akeneo store to Describely. 

Generate content in bulk

Looking to scale your product content creation? Learn how to create and optimize product titles, descriptions, meta tags, and more for multiple products at once in this article.

Generate content individually with chat

Want to refine each of your product's content individually? Learn how to use Describely's chat feature to perfect your content one product at a time here.

Manually update individual products

  1. From your Akeneo catalog, click the name of the product you'd like to work on. 
  2. From the Product Details tab, make your edits or add formatting if you'd like, and click Save Changes
  3. If you're ready to push the changes to your store, click the Publish to Akeneo button on the top right. Voila!