OdooWiki OCA HUB

Storage Image Product

storage_image_product folder_open OCA/storage open_in_new
Storage License: LGPL-3

Attach images to products and categories

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Lets users attach images from the image library to products, product variants and product categories, and tag those images (for example main, secondary, packaging) so the right picture is shown automatically.

This module connects the image library to your product catalog. On a product template you get a new Images tab where you can link stored images to the product, and on a product category form you get an Images section for category pictures.

Each linked image can carry a tag. Tags are managed in a new Image Tag screen under Sales > Configuration, where you choose whether a tag applies to products or to categories. The tag form shows how many products and how many categories use it, with buttons to open those lists.

For products with variants, an image can be restricted to specific attribute values (for example colour Red). Odoo then works out, for each variant, which images match it and picks a main image automatically: the first active image in sequence order, preferring one whose attributes exactly match the variant. The product form and the product kanban cards show this main image instead of the standard picture, and the variant form shows its matching images in a read-only Images tab.

If you remove an attribute value from a product's variants, that value is also removed from the images that were restricted to it, so images never point to values the product no longer offers.

On the image record itself, new Products and Categories tabs list where the image is used. Image managers can create and edit these links; other internal users can only view them, and only administrators manage the tags.

Depends on

storage_imageproductsale

Menus it adds

menu_image_tag
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-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 4 confirmed, 5 with no information of 9 versions.

terminal Installation and usage

OCA documentation · 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.

info

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.