This addon is a technical addon providing a set of models to ease the creation of other models that need to be linked to multiple images stored into external filesystems.
The models provided by this addon are:
- fs.image: a model that stores a reference to an image stored into an external filesystem.
- fs.image.relation.mixin: an abstract model that can be used to as base class for models created to store an image linked to a model. This abstract model defines fields and methods to transparently handle 2 cases:
- the image is specific to the model.
- the image is shared between multiple models and therefore is a fs.image instance linked to the mixin.
auto_awesome What this module does
AI-generated from the code · Odoo 18.0This technical module adds a reusable image library and a drag-and-drop image uploader that other Odoo modules can use to attach multiple images to their records, storing the files in an external file system.
This is a technical building block, not a standalone business app. It gives developers two new data models: fs.image, a central library of images kept in an external file system, and fs.image.relation.mixin, an abstract base that other models can inherit to attach images to their own records.
For users, the visible part is a new "Fs Images" menu under the Storage menu, where images can be listed, searched by name or MIME type, grouped by MIME type, and opened in a form. Access is controlled by a new "Image Manager" group: ordinary users can only read images, while members of that group can create, edit and delete them.
On any screen built on the relation mixin, users get a drag-and-drop zone: they can drop image files or click to select them, and choose whether each new image is stored as a "Reusable image" (shared, linked through image_id) or as a "Specific" image attached only to that record. The module also provides form and kanban views for these image relations, with a small preview, a sequence handle for ordering, and a delete cross on the kanban card.
Business rules enforced by the code: every image relation must have either a linked image or a specific image, otherwise a validation error is raised; when "link existing" is used, the specific image fields are cleared automatically; and name and MIME type are computed from the stored file.
Depends on
Required by other modules
Models and fields (2)
- fs.image · new modelname, mimetype
- fs.image.relation.mixin · new modelname, image_id (Linked image), mimetype, sequence, link_existing
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: 3 confirmed, 6 with no information of 9 versions.
Sources · Odoo 17.0
Confirmed on 2026-11-03 in branch 17.0 of OCA/storage.
terminal Installation and usage
OCA documentation · Odoo 18.0Usage
Source · Odoo 18.0To be able to create and or manages shared images, you must have the Image Manager role. If you do not have this role, as an authenticated user, you can only view the shared images.
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.