DOCUMENTATION

3D Scene

Last updated May 2026
Advanced Block
All plans

An interactive Three.js 3D scene embedded in your document. Three scene modes: upload a GLB/GLTF model, build a procedural multi-object scene from presets, or embed a Spline scene URL. Cursor interactions, animations, and background controls are all configurable from the sidebar.

Adding a 3D Scene

/ → 3D
Type /3d or /model or /spline on any empty block.
Block palette
Click + → Advanced → 3D Scene.

Scene modes

Procedural

Render a single pre-configured 3D object without uploading anything — no modeling required.

This is a single-object scene. There is no way to add multiple objects, and there is no cursor-response behavior (rotate/float/scale toward the cursor) — the only motion available is a constant auto-rotate, independent of the mouse.
Geometry
Knot (default), Sphere, Box, Torus, Cylinder, or Cone.
Material
Standard, Glass, Wire(frame), Normal, or Matcap.
Color
Object color, via color picker.
Roughness / Metalness
Only shown for the Standard material — 0–100% sliders.
Auto-rotate
On/off toggle, with a rotation axis (X/Y/Z) and speed slider — this is the only animation mode.
Height
Canvas height, 200–800px.

Model (GLB/GLTF)

Upload a .glb or .gltf file to render your own 3D model. The model is stored in your asset library and served via CDN. Controls for rotation, scale, position, camera distance, and environment lighting are available in the sidebar.

Model mode requires a GLB file upload. Do not specify a model filename in AI instructions if the file hasn't been uploaded — leave the field unset and the scene will show a placeholder until a file is provided.

Spline

Paste a Spline scene URL to embed a scene built in Spline. The scene renders in an iframe with full interactivity — Spline's own mouse events and animations run as normal. Best for complex animated scenes that would be impractical to build with the procedural editor.

Background

Only two options — there is no Gradient or Environment background type for this block.

Transparent
No background — the document page background shows through. Default.
Color
A solid custom background color, via color picker.

Published pages

The 3D block is dynamically imported (ssr: false) — it never renders on the server. On published pages it loads with a "Loading 3D scene…" placeholder until the Three.js runtime and scene assets are ready client-side. For Spline scenes, the iframe loads independently of the Three.js bundle.

The 3D block is not in the nav yet — it's accessible via slash command (/3d) and the block palette. A dedicated nav entry will be added when the block graduates from beta.