Introduction
Akeneo Image Gallery allows you to add/manage images into various galleries and galleries into various groups according to requirements. You can easily manage photo galleries and gallery groups on their site.
Watch the video to understand the plugin workflow:-
Features
- Create a Media Gallery with multiple images, alt, title description, and assign groups.
- Create Group which will be used in Media Gallery.
- Export/Import Media Gallery
- Create a Media Gallery attribute and use it in the product family.
- Re-design your images with the UI tool.
- Can give permission to a different user to manage the image gallery.
Basic Requirement
- Akeneo Image Gallery module works with Akeneo 3.0.x, 3.1.x, 3.2.x, 4.0.x, 5.0.x, 6.0.x, and 7.0.x.
- This module is compatible with the Akeneo community and Enterprise(Flexibility) 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.
Installation
Two different types of module installation processes are available for the module.
- Composer Installation
- Manual Installation
Installation using Composer Installation
Before beginning the composer installation
1: Get the ACCESS KEYS [Create a support ticket]
2: In Akeneo composer.json, add our repository and the installation script.
For Akeneo 6.x and 7.x
{ "scripts": { "post-update-cmd": [ "vendor/webkul/imagegallerybundle/src/Webkul/ImageGalleryBundle/install/config.sh COMPOSER=true NO_DOCKER=true" ], "post-install-cmd": [ "vendor/webkul/imagegallerybundle/src/Webkul/ImageGalleryBundle/install/config.sh COMPOSER=true NO_DOCKER=true" ], "post-create-project-cmd": [ "vendor/webkul/imagegallerybundle/src/Webkul/ImageGalleryBundle/install/config.sh COMPOSER=true NO_DOCKER=true" ] }, "repositories": [{ "type": "composer", "url": "https://akeneorepo.webkul.com/" }] }
For Akeneo <=5.x
{ "scripts": { "post-update-cmd": [ "vendor/webkul/imagegallerybundle/composer_install.sh" ], "post-install-cmd": [ "vendor/webkul/imagegallerybundle/composer_install.sh" ], "post-create-project-cmd": [ "vendor/webkul/imagegallerybundle/composer_install.sh" ] }, "repositories": [{ "type": "composer", "url": "https://akeneorepo.webkul.com/" }] }
3: Use composer to install the extension
composer require webkul/imagegallerybundle
4: Complete the authentication form.
5: Send a Message of Success
6: Delete your browser’s cache.
Manual Installation for Version 6.x and 7.x
- After unzipping the appropriate extension zip, merge the “src” folder into the akeneo project.
- From the PIM directory, run the following command over the NO-DOCKER Instance.
./src/Webkul/ImageGalleryBundle/install/config.sh COMPOSER=false NO_DOCKER=true
- After that run the command below over the PIM directory’s DOCKER instance.
./src/Webkul/ImageGalleryBundle/install/config.sh COMPOSER=false NO_DOCKER=false
Manual Installation for Version 4.0.x to 5.x
Please follow these steps for installing Akeneo Image Gallery module in your Akeneo PIM platform.
1 – Unzip the respective extension zip then merge the “src” folder into akeneo project root directory.

2 – Goto config/Bundles.php then add line:
Webkul\ImageGalleryBundle\ImageGalleryBundle::class => ['all' => true],
in return array.
3 – Copy the “config” folder into akeneo project root directory for routing.

4 – Run this command after ssh to your akeneo server by the terminal.
php bin/console cache:warmup && php bin/console wk-gallery:setup:install
5– If you are using php-fpm. Then you need to restart the php-fpm services and apache web server.
For Akeneo 5
sudo service php-fpm7.3 restart
For Akeneo 4
sudo service php-fpm7.3 restart
Docker Installation Command :
For Akeneo 5
alias docker_php='docker-compose run -u www-data --rm php php'; alias docker_yarn='docker-compose run -u node --rm node yarn'; docker_php bin/console cache:clear --env=prod; docker_php bin/console pim:installer:assets --symlink --clean --env=prod; docker_php bin/console d:s:u --force; docker_yarn run webpack; docker_yarn run update-extensions; docker_yarn run less;
For Akeneo 4
alias docker_php='docker-compose run -u www-data --rm php php'; alias docker_yarn='docker-compose run -u node --rm node yarn'; docker_php bin/console cache:clear --env=prod; docker_php bin/console pim:installer:assets --symlink --clean --env=prod; docker_php bin/console d:s:u --force; docker_yarn run webpack; docker_yarn run less;
Manual Installation For Version 2.x to 3.x
Please follow these steps for installing Akeneo Image Gallery module in your Akeneo PIM platform.
1 – Unzip the respective extension zip then merge the “src” folder into akeneo project root directory.

2 – Goto app/AppKernel.php then add line:
new Webkul\ImageGalleryBundle\ImageGalleryBundle(),
3 – Goto app/config/routing.yml then add these lines at top of file Syndication: resource:
image_gallery: resource: "@ImageGalleryBundle/Resources/config/routing.yml" prefix: /
5 – Run this command after ssh to your akeneo server by the terminal.
php bin/console cache:warmup && php bin/console wk-gallery:setup:install
6 – If you are using php-fpm. Then you need to restart the php-fpm services and apache web server.
sudo service php-fpm7.2 restart
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

