Attach images to products and categories
auto_awesome What this module does
AI-generated from the code · Odoo 18.0Attach images from the image library to products, product variants and product categories, and tag them so the right image is shown as the main picture.
This module connects the image library with your product catalogue. On a product template you get a new Images page where you can link several images, give each one a tag and, for products with variants, restrict an image to specific attribute values (for example colour = red). The same is possible on product categories, which also get an Images section.
Odoo then works out the main image automatically: the first image by sequence is used, and for a variant the image whose attributes match the variant exactly is preferred. The product form and the product kanban card show this main image instead of the standard picture field, and the variant form shows the variant's own main image.
Image tags are managed in a new Image Tag screen under Sales > Configuration. A tag applies either to products or to categories, and its form shows counters with buttons to open the related products or categories.
A safety rule keeps data clean: if you remove an attribute value from a product, that value is also removed from the images that were restricted to it. Only users in the image manager group can create or change image links; other users can only read them.
Depends on
Required by other modules
Menus it adds
Models and fields (8)
- image.tag · new modelname, apply_on, categ_img_rel_ids (Category Image Relations), product_tmpl_count (# of Products), product_categ_count (# of Categories), product_img_rel_ids (Product Image Relations)
- storage.image · extends an existing modelproduct_relation_ids (Products), category_relation_ids (Categories)
- product.product · extends an existing modelmain_image_id, variant_image_ids (Variant Images), variant_image_small_url (Variant main small image URL), variant_image_medium_url (Variant main medium image URL)
- product.category · extends an existing modelimage_ids
- product.template · extends an existing modelimage_ids (Images), main_image_id, image_small_url (Main small image URL), image_medium_url (Main medium image URL)
- product.image.relation · new modeltag_id (Tag), product_tmpl_id, attribute_value_ids (Attributes), available_attribute_value_ids (Available Attributes)
- category.image.relation · new modeltag_id (Tag), category_id
- product.template.attribute.line · extends an existing model
Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 4 confirmed, 5 with no information of 9 versions.
Sources · Odoo 18.0
Confirmed on 2026-11-03 in branch 18.0 of OCA/storage.
terminal Installation and usage
OCA documentation · Odoo 18.0Usage
Source · Odoo 18.0- Categories Go to Sales \> Configuration \> Products \> Product Categories. A new field Image is available to upload or use an existing image.
- Products Go to Sales \> Products. In variants tab, after the attributes selection, you will find the images.
For uploading and managing the images see the module storage_image.
No verified information in OCA: Installation, Configuration.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.