> 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/labeling/labeling-tools/relation/group-relation.md).

# Group Relation

The Group Relation labeling tool allows you to create a relation between two or more annotations.

{% hint style="info" %}
The Group Relation tool is supported across the Audio, Image, Video, DICOM, PDF, and Text labeling editors.
{% endhint %}

<figure><img src="/files/0waDld91e55e5FcyyPoP" alt=""><figcaption></figcaption></figure>

### How to add a Group Relation tool to your project <a href="#how-to-add-a-bounding-box-tool-to-your-project" id="how-to-add-a-bounding-box-tool-to-your-project"></a>

From the project’s *Settings* tab, enter the *Label Set* section.

Click on *Add Category*. From the list that appears, click on *Group*.

A new row will appear named *Group*. Click on it to expand it.

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

Give your group relation tool a title and description.

Enable the *Required* toggle if you want to force labelers to create a group relation for each asset. When the toggle is disabled, labelers will be able to save and move to the next asset without creating the single relation.

## How to Draw a Single Relation <a href="#how-to-draw-a-bounding-box" id="how-to-draw-a-bounding-box"></a>

There are two ways to add a group relation in Hub.

1. Click on the first label to include in the group relation. Then, shift-click on all other annotations you wish to include. Right-click on any one of them, and select your group relation under the *Grouping* menu item:

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

2. Click on any one of the *Group Relation* tools you have created from the *Tools* section on the left of the screen. Then, left-click on all annotations you wish to include. Press "N" on your keyboard when you are done to close the group relation.

{% hint style="info" %}
If you wish to add an annotation to more than one group relation:

1. Hide the relation it is currently part of by pressing "H" on your keyboard.
2. Add the annotation to the second group relation.
3. Press "Shift + H" to unhide all relations.
   {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.imerit.net/labeling/labeling-tools/relation/group-relation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.