Menu Close
    Start a Project Request quote Reading list Switch to dark mode
    Blog Version - Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x, 4.0.x
    • Version Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, and 3.1.x
    • Version Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x, 4.0.x
    • Version Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x and 3.2.x

    BigCommerce Akeneo Connector

    BigCommerce Akeneo Connector allows you to connect your BigCommerce store with Akeneo PIM platform. With the help of this integration, you can manage your entire catalog from Akeneo. Using this module, you can export products, categories, product options, attributes, custom fields, multiple images, from Akeneo to BigCommerce store.

    Please Note – BigCommerce Akeneo Connector is compatible with Community Edition, Enterprise Edition, and Cloud (PaaS/Flexibility) Edition of Akeneo.

    Basic Requirements:

    • This module works with Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x and 4.0.x. Download Akeneo from here
    • Node and Yarn packages need to be installed.

    Video Tutorials

    Check out the following video tutorials below:

    How to get API keys?


    How to do module configuration?


    Exporting Simple Product from Akeneo to BigCommerce



    • Create product categories from Akeneo.
    • Export selected attributes as custom fields from Akeneo to the BigCommerce store.
    • Send multiple images of a product including variations.
    • Mention SEO information, inventory, pricing, shipping, other details in products.
    • Option to set fixed values for all exported products.
    • With the help of UI Mapping Export Custom Field’s Default Value.
    • Export the value of the variant in the custom field.
    • Remove the 0s at the end of the number of metric unit.
    • Able to export Metrics attribute type in the custom field.
    • When export Metrics type, added the Unit to the end of the number.
    • Ability to export multiple select field attribute type and each option separated by a comma.
    • You can add any number of credentials.
    • This module is compatible with latest Akeneo version 4.0.x
    • Choose which products to export using various filters- category, family, completeness, time conditions, locale, currency.
    • Use identifier (SKU) for exporting specific products to the BigCommerce store.

    BigCommerce API Credentials

    Before you begin, you need to obtain API credentials from BigCommerce control panel. Log in to your store then follow Advance Settings>API Accounts>Create API Account. Now enter any name for this API account then copy API Path URL.

    After that, you need to select ‘modify‘ scope for ‘Products‘ then click Save button.

    Once, you click Save button; the API credentials will be visible to you, please copy them securely. Also, a text file will be downloaded automatically containing these credentials.

    Installing Module  for Version 2.x to 3.x

    For installing this module in Akeneo, please follow the below steps as mentioned:

    1. Unzip the respective extension zip then merge “src” folder into akeneo project root directory.

    2. Goto app/AppKernel.php and add line

    new Webkul\BigCommerceBundle\BigCommerceBundle(),

    in function registerProjectBundles()

    3. Goto app/config/routing.yml then add these lines at the top of file

    4. You have to navigate first to Akeneo installation directory (Ex: cd /opt/bitnami/apps/akeneo/htdocs). After SSH, you have to run the command to your Akeneo server by the terminal.

    5. If you are using php-fpm. Then you need to restart the php-fpm services and apache web server.

    Installing a module for Version 4.0.x

    For installing this module in Akeneo, please follow the below steps as mentioned:

    1. Unzip the respective extension zip then merge “src” folder into akeneo project root directory.


    2. Goto config/Bundles.php and add line:

    3- Copy the “config” folder into akeneo project root directory for routing.

    4. You have to navigate first to Akeneo installation directory (Ex: cd /opt/bitnami/apps/akeneo/htdocs). After SSH, you have to run the command to your Akeneo server by the terminal.

    5. If you are using php-fpm. Then you need to restart the php-fpm services and apache web server.

    Common Issues After Installation

    It might happen that even after proper installation, upon opening your Akeneo admin dashboard, you see a loading screen. In that case, do check for the following solution:

    • Webpack Installation: If you get the below error

      It means that webpack is not installed in your system. Run the following command


    • Module routing.yml is not configured properly. Re-check the routing.yml file as mentioned in the 3rd step of Module Installation
    • Clear your browser cache.

    Setup Credentials in Akeneo

    After successfully installing the BigCommerce Akeneo Connector module, please log in to your Akeneo platform then navigate to BigCommerce Connector>Setup Credentials.


    After that click on the Create Credentials. The following page appears, when you need to enter the following:

    • API Path
    • Client ID
    • Client Secret
    • Access Token



    You can add multiple credentials in BigCommerce Akeneo Connector. You  need to activate the credentials to export the products from Akeneo to Bigcommerce. The active credential will be visible at the time of creating an export profile.

    You can also enable the option to Quick Export the products from the Akeneo product grid.

    • Activated
    • Default for QuickExport

    Attribute Mapping

    You need to do the attribute mapping of Akeneo attributes with BigCommerce product fields. While exporting products from Akeneo to BigCommerce, various information is sent to your e-commerce store. You can send the following product information from Akeneo:

    • Name
    • Price, Cost Price, Retail Price, Sale Price.
    • Tax Provider Tax Code
    • Product SKU
    • Weight, If weight is zero, it will become a downloadable product in the BigCommerce store.
    • Width, Height, and Depth
    • Description
    • Shipping – Free Shipping and Fixed Shipping Price
    • Multiple Images
    • Inventory Tracking – Current Stock Level and Low Stock Level
    • Brand Name
    • Product UPC/EAN Number
    • Bin Picking Number
    • Call for Pricing
    • Search Keywords
    • Visible
    • Featured Product
    • Sort Order
    • Minimum Purchase Quantity and Maximum Purchase Quantity
    • SEO – Page Title, Meta Keywords, Meta Description


    Fixed Value for All Products

    On the right, you can provide a fixed attribute value of the exported products. For example, if you want all the exported products to become visible on the BigCommerce store, you can enter ‘Yes’ value for ‘Is Visible’ attribute.

    Other Mappings

    In this section, you need to mention those Akeneo attributes which include the product images. Further, you need to specify those custom fields for BigCommerce products.

    The attribute in BigCommerce:

    Now you can also export  Akeneo attribute to BigCommerce custom fields in these attributes are supported like text, text area, metric type, simple-select, and multi-select

    The attribute in BigCommerce:


    Quick Export Currency Mapping

    In this section, you can set the default currency while exporting the product via quick export.


    Other Setting

    Log setting

    Log setting is used for the checking the API logs like what we have exported and imported in Akeneo. For it, You have to enable the request and response log.

    Enable API request Logs: By enabling this, we can download and check all the import jobs.

    Enable API response Logs: By enabling this, we can download and check all the export jobs.

    Other Setting

    In this, you can export metric value to the BigCommerce custom field. 

    The attribute in BigCommerce:


    Creating Products in Akeneo

    After setting up the BigCommerce Akeneo Connector module, you can export your products from Akeneo. In this section, I will explain to you how to create a product in Akeneo. If you have already created or imported your products in Akeneo, you can move on to the next section and skip this part.

    To create a new product in Akeneo follow Products>Create then select Product option. After that enter, SKU then chooses a product family.

    Add Product Details

    Now, you need to fill in all the production information for this new product. Please note that only the mapped attributes product information will be sent from Akeneo to the BigCommerce store. So, kindly make sure all the product fields are correctly mapped with Akeneo attributes.

    Select Attribute

    For adding product information, select the attribute options you require. You can also create new options for the attribute. Following Attributes from Akeneo are supported for export:

    • Text
    • Text Area
    • Number
    • Date
    • Boolean
    • Select
    • Price
    • Metric
    • Image
    • Reference data select
    • Reference data multi-select
    • File

    You can mention various information about the product – name, description, SEO information, inventory, shipping, pricing, and other details.

    SEO Information – Mention page title, meta description, and meta keywords.

    Pricing Information -Mention cost price, sale price, retail price, fixed shipping price, and normal price.

    Add New Option Attribute

    If an attribute option is missing for a select attribute type (simple or multi-select), you can directly add it to the Product Edit Form. Enter a Code and Label values, then click Save.

    Upload Images

    Upload multiple images of a product  export them to the BigCommerce store.

    Multi-Lingual Information

    Add information for other languages and store views.

    Select Categories

    Now you need to select a category for the product. You can also choose more than one category for a product. If a category is not available in Akeneo, the module will automatically create a new category in the BigCommerce store.

    BigCommerce Export Job

    Once you have created or imported the products in Akeneo, you can now move forward to the export process. To do that please go to Exports>Create Export Profile then enter any code, label after that select ‘BigCommerce Export Job‘ option.

    After saving the profile go to the Content section and select your channel where your products will be exported. You can also choose the locales for deciding in what language you will be sending the content. Select currency according to your store.

    In case you have too many products in Akeneo and want to export only a few products, you can use various filters. You can filter products based on family, status, completeness, category, and time condition. Further, if you want to export only one or more products, you can do that by entering SKU value in the identifier section.

    Run Export Job

    Once you have saved the export profile information, you can now click the Export Now button after that wait for the execution process to get completed.

    You can see the progress of the export process as below. Moreover, if there is any error you can also see it here.

    View Exported Products in BigCommerce

    Once the execution process is completed, you will see the Akeneo product in BigCommerce. Log in to your BigCommerce admin panel then go to Products list.

    You can make any changes to the exported product and modify or update any information.Every product detail which is mapped between Akeneo and BigCommerce will be imported and can be seen here. If weight is not mentioned in Akeneo, it will become a downloadable product in BigCommerce automatically.

    Upload multiple images of a product and send them to the export product database.

    Inventory Tracking information is also exported from Akeneo.

    Custom Fields allows you to mention more information about a product. If custom fields are correctly mapped in Akeneo Connector configuration, they will appear here as well.

    Storefront Details such as Search keywords, Warranty Info, Sort Order, Condition as mentioned in the Akeneo are visible in this section.

    Purchase quantity information and SEO information are also sent to BigCommerce store.

    Purchasability with this you can manage the product availabilty and available quantity.

    Categories are also created from Akeneo. So if you have a product category in Akeneo but not there in BigCommerce, the Akeneo Connector module will automatically create categories while exporting the products.

    Exported Products on Storefront

    Now, let’s see how exported products appear on the storefront. You can see the product name, price, SKU, UPC, purchase quantity information, custom fields information, etc. on the product page.

    Once the export job is finished in Akeneo, the exported products will be available to the customers for purchase. The customer can see the multiple images, description, warranty information, related product and much more.


    Thank you for reading this documentation. In case you find anything missing or not explained correctly, or you have any customization needs, then please send a mail to

    Current Product Version - 3.0.0

    Supported Framework Version - Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x, 4.0.x

    . . .

    Comments (2)

    Add Your Comment

  • megha
    Does this work with variants in Bigcommerce and Akeneo?
    • Adarsh Shukla
      Hello Megha,
      Yes, it works with variant products in BigCommerce and Akeneo. For more details, you can create a ticket here:
  • Back to Top
    Hire Us!
    Brief us about your requirements and we'll get back to you.
    Woo! Hooy!
    We have just recieved your project brief and our expert will contact you shortly.
    Send Again

    Table of Content

    Hide Index