← All Macros

3D Viewer

PRO ONLY

Display interactive 3D models directly on your Confluence page. Supports STL, OBJ, GLB, and 3MF formats with full orbit controls, zoom, and pan.

Screenshot placeholder

How to Use

  1. Type /3D Viewer in the editor
  2. Upload a 3D model file (STL, OBJ, GLB, or 3MF)
  3. Configure display options (background color, lighting, rotation)
  4. Click Save — the interactive 3D model renders on the page
  5. Viewers can orbit, zoom, and pan the model interactively

Supported Formats

.STL

Standard tessellation — 3D printing, CAD exports

.OBJ

Wavefront — widely supported, with materials

.GLB

Binary glTF — compact, web-optimized, with textures

.3MF

3D Manufacturing Format — modern 3D printing standard

Features

  • Interactive orbit controls
  • Zoom & pan
  • Auto-rotate option
  • Configurable lighting
  • Custom background color
  • No external service — fully offline

Technical Details

StorageForge Storage (chunked base64 for large files)
External ServiceNone — Three.js renders client-side
Max File Size~4.5MB (Forge Storage limit)
EditorFullscreen config with 3D preview
RendererThree.js (WebGL)
AvailabilityPro only

Limitations

  • File size limited to ~4.5MB due to Forge Storage constraints (6MB Lambda payload minus base64 overhead)
  • Very complex models with high polygon counts may impact page performance
  • Textures must be embedded in GLB format — external texture references not supported