# 3D Viewer

Keep your STEP models in one library and turn, zoom and inspect them in the browser, with no CAD software.

3D Viewer keeps your CAD models in one library and shows them in 3D in the browser, so people without CAD software can still look at a part. At Acme Precision, an engineer uploads the STEP file for an enclosure's upper access hatch, and the shop floor and purchasing open it to see how the part fits before anyone asks for a drawing.

[Add it from the Marketplace](/tenant/?open=settings/marketplace)

## What it does

The module has one page under **3D Viewer** in the sidebar:

- **Drawings** (the left column): every model in the workspace, newest first. Each card shows the drawing's name, the original file name, its size and the day it was uploaded. **Upload STEP** and **Help** are at the top.
- **The viewer** (the large area on the right): the drawing you clicked, in 3D on a floor grid with X, Y and Z axes. The top shows the drawing's name and how many **solids** and **triangles** it was turned into.

It accepts STEP files (`.step` or `.stp`) exported from Fusion 360, SolidWorks, Inventor or any CAD program that saves STEP. It is for looking only: it does not measure, cut sections, mark up or change a model.

## Set it up

A Workspace Admin does this first.

1. Add **3D Viewer** from the Marketplace. There are no settings to fill in. **Module Settings**, from the ⋮ on the **3D Viewer** sidebar row, shows the version you have. See [Module settings and versions](article:fb7c92e4-6dcc-4ef4-80bc-1b6e7482e540).
2. Decide who uploads and who deletes. Out of the box only Admins can do either. Give *Upload 3D drawings* to the engineers and designers who add CAD files, and *Delete 3D drawings* to whoever looks after the library. See [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f).
3. Have an engineer upload the first models (see below). Everyone with *View 3D drawings* can then open them.

## Upload a model

1. In your CAD program, export the part or assembly as a STEP file.
2. Open **3D Viewer** and click **Upload STEP** at the top of the **Drawings** list.
3. Pick the `.step` or `.stp` file.
4. Wait for the **Uploaded** message. The drawing appears at the top of the list, named after the file without its ending.

A file with another ending, or one that isn't really a STEP file inside, is refused with a message saying why. A drawing can't be renamed from the screen, so rename the file on your computer before you upload it.

## Open and look at a model

1. Click a drawing in the **Drawings** list.
2. Wait while it loads (**Downloading STEP…**, then **Parsing STEP…**). The model is converted on your own computer, so a large assembly takes longer.
3. The model appears framed to fit. Use the mouse to look around it:

| To | Do this |
|---|---|
| Turn the model | Drag with the left mouse button |
| Zoom in or out | Scroll the mouse wheel |
| Slide the model sideways | Drag with the right mouse button |

To get back to the starting view, click another drawing, then click this one again.

## Replace or remove a model

1. To replace a model with a new revision, upload the new STEP file, then delete the old drawing.
2. To delete, point at the drawing in the list. A **Delete** button appears in the corner of its card.
3. Click **Delete**, then confirm in the **Delete drawing?** box.

Deleting is permanent: the drawing and its file are removed and can't be brought back. Keep the original STEP file on your computer or file share.

## Who can do what

Each action in the module needs a permission. A Workspace Admin gives permissions to roles; see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f). **Out of the box** shows the module's starting roles that have it.

| Permission | What it lets someone do | Out of the box |
|---|---|---|
| **View 3D drawings** | See the drawing list and open models in the viewer. | Admin, Operator, Viewer |
| **Upload 3D drawings** | Add new STEP files to the library. | Admin |
| **Delete 3D drawings** | Permanently remove models from the library. **Give with care.** | Admin |

- Everyone who can view drawings sees every drawing in the workspace. There is no per-drawing access.
- **Upload STEP** and **Delete** show for everyone, but someone without the matching permission gets **Upload failed** or **Delete failed**.

## Ask its agent

The **3D Viewer Assistant** answers questions about your drawing library. Try:

- "List all my drawings."
- "When was the Upper access hatch (TCC-003) uploaded, and how big is it?"
- "Delete the drawing called Pallet rack - shipping bay."

It names a drawing back to you and waits for your yes before it deletes, and only for people with *Delete 3D drawings*. It can't upload files; use **Upload STEP** for that. See [Agent chat](article:073c6465-d85c-4364-8768-acf42a3a6a48).

## Good to know

- Only STEP files are accepted. Native files such as `.f3d`, `.sldprt` or `.ipt`, and STL, IGES, OBJ or PDF drawings, are refused.
- If a drawing shows **Could not render STEP file**, the file uploaded but your browser couldn't convert it. Export it again from the CAD program and upload the new file.
- Big assemblies need a reasonably powerful computer, because the conversion happens in your browser. If one never finishes, export a simpler version (fewer parts, or no small hardware).
- STEP files are kept in your workspace's own database. The **3D drawings** dataset lets you report on how many drawings were uploaded, when, by whom and how much space they use; file contents are never part of a report. See [Dashboard](article:1d8a33a4-3a13-4874-b8e5-5ef9da22df95).

## More help

Click **Help** next to **Upload STEP** for the module's own help: an overview, how it works, who can do what, questions, and setup for administrators. This version has no runbooks.


Source: https://datavisions.ai/docs/module-guides/3d-viewer
