How it works
Imagine a common scenario between a labeler and a reviewer:- A labeler finishes labeling an asset and submits it.
- The reviewer looks at the label and notices something that needs to be corrected.
- The reviewer then creates an “issue” on that specific label to flag the problem.
- The labeler can see all the issues assigned to them in the Issues tab.
- When the labeler clicks on an issue, they are taken directly to the label that needs fixing.
- The labeler can then either fix the label and “resolve” the issue, or they can reply with a comment to ask for more clarification from the reviewer.
| Role | Permissions |
|---|---|
| Labeler | Can create, update, delete, resolve, and reopen their own issues on assets they have labeled. |
| Reviewer or Admin | Can create and resolve issues on any labeled asset. They can also delete their own issues and manage comments on any asset. |
How to create an issue
For an issue to be visible to your team, the data row you’re working on needs to be submitted or skipped. If the data row is still in the To label step, the issue won’t appear in the Issues tab. Here’s how to create an issue:- First, open the labeling editor by selecting an asset from any of the workflow steps (like “To label” or “To review”).
- In the top-left corner of the editor, click on the issues icon to activate the tool.
- Click on the specific spot on the asset where you want to place the issue.
- A panel will appear on the right where you can type your message, such as a description of the problem or a question.
- (Optional) You can add a category to the issue. This is helpful for organizing and filtering issues later on. You can either use an existing category or create a new one with a name and description.
- Finally, click Create issue to save it.
How to reply to an issue
To reply to an issue, go to the Issues tab and select an issue, or click on an issue directly in the editor. Type your response in the Reply text box and click Submit. This is what a typical flow looks like from a labeler perspective:- Labeler gets the rework task: From the project overview, the labeler starts the Rework task (e.g., “Start reworking”), which opens the editor on a rejected data row. The issue marker is visible on the asset once it’s out of “To label.”
- Labeler opens and reads the issue: In the editor, the labeler clicks the issue icon/marker to open the issue thread and read the reviewer’s feedback. Alternatively, they can go to the project’s Issues tab, find issues on assets they labeled, and click one to jump directly into that label + issue context.
- Labeler responds via comments and/or fixes the label: If the instructions are clear, the labeler edits the label to address the problem, then submits the data row again from the editor; this moves it back into review. If they need clarification, they **reply on the issue **by typing a response in the Reply box on the issue and click Submit to add a comment to the thread.
How to view all issues for a project
To see all the issues in a project, simply go to the Issues tab. From there, you can filter the issues to see which ones are All, Open, or Resolved. You can also manage your issue categories from this tab. Just select Issue categories to create new ones or edit existing ones.How to update an issue
Once an issue is created, users on the project can interact with it in a few ways:- Create a comment:
- Edit, resolve, or delete an issue: To resolve an issue, simply click the Resolve button at the bottom of the issue. You can also access an options menu to Edit the content of the issue, Resolve it, or Delete it entirely. The actions you can take will depend on your user role.
- Move an issue: If you’re the one who created the issue, you can also click and drag it to a different location on the asset.