> 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-application/data-and-collaboration/issues-panel.md).

# Issues Panel

Use the issues panel to create and manage issues associated to the currently opened model(s).

Open the Issues panel by clicking the issues icon on the right of your screen or by using the <kbd>Shift</kbd> <kbd>C</kbd> shortcut. The Issues panel is not available in publicly shared models or while editing a component.

{% hint style="info" %}
The Issues panel is part of the Coordination add-on. Without this add-on, the issues icon is greyed out, its tooltip shows a bolt icon, and the shortcut does not work. See [Plans & Add-ons](https://help.qonic.com/getting-started/plans-and-add-ons.md#add-ons).
{% endhint %}

{% hint style="info" %}
By default the panel shows the issues of the models that are currently open: an issue is listed when all of its models are open. To see every issue in the project, open the filter and under *Show* choose *All*.
{% endhint %}

#### Creating a new issue

Click the green <kbd>+</kbd> button (*New issue*) at the bottom right of the panel and choose *Create issue* to manually create a new issue. An issue needs at least a *Title*. Its *Priority* (Low, Normal or High) is *Normal* and its *Status* (Open, In progress, Resolved, Blocked or Closed) is *Open* unless you change them.

Optionally, more details can be added:

* the *Issue location*, governed by the entities selected while creating the issue (it cannot be changed afterwards),
* an *Assignee*, to be picked from the list of project members,
* a *Description*, with the additional options to add screenshots and tag project members,
* one or more custom *Labels* to easily identify groups of issues.

<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%2FCrpM8rMghdorFpfG7mSj%2Fimage.png?alt=media&amp;token=4beda570-62b9-4386-baf4-fff6ac397d82" alt="" width="273"><figcaption></figcaption></figure></div>

You can also create issues directly from the results of [Clash Detection](https://help.qonic.com/documentation/qonic-application/measure-and-quality/clash-detection.md) and [IDS Validation](https://help.qonic.com/documentation/qonic-application/measure-and-quality/ids-validation.md), one at a time or several at once.

#### Importing issues from BCF

To import issues from a BCF file, click the green <kbd>+</kbd> button at the bottom right of the panel and choose *Import Issues from BCF*, then select a .bcf or .bcfzip file. This will automatically add all the issues in the BCF file to the panel, containing all selections, camera positions and snapshots included in the original issues. Comments in the BCF file are imported as well. The import runs in the background and you get a notification when it is finished.

{% hint style="warning" %}
**Assignees** and **Creators** of the original issues will only be included in the Qonic issues if the email address matches that of an existing Qonic project member. If the email address of the issue **Creator** is not found in the project, the person who imported the BCF file will be assigned as creator. The same email matching applies to the authors of comments.
{% endhint %}

#### Exporting issues to BCF

To share issues with other BIM tools, export them to a BCF file. Click the ellipsis on an issue and choose *Export Issues to BCF*. To export several issues at once, select them first: the ellipsis on any selected issue, or the panel's ellipsis menu, then exports the whole selection. You can also export an issue from the ellipsis menu inside the opened issue. Only the issues you clicked or selected are exported.

Choose where to save the file. Qonic saves a BCF 3.0 file with the .bcf extension, named after the project. The file contains, for each issue:

* its title, description, status, priority, type, labels, assignee and due date,
* its comments,
* its viewpoints: the camera position, the selected elements, which elements are visible and the active section planes,
* its snapshots.

The issue location, reference links and attachments of comments are not included in the file.

#### Using issues

Click the filter button to choose which issues to *Show* (*All* or *Used in Model*), to show only issues that are *Unresolved*, *Created by you*, *Assigned to or mentioning you* or *Unread*, or that have certain *Labels*, and to *Sort by* *Date created*, *Last updated* or *Priority*.

<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%2FQdAKK90ioFVWZQT0FxQp%2Fimage.png?alt=media&amp;token=0dc5481a-52c2-4295-8955-be4ee82ee295" alt="" width="282"><figcaption></figcaption></figure></div>

Issues will both be visible in a list view, and by means of location bubbles in the model view. Hover over a location bubble to view more details, and click it to open the full issue in the panel. Issues close together are grouped in one bubble.

<figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2FCzV4nJFgh3dpQr349Q4d%2Fimage.png?alt=media&amp;token=f95ef3f7-23be-4fb3-889d-3ae812df6551" alt=""><figcaption></figcaption></figure>

Click an issue to open it. Click the issue description to activate the associated selection set, and possibly a color override if the issue was created through a specific tool (e.g. the [Clash Detection](https://help.qonic.com/documentation/qonic-application/measure-and-quality/clash-detection.md) tool which comes with a specific visualization of a clash volume). You can comment on issues, tag people and attach screenshots to make the communication clearer. You can edit or delete your own comments from their ellipsis menu; after deleting a comment, click *Undo* to bring it back. Once you have fixed the problem, click *Resolve* to set the issue to *Resolved*. The issue will still be available but by default the list of issues hides resolved issues (*Unresolved* filter). Turn this filter off to view issues that have been resolved previously.

Use the ellipsis on an issue (or on several selected issues) to *Resolve* or *Unresolve* them, *Mark as Read* or *Mark as Unread*, *Export Issues to BCF*, or delete them. When no issues are selected, the panel's ellipsis menu has *Resolve all* and *Mark all as Read*; when issues are selected, it shows the actions for the selection.

The creator and the assignee of an issue can edit it (for example change the description or reassign it); only the creator can delete it. Any project member can change its status or priority.

<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%2F6TbUPQR173he1reORM1D%2Fimage.png?alt=media&amp;token=2c341d2e-7eff-46d7-8251-9126403eb823" alt="" width="318"><figcaption></figcaption></figure></div>
