> 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/components.md).

# Components

Learn how to create and manage component libraries in the project dashboard.

{% hint style="warning" %}
This article covers how to create and manage component libraries in the dashboard, and how to import components from .rfa files. For more information on how to use these components in your model, visit [this article](/documentation/qonic-application/modelling/components-panel.md) on components in the app.
{% endhint %}

A component is a reusable definition - a window, a door, a piece of furniture, an MEP terminal - that you create once and instance many times. The result is models that are faster to assemble and easier to keep coherent.

To access your project components, head to the Components tab on the left-hand side. Here you will find an overview of all component libraries in this project.

You need the Editor or Owner role in the project to create component libraries and to upload, edit or delete components and variants. Only project owners can delete a component library.

<figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FYkMb0i1ESzMkKT2E5Iki%2Fimage.png?alt=media&amp;token=f82d2c66-b674-4ba2-827c-8b02ff242990" alt=""><figcaption></figcaption></figure>

To create a new component library, click the green <kbd>+</kbd> button and choose *New Library*, or choose *Add existing Library* to copy a library from another project in your organization (you need the Editor role in that project).

<figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FaHzGGASzirO4W33rhoaB%2Fimage.png?alt=media&amp;token=fdb04d4c-5fe4-407e-aa11-0d1fd2318850" alt="" width="257"><figcaption></figcaption></figure>

Right-click a library or use the action menu to open it, edit its name and description (*Edit Library*) or delete it. When you delete a component library, the components already made are kept, but they lose the link to the library.

Double-click a library to open it. Once in a library, you will find an overview of all components in this library.

<figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FqTQlNLSC3ihLhgkQmEwt%2Fimage.png?alt=media&amp;token=fab97cf7-aa17-4abb-bb92-b8dca4acb614" alt=""><figcaption></figcaption></figure>

Click the green <kbd>+</kbd> button to upload .rfa files as new components. Currently supported versions are Revit 2024-2027. You can upload several .rfa files at once; Qonic assigns a class to each component automatically, which you can change later.

To create components from existing geometry in Qonic, use the [components panel](/documentation/qonic-application/modelling/components-panel.md) in the app.

Select a component to *Open* it for [editing in the app](/documentation/qonic-application/modelling/components-panel.md#editing-components), view its *Variants*, *Edit* its name, tags and description, *Discard Changes* you haven't published yet, or *Delete* it. *Open* is available once the component has been processed. Deleting a component cannot be undone. Double-click a component to open its variants.

<figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FtjhhOLUi6AoifQf6QAF5%2Fimage.png?alt=media&amp;token=11ba2ea8-a86e-45d4-9c6d-67e66e79fdf9" alt=""><figcaption></figcaption></figure>

Select a variant to open it, edit its name and tags, duplicate it, make it the default (*Make Default*), discard your unpublished changes, delete it or restore a deleted variant. The default variant cannot be deleted, and a deleted variant can be restored until you publish. To create a new variant, use the [Components panel](/documentation/qonic-application/modelling/components-panel.md#component-variants) in the app, or select an existing variant here and choose *Duplicate*. New variants and other changes to a component are only visible to other collaborators once they are published; they are listed in the *Components* section of the *Publish my changes* dialog. A new variant can only be set as default after it has been published.
