> For the complete documentation index, see [llms.txt](https://help.qonic.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.qonic.com/documentation/qonic-dashboard/models.md).

# Models

Read this article to learn how to use the models tab in a project.

To open the model overview of a project, select a project in the [project overview](/documentation/qonic-dashboard/projects.md) on the top of the dashboard (1) and click the Models tab on the left-hand side of the screen (2). All models you have access to will be shown here.

<figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FlYaRBScaPRKnjXbotMfh%2FGroup%20709.png?alt=media&amp;token=2dfd7c86-78f0-4ae6-9f44-eea01e02d98e" alt=""><figcaption></figcaption></figure>

Click a model card to select it. Depending on your model access rights and the status of the model, you will be able to do any of the following actions on this model:

* Open the model (3)
* Add or remove [tags](/documentation/qonic-dashboard/models.md#model-tags) (4)
* Discard any pending changes (5)
* Mark the model for deletion; it is removed for everyone when you publish your changes. Until then, you can select the model and click *Restore*. Only model owners can delete a model.
* Access the [model version history](/documentation/qonic-dashboard/models/model-version-management.md) (7)
* Manage the [model access rights](/documentation/qonic-dashboard/models/model-access-rights.md) (8)
* Export the model to IFC (9)
* Create a [public sharing](/documentation/qonic-dashboard/models/public-sharing.md) link (10)

<figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FCMZoVQs98f876ecRD24q%2FGroup%20710.png?alt=media&amp;token=b58c21b9-43ba-4d5d-a417-83c13c7fdfe7" alt=""><figcaption></figcaption></figure>

If any of these actions are not available, this means you don't have the required [access rights](/documentation/qonic-dashboard/models/model-access-rights.md) to this specific model. Contact the model owner, or alternatively if you are the project owner, you can make yourself model owner in the Model Status page in the [project settings](/documentation/qonic-dashboard/projects.md).

To open a model you can also simply double-click the model card. When opening a model you can choose between continuing in the web browser or opening the model in the desktop app. Functionality-wise both environments work exactly the same, but for modeling operations in large models we do recommend using the desktop application as you will have more computing power available.

{% hint style="info" %}
Using the Qonic desktop application? The dashboard is included in the desktop application, and each model you open gets its own tab. Read more in the article on the [Desktop App](/getting-started/setting-up-the-desktop-app.md).
{% endhint %}

{% hint style="warning" %}
Opening a model in the web browser on mobile devices is not supported. Please download the mobile app using the App Store or Google Play Store.

On a phone or tablet, the dashboard shows a simplified view: tapping a model opens it in the Qonic mobile app, and your profile and organization settings are read-only.
{% endhint %}

Select multiple models at once by holding down the Ctrl key while clicking the models, or hold the Shift key to select a range of models. Accessing the model version history, managing access rights, exporting and discarding changes are only available for one model at a time.

<figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FCQwT38KOeVbqGIHqSUrd%2Fimage%20160.png?alt=media&amp;token=3536bcfe-b243-4e68-88bc-83b8f5ccf380" alt=""><figcaption></figcaption></figure>

You can switch between card view and list view of the model in the top-right corner (10).

Use the sorting functionality to sort by model name, creation date and last updated (11).

Use the grouping functionality to group your models by creator or tag (12). Grouping is only supported in the list view.

Use the filter option to filter on model tag (13)

Use the search field to filter on model name (14).

The list view also allows you to rename models by clicking the pencil icon appearing next to a model name when you hover over it. You need Model Editor or Owner access rights on the model to rename it.

<figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2F0p7hCsjM7mrkceNZ3HfJ%2FGroup%20711.png?alt=media&amp;token=a5da976e-bf56-4344-86a9-d98919f29e6c" alt=""><figcaption></figcaption></figure>

To add a model to the project, click the green plus button at the top left of the screen (15) and choose *Upload a model*, or simply drag and drop a file into the dashboard. Currently supported file types are .ifc, .3dm (Rhino3D), .skp (SketchUp) and .rvt (Autodesk Revit versions 2024 - 2027). Revit models can also be imported through the [Qonic plugin for Revit](https://www.qonic.com/downloads). Note that if a Revit upload through the dashboard fails, it is recommended to try again using the plugin. The file size limitations are as follows:

* .ifc import: 5GB file size limit, process timeout of 1 hour.
* .3dm import: 5GB file size limit, process timeout of 1 hour.
* .skp import: 5GB file size limit, process timeout of 1 hour.
* .rvt import through the **dashboard**: the upload dialog shows the file size limit that applies to your organization, process timeout of 30 mins.
* .rvt import through the [Qonic plugin for Revit](https://www.qonic.com/downloads/): files up to 5GB.\
  A Revit model imported through the Qonic plugin for Revit can be edited, and the changes can be pushed back to the original Revit model through the same plugin.

To start a new, empty model, click the green plus button and choose *Create a model*. In the *Create a model* dialog, enter a name for the model, optionally add [tags](/documentation/qonic-dashboard/models.md#model-tags), and click *Create*. In the Sample Project, the green plus button is replaced by *Reset sample project*.

To create new models, you need at least the status of **Editor** in this project. For more information on project roles, visit [this help article](/documentation/qonic-dashboard/projects.md).

Valid models will be displayed with a 3D snapshot of the model as their thumbnail. If a [red triangle](/resources/faq.md) appears over the thumbnail, that means something went wrong with the upload. A loading icon means that the model is still processing. Newly uploaded models will also be displayed with a 3D snapshot, and will not be visible to other project members until you publish your changes. For more information on this, read the article about [Version Management](/documentation/qonic-dashboard/models/model-version-management.md).

## Model Tags

Use tags to organize the models in a project, for example by discipline. Each project has its own list of tags, and you can add new tags to it at any time. In the model overview, you can group and filter your models by tag.

To add or remove tags:

1. Select one or more models.
2. Click *Tags*, or right-click a model and click *Tags*.
3. In the panel that opens, tick the tags you want to add and untick the ones you want to remove. Use the *Search* field to find a tag quickly.

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FL0nqvcQ2Ynz5xRJnLk5U%2Fimage.png?alt=media&amp;token=8e84361a-1770-4f95-881d-35d4d3b82817" alt="" width="244"><figcaption></figcaption></figure></div>

Your changes are saved automatically. When you select multiple models, the tags they all have in common are ticked. Ticking or unticking a tag adds it to or removes it from all selected models.

To create a new tag, click *Create new* at the bottom of the panel, type a name and press <kbd>Enter</kbd>. The new tag is added to the selected models and becomes available for all models in the project.

You can also add tags, or create new ones, when you create a new model or upload model files.

{% hint style="info" %}
Only model owners can edit the tags of a model. Tags can't be edited while a model is uploading or processing, or when it is marked for deletion.
{% endhint %}
