Drupal is a registered trademark of Dries Buytaert
drupal 11.3.7 — Update released for Drupal core (11.3.7)! drupal 11.2.11 — Update released for Drupal core (11.2.11)! drupal 10.6.7 — Update released for Drupal core (10.6.7)! drupal 10.5.9 — Update released for Drupal core (10.5.9)! cms 2.1.1 — Update released for Drupal core (2.1.1)! drupal 11.3.6 — Update released for Drupal core (11.3.6)! drupal 10.6.6 — Update released for Drupal core (10.6.6)! cms 2.1.0 — Update released for Drupal core (2.1.0)! bootstrap 8.x-3.40 — Minor update available for theme bootstrap (8.x-3.40). menu_link_attributes 8.x-1.7 — Minor update available for module menu_link_attributes (8.x-1.7). eca 3.1.1 — Minor update available for module eca (3.1.1). layout_paragraphs 2.1.3 — Minor update available for module layout_paragraphs (2.1.3). ai 1.3.3 — Minor update available for module ai (1.3.3). ai 1.2.14 — Minor update available for module ai (1.2.14). node_revision_delete 2.0.3 — Minor update available for module node_revision_delete (2.0.3). moderated_content_bulk_publish 2.0.52 — Minor update available for module moderated_content_bulk_publish (2.0.52). klaro 3.0.10 — Minor update available for module klaro (3.0.10). klaro 3.0.9 — Minor update available for module klaro (3.0.9). layout_paragraphs 2.1.2 — Minor update available for module layout_paragraphs (2.1.2). geofield_map 11.1.8 — Minor update available for module geofield_map (11.1.8).
← All modules

model_viewer_formatter

3 sites No security coverage
View on drupal.org

Model Viewer Formatter

Provides a field formatter for displaying 3D model files using Google's Model Viewer web component.

Description

The Model Viewer Formatter module integrates Google's "model-viewer" web component into Drupal, enabling you to display interactive 3D models directly on your website. This formatter can be applied to any file field to render 3D models with a rich, interactive viewer that supports rotation, zooming, and even augmented reality (AR) on compatible devices.

Features

  • Multiple 3D Format Support: Display OBJ, GLTF, and GLB file formats
  • Interactive Controls: Enable camera controls for zooming, panning, and rotating models
  • Auto-rotation: Optionally enable automatic model rotation
  • Customizable Appearance: Configure viewer dimensions, background colors, and poster images
  • AR Support: Built-in support for augmented reality on compatible mobile devices (WebXR, Scene Viewer, Quick Look)
  • Loading State: Displays a loading spinner while the model loads
  • Fully Configurable: All viewer options are configurable per field formatter instance

Configuration Options

The formatter provides the following configurable settings:

  • Width & Height: Set custom dimensions (supports px, %, vh units)
  • Auto-rotate: Toggle automatic model rotation
  • Camera Controls: Enable/disable user interaction (zoom, pan, rotate)
  • Background Color: Set background color using hex values
  • Poster Image: Optional poster image displayed before model loads

Use Cases

  • Product visualization for e-commerce sites
  • Architectural and engineering model presentations
  • Museum and gallery 3D artifact displays
  • Educational content with 3D diagrams and models
  • Any content type requiring interactive 3D model display

Requirements

  • Drupal 10 or 11
  • File field on content type or entity
  • 3D model files in OBJ, GLTF, or GLB format

Usage

  1. Install and enable the module
  2. Navigate to the Manage Display settings for any content type with a file field
  3. Select "Model Viewer (Google)" as the formatter for your file field
  4. Configure the viewer settings as desired
  5. Upload 3D model files to the field when creating/editing content

Activity

Total releases
2
First release
Oct 2025
Latest release
5 months ago
Release cadence
0 days
Stability
50% stable

Releases

Version Type Release date
1.0.0 Stable Oct 28, 2025
1.x-dev Dev Oct 28, 2025