Multiple Images in Products

Multiple Images in Products


Technical name
Secure dependencies
Multiple Images in Products

Multiple Images in Products

Beta License: AGPL-3 OCA/product-attribute Translate me on Weblate Try me on Runbot

This module implements the possibility to have multiple images for a product template, a.k.a. an image gallery.

Table of contents


To install this module, you need to:


You can manage your images at Product template level:

  1. Go to Sales > Products > Products and choose a product template.
  2. Go to the Images tab.
  3. Add a new image or edit the existing ones.
  4. You can select for which variants you want to make available the image. Keep it empty for making visible in all.
  5. Refresh the page.
  6. The first image in the collection is the main image for the product template.

Going to product variants form, you can manage also your images, but take into account this behaviour:

  1. Go to Sales > Products > Product Variants and choose a product variant.
  2. If you add an image here, the image is actually added to the product template, and restricted to this variant.
  3. When editing an existing image, the image is changed generally for all the variants where is enabled, not only for this variant.
  4. When removing an image from this form, if the image is only in this variant, the image is removed. Otherwise, the image gets restricted to the rest of the variants where is available.
Try me on Runbot

Known issues / Roadmap

  • When you change the image on the product variant, the preview image of the Images tab doesn’t get refreshed until you refresh the browser, or if you go to its template, but the image has been actually saved!
  • The field “Available in these variants” appears when opening the image from the product variant.
  • Add logic for handling to add images with the same name that another variant of the same template, renaming the new image to a unique name.
  • Add logic for handling to add the same image in several variants to a already in another variant for not duplicating bytes.
  • Provide proper migration scripts from module product_images from 7.0.
  • Migrate to v8 api when gets fixed.
  • If you try to sort images before saving the product variant or template, you will get an error similar to DataError: invalid input syntax for integer: "one2many_v_id_62". This bug has not been fixed yet, but a workaround is to save and edit again to sort images.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.



  • Antiun Ingeniería
  • Tecnativa
  • LasLabs


Other credits

  • The migration of this module from 12.0 to 14.0 was financially supported by Camptocamp.

Original implementation

  • This module is inspired in previous module product_images from OpenLabs and Akretion.


This module is maintained by the OCA.

Odoo Community Association

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

This module is part of the OCA/product-attribute project on GitHub.

You are welcome to contribute. To learn how please visit

0.0 / 5.0
based on 0 ratings
This app does not use any external Python dependencies.
This app has automated tests.

Available languages

Language % translated
German / Deutsch
Spanish / Español