Akeneo Shopware Connector

Akeneo PIM compatibilty
Price: Quote based


The Akeneo Shopware Connector by HDNET


The Connector is a command line tool for exporting your catalog and product data from Akeneo to Shopware. The connector can export the following data:

  • Categories
  • Families
  • Attributes
  • Products
  • Product models
  • Variants

In the one-off configuration, you specify, among other things, which Akeneo Channel your Shopware products are managed with. In addition, you make a one-time mapping in the configuration that you can use to determine which Akeneo attributes should be matched to which Shopware article master data.

Once you have configured the settings, you can execute the following export commands in the command line tool:

  • ./connector.phar categories
  • ./connector.phar families
  • ./connector.phar products

Additionally, you can configure these commands as cronjobs on your server so that the export from Akeneo to Shopware is fully automated.

We are happy to assist you with the one-time configuration of the connector. Visit our website or contact us directly!


  • Shopware: Version 5.3.* and higher
  • Akeneo: Version 2.2 and higher (CE or EE)
  • API user for both Shopware and Akeneo
  • Basic knowledge of Symfony's ExpressionLanguage (optional)
  • Basic knowledge of command line usage
  • Possibility to configure cronjobs (optional)

Release notes

The current version of this connector is 1.0.0 (Release date: 25.07.2018). This version provides the most important functions for the enrichment of your Shopware shop.

Currently, it supports one channel and one locale.

The software is consistently being developed according to customer requirements so that further features can be published in the future.

It is compatible with both Community and Enterprise Edition.


Installation of Akeneo Shopware Connector

Preparing Akeneo

If using product models and variants, create a "Text" attribute on the common level that refers to the code of the variant that should be used as the main article in Shopware. The default attribute name is `shopware_main`. If the attribute value is empty, the connector will use the first variant of the product model returned from the Akeneo API as the main product in Shopware.

Preparing Shopware

Create required free text fields with the name `akeneo_code` on:

  • categories (table s_categories_attributes)
  • item property (table s_filter_attributes)
  • property groups (table s_filter_options_attributes)
  • property options (table s_filter_values_attributes)

Optionally you may also add custom free text fields for additional article attributes on:

  • item (table s_articles_attributes)


Run the connector once to create the configuration files:

  • ./connector.phar

During the first run, it will create the configuration files `parameters.yaml` and `.env`, so you should run it in an new, empty directory for each of your projects, to avoid accidentally using existing configuration files.
Then edit the entries in parameters.yaml and .env to match your environment.

Test environment

All initial configuration is done!

To test your configuration and product setup, you can now run the following commands in the command line tool:

  • Categories: ./connector.phar categories
  • Families/Property Sets: ./connector.phar families
  • Attributes and Products: ./connector.phar products


Import commands

There are three different commands to use via command line tool to import your product data from Akeneo to Shopware:

  • Categories: ./connector.phar categories
  • Families/Property Sets: ./connector.phar families
  • Attributes and Products: ./connector.phar products

If you need a list or further information about the commands, simply run:

  • ./connector.phar help

List your extension on Akeneo Marketplace

Learn about the best practices to enrich Akeneo ecosystem.

Share your contributions with Akeneo Community any way you want.

Need help? Please read our manual