> For the complete documentation index, see [llms.txt](https://docs.imerit.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imerit.net/core-concepts/issues.md).

# Issues

Labelers, reviewers, and managers can open issues on labeling tasks to have a conversation about a particular asset or label.

Labelers can open issues on the tasks they have been assigned to, for example, to clarify how a certain asset needs to be labeled. Mentioned reviewers and project managers will get notified of the new issue so that they may take action and respond.

Reviewers can open issues on tasks to, for example, communicate to the labeler how they should label similar tasks in the future. Labelers get notified of the opened issues opened this way.

Users can have real-time conversations on issue threads, mention people to be notified, and delete/resolve issues.

## Opening and Viewing Issues on Ango Hub

### How to Open an Issue

#### General Task Issue

Users can open issues that do not point to a specific region of the asset, and are about the task in general.

To do so, open the task you'd like to open an issue in. From the right-hand sidebar, click on *Issues* and write your issue in the box. Mention other users if necessary by @ing them, and press Enter. You can also press "I" on your keyboard if no object is selected to quickly open a task-level issue.

{% hint style="info" %}
You can only mention users which are also members of the project.
{% endhint %}

<figure><img src="/files/r2waTbnKzz85H2oPOUFm" alt=""><figcaption></figcaption></figure>

When you get a reply, you will get a notification.

You can edit or delete the issue using the *Edit* and *Delete* buttons on the issue.

#### Specific Area Issue

In visual and audio labeling tasks, you can place an issue marker on the image/audio to direct attention to a particular region of the asset related to your issue. This is available for images, videos, PDF, audio, and medical data.

To do so, open the task in which you'd like to open an issue, and click on the speech bubble icon in the top-right corner of the screen. Then, click on the asset region of interest. Type your issue and press Enter.

<figure><img src="/files/WJWvkZ5c0a1a3hbPPNZ5" alt=""><figcaption></figcaption></figure>

In audio files, after clicking on the issue bubble icon, click and drag on the waveform where you would like to place your issue:

<figure><img src="/files/t7XZ9fsvf0YoVTXJc7GW" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Issues created this way will also be visible in the right-hand sidebar.

If an issue is obstructing your view, you can hide it by clicking on the ![](/files/agBx437Bj3TXcbLcLwLb) icon, and you can unhide it by clicking it again from the sidebar.
{% endhint %}

For medical data, you can additionally draw a line when the issue cursor is active, to further point at a specific area when opening a Specific Area issue:

<figure><img src="/files/EPyFx4fHHPY38yx2LlTO" alt=""><figcaption></figcaption></figure>

#### Object-Level Issues

To open an issue tied to a particular object, right-click on the object, expand the context menu, click on the three dots and choose *Open Issue*:

<figure><img src="/files/oCD43aMVbVeZuxsVOZYv" alt=""><figcaption></figcaption></figure>

Alternatively, from the *Objects* list on the bottom left of the screen, click on the three dots on the row of the object you'd like to open the issue on, then click on *Create Issue.*

Alternatively, click on an object, then press "I" on your keyboard.

When creating an object-level issue, the dialog displays the object's *Object ID*. You can use the copy button next to the ID to copy it in full, for example when referencing the same object in another conversation or system.

<figure><img src="/files/lKITLlklpgP4pJ1YSXqb" alt="The object-level issue creation dialog displaying the selected object&#x27;s Object ID"><figcaption></figcaption></figure>

#### Video Issues

When you create a specific-area or object-level issue in the Video Editor, the issue dialog displays *Start frame* and *End frame* fields. The start frame is the frame where you opened the dialog. Set the end frame to create an issue that applies across a range; the end cannot be greater than the video's final frame.

The Issues sidebar displays *View on Frame N* for a single-frame issue or *View on Frame N \[N-M]* for a range. Clicking the action moves the video to the issue's start frame. An issue marker remains visible throughout its frame range.

#### Classification-level Issue

Click on the three dots next to the classification answer you'd like to create an issue about, and click on *Create Issue*:

<figure><img src="/files/1iQwCKnugcRZzd7WSOhP" alt=""><figcaption></figcaption></figure>

#### Multi-Image Issues

In [multi-image assets](/data/importing-assets/bundled-assets/importing-multiple-images-in-one-asset-grid-or-carousel.md), you may open an issue spanning multiple images.

To do so, navigate to the image where this issue starts occurring. Then, select the issue "speech bubble" icon and click anywhere on the asset to open the *Open Issue* dialog:

<figure><img src="/files/VFixpztbrQXzR03c8MoS" alt=""><figcaption></figcaption></figure>

At the *End* selector, pick the image number where the issue ends. Click on the <img src="/files/tbJCKAyyLbruM8CybKbV" alt="" data-size="line">arrow to create the issue. You'll be able to see the issue page range when browsing issues in the issue sidebar, as well as in the [issue export](#downloading-all-issues-in-a-project).

<figure><img src="/files/iXPOvVDGJwuIOuejH6p5" alt=""><figcaption><p>Page range in the Issue Sidebar</p></figcaption></figure>

In the issue export:

<details>

<summary>Issue object with page range in issue export</summary>

```json
{
  "_id": "65364c3bc1407000158d96d3",
  "points": [],
  "status": "Open",
  "errorType": "Comment",
  "labelTask": "651d596274373600156401ad",
  "asset": {
    "_id": "651d596274373600156401a9",
    "dataset": [
      "URLs"
    ],
    "batches": [],
    "externalId": "my-asset-external-id-1",
    "data": "https://angohub-public-assets.s3.eu-central-1.amazonaws.com/3e6e15b9-c32c-4b73-97f9-dbda784926ab.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATAGM6WLISC5CRH7S%2F20231004%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20231004T122403Z&X-Amz-Expires=120000&X-Amz-Signature=d8f4e7ba5794faf2e5b27a83375b93bc234935c930bf371fdcb936e66fd8f012&X-Amz-SignedHeaders=host&x-id=GetObject",
    "head": "https://angohub-public-assets.s3.eu-central-1.amazonaws.com/3e6e15b9-c32c-4b73-97f9-dbda784926ab.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIATAGM6WLISC5CRH7S%2F20231004%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20231004T122403Z&X-Amz-Expires=120000&X-Amz-Signature=d8f4e7ba5794faf2e5b27a83375b93bc234935c930bf371fdcb936e66fd8f012&X-Amz-SignedHeaders=host&x-id=GetObject"
  },
  "project": "64e5e49785eb730015b4eb7b",
  "position": "[266.8706411698538,280.4731774415406]",
  "content": "I'm not sure how to annotate this car between these frames.",
  "stage": "Complete",
  "contentMentions": [],
  "page": 0, // Page start, zero-indexed
  "pageEnd": 3, // Page end, zero-indexed
  "createdBy": "lorenzo@example.net",
  "organization": "64db3c87c14b35001503e10b",
  "createdAt": "2023-10-23T10:34:35.018Z",
  "updatedAt": "2023-10-23T10:34:35.018Z",
  "comments": [],
  "stageId": "Complete"
}
```

</details>

### Viewing and Responding to Issues

To view and respond to issues in the project, go to the *Issues* tab and click on the issue of interest:

<figure><img src="/files/esa1u1p7V9YcEtAQlEVA" alt=""><figcaption></figcaption></figure>

You will be directed to the task where the issue was opened, and the issue will be highlighted for you. To respond, simply type your response in the box and press Enter:

<figure><img src="/files/tfkSGk8tH6990iXWYLcK" alt=""><figcaption></figcaption></figure>

For an object-level issue, click its *View on Image*, *View on Page*, *View on Frame*, *View on Text*, or *View on Timeline* action to navigate to the relevant location and select the corresponding object in the editor.

On a single-image task, *View on Image* also centers supported shape objects in the viewport. Segmentation and brush objects are selected without changing the viewport.

If you believe your issue was resolved, click on *Resolve* on the top-right corner of the issue.

### Filtering Issues by Task ID

From the project *Issues* tab, click *Filter* and select *Task ID* to show only issues associated with specific tasks. Enter a Task ID and press Enter to add it to the filter. You can add multiple Task IDs; each ID appears as a separate filter value.

The Task ID filter can be combined with the other available issue filters. It is also available to labelers from the *My Issues* table.

### How to hide all issue bubbles from the asset

Click on the "Eye" icon in the issue panel:

<figure><img src="/files/znSkli1RS7EkPcZUHg8N" alt="" width="563"><figcaption></figcaption></figure>

## Downloading All Issues in a Project

Navigate to the *Issues* tab in your project, and click on *Export Issues*:

<figure><img src="/files/TWD2xK8fCm9HVj3OdI2Z" alt=""><figcaption></figcaption></figure>

You will receive a JSON file containing all details pertaining to all issues in the project.
