# Models

The Models page is where every 3D file you've added to your workspace lives. Models are the source assets behind every project — when you create a project or run a Quick Render, you start by picking a model from this library.

Reach it at **Asset Library → Models**, or directly at [`/library/models`](https://www.app.glossi.io/library/models).

### What's on the page

* **Toolbar** — Count of models in your workspace, an **All / Favorites** filter, search, sort, and an **Add Model** button on the right.
* **Asset grid** — One card per model, showing a preview thumbnail, the model's name, and its processing status.
* **Card hover actions** — Favorite, more menu (rename, delete), and a click-through to the details modal.

A model card's preview is generated automatically once processing finishes. Until then you'll see a placeholder cube.

### Adding a model

Click **Add Model** in the top right of the toolbar to open the **Add Model** dialog. From there you can pick one of two paths:

* **Upload** — Drop one or more 3D files (GLB, USD, FBX, OBJ, GLTF, or STL). Glossi converts and processes them in the background; you can close the modal once the upload starts and the page will track progress for you.
* **Photos** — Provide a few photos of an object from different angles and Glossi's AI will generate a 3D model for you to use in the studio.

You can also drag a 3D file directly onto the Models page to open the upload modal pre-loaded with that file.

For the full upload guide — what happens during validation, processing, unwrap behavior, and best practices — see [Uploading Your Models](https://docs.glossi.io/uploading-3d-models/uploading-your-models). For prepping files before upload, see Preparing Your 3D Assets and the import guides for individual 3D tools.

### Filtering and finding

* **All** — Every model in your workspace.
* **Favorites** — Only models you've starred. Click the heart on any card to toggle.
* **Search** — Filter to models whose name matches your query. Search is incremental — results narrow as you type.
* **Sort** — Order by recency, name, or other model fields.

### Opening a model

Click any model card to open the **Model Details** modal. Inside the modal you can:

* **Rename** the model
* **Manage variants** — Add or remove model variants (different versions of the same product — color options, configurations) so you can render them through the same project.
* **Edit tags** — Tags help you organize and filter models across the workspace.
* **Replace** the underlying file
* **Delete** the model

Deleting a model is allowed only when no projects depend on it — Glossi will tell you which projects need to be reassigned or deleted first.

### Tips

* **Upload in batches** — The upload modal accepts multiple files at once. Drop a folder of products and let Glossi process them in parallel.
* **Use variants** — Group different colorways or configurations of the same product as variants of one model rather than uploading them as separate models.
* **Favorite your hero models** — If a few products dominate your visualization workflow, favoriting them keeps them surfaced in the Favorites filter and the homepage's recent-models rail.

### Related

* [Asset Library Overview](https://docs.glossi.io/asset-library/asset-library-overview)
* [Uploading Your Models](https://docs.glossi.io/uploading-3d-models/uploading-your-models) — What happens during upload (validation, processing, unwrap behavior).
* [Model Variants](https://docs.glossi.io/uploading-3d-models/model-variants) — Connecting alternate versions of the same product.
* [Preparing Your 3D Assets](https://docs.glossi.io/uploading-3d-models/preparing-your-3d-assets)
* [Optimizing Models](https://docs.glossi.io/uploading-3d-models/optimizing-models)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.glossi.io/asset-library/models.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.