Skip to content
Setup your Akeneo PIM data with a single init.xls file
Branch: master
Clone or download
mmetayer Merge pull request #68 from pchasle/patch-1
Revert PIM dependency to version >=3.0 <4.0
Latest commit daa0d12 Apr 29, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.ci Pim 3.0 compatibility (#66) Feb 6, 2019
src Pim 3.0 compatibility (#66) Feb 6, 2019
.gitignore Prepare 1.2.5 version (#47) Sep 5, 2017
.php_cs.php Jenkinsfile Mar 2, 2017 Add categories step to import job (#56) Dec 1, 2017 PIM 2.2 migration (#62) Mar 15, 2018 Prepare 1.2.5 version (#47) Sep 5, 2017
LICENCE.txt Initialize bundle from Excel Connector Bundle Aug 25, 2016 Pim 3.0 compatibility (#66) Feb 6, 2019
docker-compose.yml Pim 3.0 compatibility (#66) Feb 6, 2019

Excel Init Bundle

Build Status

alt text

This bundle adds support of Excel XSLX files as a source for initializing catalog structure for Akeneo PIM.

This extension replaces the ExcelConnectorBundle for Akeneo PIM >= 1.6. Be carefull to use the new init.xlsx file of this bundle as there are some structure modifications.

Note: this bundle is not compatible with Excel 2003 xls files. Editing the XLSX file with LibreOffice/OpenOffice is also not supported as it can lead to unwanted behavior.


ExcelInitBundle Akeneo PIM Community Edition
v3.0.* >= v3.0
v2.1.* >= v2.2 - < 3.0
v2.0.* v2.0 - v2.1
v1.2.* v1.7.*
v1.1.* v1.6.*
v1.0.* v1.6.*


From your application root:

    php composer.phar require --prefer-dist akeneo/excel-init-bundle:3.0

Enable the bundle in the app/AppKernel.php file in the registerProjectBundles() method:

    $bundles = [
        // ...
        new Pim\Bundle\ExcelInitBundle\PimExcelInitBundle(),

Now let's clean your cache and dump your assets:

    php bin/console cache:warmup --env=prod
    php bin/console pim:installer:assets --env=prod


Getting started

See doc/Getting started for more details on how to set your catalog structure using the init.xslx file.

See doc folder for more details on how to set your catalog structure.

Supported file

Input file must follow init.xslx structure.

Note that the file should be opened with Excel. LibreOffice/OpenOffice are not fully in compliance with validations data that are available in the spreadsheet.


The import fails when importing families

Check that your channels names are correct in both family and channel tabs. You might have a typo in the channels tab and not in the family tab. You will have to remove the mispelled channel once you corrected this.

Dev notes

Unit tests

You can launch the PHPSpec tests with the provided docker-compose.yml file:

docker-compose pull
docker-compose up -d
docker-compose exec fpm composer install --prefer-dist
docker-compose exec fpm ./bin/phpspec run
You can’t perform that action at this time.