Add an interactive 3D model to a product and the eCommerce product page shows it above the product images. Visitors turn the product in every direction, zoom in and move it with the mouse, by touch or with the keyboard. The viewer runs in the browser with WebGL; nothing to install for the visitor, and every file is served by your own Odoo server.
Key Features
- 3D Model tab on the product — Upload a .glb file (recommended) or a self-contained .gltf file (glTF 2.0) on the product form.
- Interactive viewer on the product page — Drag to rotate, scroll or pinch to zoom, right-drag or two-finger drag to pan; arrow keys rotate and Page Up / Page Down zoom when the viewer has the keyboard focus.
- Checked at upload — Only glTF 2.0 models are accepted: HTML pages, scripts, other formats, damaged files, models that need separate files and models above the size limit are refused with a message that says what to do.
- Served by your Odoo — The viewer library and the Draco / KTX2 decoders ship with the app: no CDN, no request to Google or any other third party when a visitor opens the page.
- Same visibility as the product page — Models of unpublished products, of products of another website or of a shop restricted to signed-in customers are not served to visitors; employees can preview unpublished products.
- Fast pages — The viewer is only downloaded on product pages that have a model; the model is cached by the browser until it is replaced.
- Graceful fallback — Without WebGL 2, or when a model cannot be shown, the viewer is hidden and the product images stay as usual. Products without a model are not changed.
Benefits
- Shoppers see the product from every side before buying
- No external service, account or API key
- Nothing to configure: upload a model and publish the product
Ideal For
- Furniture, lighting, decoration and design objects
- Footwear, bags, jewellery, watches and accessories
- Electronics, tools, spare parts and machinery
Technical Highlights
- One model per product (shared by its variants), stored as an attachment
- Website Interaction loads model-viewer 4.0.0 (three.js r169) from the module on demand
- Model route with the product page's access rules, glTF content types, nosniff, a strict Content-Security-Policy and browser caching keyed on the file checksum
- Size limit in Website > Configuration > Settings (default 30 MB)
- No augmented reality (AR) mode
- Depends on website_sale only; Community and Enterprise
Supported Odoo Versions
- Odoo 19
- Odoo 20