Uninstall Module: For Akeneo 6.x and 7.x
- From the PIM directory, run the command below over the NO-DOCKER Instance.
./src/Webkul/ImageGalleryBundle/uninstall/uninstall.sh COMPOSER=false NO_DOCKER=true
- Run the command below over the PIM directory’s DOCKER instance.
./src/Webkul/ImageGalleryBundle/uninstall/uninstall.sh COMPOSER=false NO_DOCKER=false
Set up in Akeneo
After installation of the module in Akeneo, you have to create the gallery Group attributes. You have to navigate Setting-> Attribute -> Create Attribute.

After that click on Create attributes then select click on Akeneo Image Gallery.

Now after clicking on the attribute, you have to enter the details.

For creating the product in Akeneo, you have to choose the family. So, you can assign the asset group attribute in a product family.

Create the Gallery in Akeneo
After the installation in Akeneo, You will find the Gallery icon.

After it, you have to click on the Gallery Icon then a new page will open then you have to click on “Image Gallery” button

You will find the add gallery and add group icon at the right of the screen.

Click on add group to create a new group.

After that, a new page will open. Fill in the code then click on to Save button.

Now to create a new gallery click on add gallery button.

After that enter, the code then click on to Save button.

Now clicking on the save button, the gallery management page will open. Here, you can upload the media.

After uploading the media, you can edit the asset with the media gallery module. In that, you can select the images thumbnail images as well as you can add a description of each image.

After clicking on the edit button, the image edit page will be open.

You can also add information about the media.
- Add To Favourites – You can enable the favorite icon. With it, You can filter the media.
- Title – Asset title explains about the media.
- Alternative text – With alternative text, you can add further more information about the media.
- Description – It describes the product media.

- Expiration Date – In this, you have to select the date by which the gallery will expire.
- Gallery Tag – These gallery tags will help you while filtering the products.
- Gallery Group – Select the group in which you want to assign the gallery.

You can click on the save button on the right corner of your page. Now you can see the gallery is added to the Gallery list.
After saving the gallery in the Gallery list, you can edit and delete the gallery.

Filter the Gallery in Akeneo Media Gallery
In Akeneo Media Gallery module, You can filter the gallery with the-
- Created At
- Updated At
- Favorites
- Description
- Groups

Filter With Created Time:
In this module, You can filter the gallery with created time. For this, you have to choose the operators.
- Between – You can filter the asset that you have created between two dates.
- Not Between – Can filter the asset that you have not created between two dates.
- More than – You can filter the asset after the selected date.
- Less than – You can filter the asset before the selected date

Filter With Updated Time:
In this module, You can filter the asset with updated time. For this, you have to choose the operators.
- Between – You can filter the asset that you have updated between two dates.
- Not Between – Can filter the asset that you have not updated between two dates.
- More than – You can filter the asset after the selected date.
- Less than – You can filter the asset before the selected date.

Filter The Favourites:
In this module, You can set the favorites asset. With it, you can filter the products. You will find three options on it.
- All – You can filter the all favorites and not starred products.
- Yes – Can filter all favorites products.
- No – You can filter the not favorites products.

Filter With Description:
In this module, You can filter the asset with description. For this, you have to choose the operator.
- Contains – The product description contains the text entered by you.
- Does not contain – The product description doesn’t contain the text entered by you.
- Is equal to – The product description is equal to the text entered by you.
- Starts with – The product description starts with the text entered by you.
- Is Empty – The product description is empty.

Filter The Gallery Group:
You can filter the asset with gallery groups. All the groups will be visible after clicking on the group icon.

Assign Media Gallery in Akeneo Products
To create a product in Akeneo, go to navigate to Products and click the Create button. Now, you need to choose product type – as Product or Product Model.

Now you have to enter the required SKU, choose a family, and click the Save button.

You can add/upload a gallery to the product with the gallery group attribute.

Now after click on the ADD/UPDATE button, you have to select the gallery that you want to add to the product.

After selecting the gallery, click on the confirm button.

After adding the gallery, click on the confirm button. Your product details will be shown on the product page.

Export Gallery
Create Export Job Profile
You can export assets from Akeneo Media Gallery Extension you can create an export profile.
To create a new export job profile, go to Exports>Create Export Profile

After that enter a code, label, and select job type to create new job profile.

Then click to Save button. Then click to Export Now to run the export job.

After running the export job there will be an option to Download Generated File click on that to create a CSV file. You can generate a file or zip.

Import Gallery
Akeneo Media Gallery Import
To create a new import job profile, go to Imports>Create Import Profile.

After that enter a code, label, and select job type to create the import job.

Then click to Save button.
After that there will be two option –
- Import Now – In this you can enter the file path to import the asset.
- Upload a file – In this you can drag the file to import the asset.

After uploading the file click to the Upload and Import Now option. Then uploading and running the export job you can check the execution details.

Support
So, that was much about the User Guide of Akeneo Image Gallery module for any queries or doubts 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 - Akeneo 3 to 5 || 2.0.0 || Akeneo 6 || 3.0.0 and Akeneo 7 || 4.0.0
Supported Framework Version - Akeneo Version: 3.0.x, 3.1.x, 3.2.x, 4.0.x, 5.0.x,6.0.x, and 7.0.x.