What model-viewer is
The project describes itself as a way to easily display interactive 3D models on the web and in AR [1]. It lives in Google's GitHub account, is published as the npm package "@google/model-viewer" and is licensed under Apache 2.0 [1][2]. Technically it builds on three.js and loads models in glTF/GLB.
Typical uses
- 3D product view in a shop: rotate and zoom a model without custom code.
- AR view: place the product in your own room on a phone, using USDZ on Apple devices.
- Simple variants: colour changes through materials, for example.
In 2024 the component was among the first viewers to support the Khronos PBR Neutral tone mapper for colour-accurate product display [3].
Limits
model-viewer is built for display, not for configuration logic. Rules between options, parametric geometry, exploded views with an assembly order or an enquiry with a parts list have to be added yourself or solved differently. A custom solution with three.js is then usually the better fit.
Mind the loading time
A ready-made component still loads a library and a model. For good Core Web Vitals a real poster image helps: according to web.dev the canvas element is not among the candidates for Largest Contentful Paint, but an image is [4].
Our example configurators do not use model-viewer; they are custom three.js applications. The 3D product viewer page compares the options for a product page.