How to Export Atlas Worlds to Blender
Bring Atlas worlds into Blender 5.3: import SPZ or PLY splats natively, convert splats to GLB meshes, or generate inside Blender with the Atlas add-on.
Blender is the most direct place to take an Atlas world once it exists. World Labs documents three routes as of November 2026: import the Gaussian splat natively in Blender 5.3, convert the splat to a GLB mesh and import that, or install the Atlas add-on and work with posed images and generation inside Blender. This post covers all three, when to pick each, and the fixes for common import problems.
In this post
- Which route to choose
- Route 1: Import the splat natively
- Route 2: Convert to a GLB mesh and import
- Route 3: The Atlas add-on for Blender
- Working with a coding agent
- Scale, orientation and alignment
- Rendering tips
- Troubleshooting
Which route to choose
| You want to | Use | File |
|---|---|---|
| Render the world as it looks in Atlas | Native splat import | .spz or .ply |
| Edit geometry, add collision, export to engines | Mesh import | .glb from Splats to Mesh |
| Pose photos, place cameras and generate from inside Blender | Atlas add-on | Posed RGBD bundles and splats |
These aren't exclusive. A common setup keeps the splat for looks and the mesh as an invisible proxy for shadows, collision or layout. Both come from the same scene and share its coordinates.
Route 1: Import the splat natively
Blender 5.3 added native Gaussian splat support, and World Labs' Blender page builds on it. The steps from the docs are short:
- Install Blender 5.3 or newer.
- Download your
.spzor.plysplat. If it comes as a ZIP, extract it first. - Drag the file into Blender's viewport and confirm the import.
- Save the scene as a
.blendfile.
Getting the splat out of Atlas
The splat comes from reconstruction. In the web app that happens in Viewfinder. Through the API it is the posedImages2Splats task, which returns an SPZ file. Viewfinder's card in the web app lists SPZ and PLY as splat outputs. If you have the choice, take SPZ for smaller files and PLY when another tool in your pipeline needs it. World Labs' Marble export notes describe SPZ as optimized for file size and PLY as an uncompressed, more widely supported format.
A refined splat costs 5,000 credits ($5) through the API, and World Labs' worked example returned 2,000,000 splats. Expect heavy files. Use the viewport's lower-quality display settings while you navigate if Blender feels slow.
What a splat is good for in Blender
- Look development and camera blocking against a realistic environment.
- Rendering stills or animations that show the world as Atlas reconstructed it.
- A reference when modeling clean geometry on top.
What it isn't good for: editing surfaces, UV work, or physics. For those, use a mesh.
Route 2: Convert to a GLB mesh and import
Splats to Mesh turns the splat into a GLB mesh with real geometry. Through the API this is splats2Mesh, and the main options are:
| Option | Choices | Default |
|---|---|---|
textureMode | image_texture, vertex_color, none | image_texture |
textureSize | 1 to 8192 pixels | 4096 |
targetFaces | Any positive integer | Keep every face |
You can also request collider boxes, returned as a second GLB, and crop to a region with an oriented bounding box.
Import it into Blender:
- File, then Import, then glTF 2.0 (.glb/.gltf).
- Pick the mesh GLB. Materials and the texture atlas come in with it.
- If you asked for collider boxes, import that GLB as well. It uses the same coordinates as the mesh.
- Switch to Material Preview to check the texture.
For editing, a lower targetFaces makes the mesh much easier to work with. You can always request a denser version later for final renders. The vertex_color mode skips UVs entirely, which is handy if you plan to retopologize and bake your own textures.
Our own photos to 3D app also produces a GLB from photos if you'd rather not run the conversion yourself.
Expect some cleanup
Meshes derived from splats inherit the splat's weak spots. World Labs flags thin structures (chair legs, wires), glass and windows, sky, foliage and large plain walls as hard cases. In Blender, the usual cleanup is:
- delete floating fragments (select linked, then delete loose pieces);
- crop away sky and distant background, or ask for an oriented bounding box at conversion time;
- rebuild critical thin parts by hand;
- decimate further if you didn't set
targetFaces.
Route 3: The Atlas add-on for Blender
For working with Atlas from inside Blender, World Labs publishes an Atlas add-on. Its setup notes say it needs Blender 5.3 or newer and, at the time of writing, list version 0.1.4.
Setup, per World Labs' instructions:
- Download the add-on ZIP linked from the Atlas Blender docs.
- In Blender, open Preferences, then Get Extensions, then Install from Disk. Select the ZIP and enable Atlas.
- For online posing and generation, turn on Allow Online Access in Preferences, then enter your World Labs API key in the Atlas sidebar under Settings, Connection. Local imports work offline.
What it adds, according to the docs:
- Calibrated RGBD import. The add-on imports bundles of posed RGBD records, each with an image, a camera and depth, from the World Labs JavaScript client. Each posed image appears as a camera with a point cloud.
- Generation from Blender. You place target cameras among the posed views and generate new views. The docs suggest Blender as a good place to plan views and check them together.
- Splats. Splat file references import as well, so the reconstructed result sits in the same scene as the cameras that made it.
API usage from the add-on draws on your Atlas Developer API credits, at 1,000 credits per US dollar. Keep your key in the add-on settings, never in a shared .blend file or a chat.
Working with a coding agent
World Labs publishes an atlas-blender skill as part of its open-source agent skills. It tells a coding agent how to drive the add-on: posing images, placing cameras, generating views and creating splats. The agent reaches a running Blender session through Blender's MCP server. An agent with only a terminal can run the same commands in Blender's background mode.
A practical split: let the agent do the repetitive camera placement and job management, and do the visual checks yourself in the viewport. Before a 5,000-credit splat run, look at every generated view for objects that change shape between views. That is the most common cause of ghosted splats.
Scale, orientation and alignment
- Orientation. World Labs says Atlas outputs use the OpenGL/three.js right-up-back convention unless a schema says otherwise. glTF is also Y-up, and Blender's glTF importer converts Y-up to Blender's Z-up, so GLB meshes normally come in upright. If something is upside down, fix it once at the root object rather than per piece. Older Marble exports used OpenCV axes, so don't reuse Marble-specific fixes for Atlas files without checking.
- Scale. Atlas scenes are in consistent units. Scenes reconstructed from a single photo have estimated scale, and the docs warn that estimated geometry doesn't guarantee measured dimensions. Measure a known object, such as a door (roughly 2 m), and scale the root if needed.
- Alignment. The splat, the mesh and the collider boxes from the same scene share coordinates. Import them without moving anything and they line up. Parent them to one empty before transforming.
Rendering tips
- Hybrid scenes. Keep the splat visible for the look and use the mesh (hidden from camera) to catch shadows from objects you add.
- Camera moves. Stay near the area the input views covered. Away from it, both splat and mesh get blurry or invented.
- Lighting. A splat carries the lighting of its input views. New Blender lights affect added objects and mesh proxies, not the baked splat colors. To change the scene's own light, relight the views in Atlas and reconstruct. See the Relight guide.
Troubleshooting
| Problem | What to check |
|---|---|
| Splat won't import | Blender version is 5.3 or newer; the file isn't still zipped |
| Viewport very slow | Splat count is high; lower display quality, or use a mesh proxy while blocking |
| Mesh has holes and blobs | Weak input coverage or hard materials; crop, clean up, or add views and reconstruct |
| Mesh and splat don't line up | Something was moved after import; reset transforms, then parent both to one empty |
| Add-on can't generate | Allow Online Access is off, or the API key is missing in the Atlas sidebar |
Summary
For looks, drag the .spz or .ply straight into Blender 5.3. For geometry, run Splats to Mesh and import the GLB. To build the scene from inside Blender, install the Atlas add-on. All three work together because they share one coordinate space. New to Atlas? Start with the step-by-step guide or the Atlas World Model home page.