OdooWiki OCA HUB

Model viewer widget

web_widget_model_viewer folder_open OCA/web open_in_new
Web License: AGPL-3

is a web component that makes rendering interactive 3D models - optionally in AR - easy to do, on as many browsers and devices as possible. strives to give you great defaults for rendering quality and performance.

See source repository and documentation.

The model to load is a GLTF 2.0 file format.

See _ and GLTF overview:

Many engine developers have already started transitioning to glTF 2.0 to reap performance, portability and quality benefits, including BabylonJS, three.js, Cesium, Sketchfab, and xeogl and instant3Dhub engines. glTF 2.0 is also seeing industry support by companies such as Adobe, Google, Marmoset, Microsoft, NVIDIA, Oculus, UX3D, and more as well as prominent universities such as, University of Pennsylvania and Sapienza University of Rome.

"example" directory contains the GLB file of a chair, that is rendered in the following way:

auto_awesome What this module does

AI-generated from the code · Odoo 14.0

This module adds a new field widget that displays binary files containing 3D models (GLTF/GLB format) directly in Odoo forms, with interactive rotation and fullscreen viewing. It is intended for developers to use on binary fields that store 3D models.

This module provides a new widget called 'model_viewer' that can be assigned to binary fields in Odoo. When a binary field contains a 3D model file in GLTF 2.0 format (usually .glb), the widget renders it as an interactive 3D viewer directly in the form view.

  • Users can rotate, zoom, and pan the 3D model using mouse or touch gestures.
  • The model automatically rotates by default (auto-rotate).
  • A fullscreen button (arrows icon) is available to view the model in fullscreen mode.
  • In edit mode, standard file upload and clear buttons appear, allowing users to upload or remove the 3D model file.
  • The widget supports a maximum upload size, defaulting to 250 MB, but can be customized per field using the 'max_upload_size' attribute (in megabytes).
  • If the model fails to load, a warning message is shown and the file is cleared.
  • The widget is based on the existing binary file field, so it inherits standard behaviors like file storage and retrieval.

This module does not add any new menus or models; it only extends the web client's field widget registry. It is a technical component intended for developers to use in custom modules that need to display 3D models.

Depends on

web

Required by other modules

product_model_viewer

Text generated by AI (DeepSeek) from reading the Odoo 14.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: 2 confirmed, 7 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 14.0

Usage

Source · Odoo 14.0

Add widget="model_viewer" to your binary field in form view. Optionally you can set style and max_upload_size (in MB) attributes.

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.