Read More
Read More
Menu Close

    BigCommerce Akeneo Connector

    BigCommerce Akeneo Connector allows you to connect your BigCommerce store with the Akeneo PIM platform. With the help of this integration, you can manage your entire catalogue from Akeneo.

    Using this module, you can export products, categories, product options, attributes, custom fields, and multiple images, from Akeneo to the BigCommerce store. 


    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, 4.0.x and 5.0.x. Download Akeneo from here
    • Node and Yarn packages need to be installed.
    • This module is compatible with the Akeneo PIM Community Edition, Growth Edition, and Enterprise Edition.
    • If you want to use this extension on Akeneo EE Serenity mode, please contact us.
    • For the Akeneo installation, your Akeneo server should meet these system requirements.

    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


    Features – BigCommerce Akeneo Connector 

    • 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, and 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 the metric unit.
    • Import Category, Attribute, Attribute Option, Family, Product and Product Model from BigCommerce to Akeneo.
    • Able to export Metrics attribute type in the custom field.
    • When exporting Metrics type, added the Unit to the end of the number.
    • Ability to export multiple select field attribute types and each option is separated by a comma.
    • You can add any number of credentials.
    • This module is compatible with the latest Akeneo version 5.0.x
    • Choose which products to export using various filters- category, family, completeness, time conditions, locale, and 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 the 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 the API Path URL.

    Searching for an experienced
    Akeneo Company ?
    Read More

    create api account

    After that, you need to select the ‘modify‘ scope for ‘Products‘ and Information & Settings options after that click to Save.

    modify products permission


    Once, you click the 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.

    API credentials created

    Installing a module for Version 4.0.x to 5.0.x

    1- Composer Installation

    Read This Blog

    2- Manual Installation

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

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



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


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


    4. You have to navigate first to the 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.

    For Akeneo 5

    For Akeneo 4

    To run the Quick export in Akeneo 5.0.x, you need to run the below command.

    Install composer dependency

    After that, register the bundle in config/bundles.php

    Define routing to create a file in the config/routes/wk_quick_export.yml


    Docker Installation Command :

    For Akeneo 5

    For Akeneo 4


    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 the “src” folder into Akeneo project root directory.

    Upload Webkul src folder

    2. Goto app/AppKernel.php and add a line

    in function registerProjectBundles()

    Add code in AppKernel.php file

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

    Add code in routing.yml file

    4. You have to navigate first to the 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
      Webpack errorIt 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 the ‘Yes’ value for the ‘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 the Akeneo attributes to BigCommerce custom fields in these attributes are supported like text, text area, metric type, simple-select, boolean, date, number, 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 set is used for 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 to 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 the Product option. select productAfter that entered, SKU and then chooses a product family. select 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.

    fill product information

    Select Attribute

    For adding product information, select the attribute options you require. You can also create new options for the attribute. The 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.other details

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

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

    pricing details

    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.

    Add attribute option

    Upload Images

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

    Multi-Lingual Information

    Add information for other languages and store views.

    Change multi-lingual information

    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.

    select category

    BigCommerce Export Job

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

    After saving the profile go to the Content section and select the 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 the SKU value in the identifier section.


    After that, you can select credentials and the click Save button.



    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 the Products list.

    product 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 the Akeneo Connector configuration, they will appear here as well.


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


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


    Purchasability with this you can manage the product availability 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.

    categories created

    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.

    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, descriptions, warranty information, related product and much more.

    product page information

    Import Profile

    Now you can now import your product catalog data from Bigcommerce to Akeneo. There are various job profiles available for importing Category, Attribute, Attribute Option, Family, Product and Product Model from Bigcommerce to Akeneo.


    To do the import go to Imports>Create Import Profile, enter a code and label. The following job profiles are available:


    Once you have selected the import job profile.


    After that from the Content section, you can select the channel and locales for importing product data. 


    Setup Credentials – In case you are managing multiple Magento stores, you can provide separate API credentials for each Magento store individually.


    Once everything is set up correctly, you just need to click the Import Now button then the import execution process will start.  




    Thank you for reading this documentation. In case you find anything missing or not explained correctly, or you have any customization needs, reach out to us at [email protected]. You can also raise a ticket at our HelpDesk System.

    Please explore our Akeneo Development Services and Quality Akeneo Extensions.



    Current Product Version - 4.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, 5.0.x

    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, 5.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, 3.2.x, 4.0.x, 5.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
    . . .
    Discuss on Helpdesk

    Leave a Comment

    Your email address will not be published. Required fields are marked*


  • megha
    Does this work with variants in Bigcommerce and Akeneo?
    • Adarsh Shukla (Moderator)
      Hello Megha,
      Yes, it works with variant products in BigCommerce and Akeneo. For more details, you can create a ticket here:
  • Back to Top

    Table of Content