# Annotate object links (beta)

With the object linking feature you can annotate *relations* or *links* between objects in the scene. These links can also contain *link attributes*.

This feature is in beta. Current limitations:

* In 3D interfaces, links are only rendered for cuboids.&#x20;

The format of the link annotations in the exported label attributes is documented [here](https://docs.segments.ai/reference/label-types#links).

## Enable the object linking feature

Navigate to the dataset settings and go to the "Labeling" section. At the bottom of the page, check the option "Use object linking". If the option is not present, it means that the dataset is not compatible yet (see limitations above).

## Configure link attributes

Once the feature is activated, it's possible (but not required) to configure link attributes for each category.&#x20;

Note that a link has a direction, *from* one object *to* another one. The attributes that will appear when annotating a link from one object to another one are determined by the *from* category.

Link attributes can also be configured [programmatically](https://docs.segments.ai/reference/categories-and-attributes#category).

<figure><img src="https://1553794111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHczBG7NHgAtEe4ql1rXH%2Fuploads%2FopoYYQA9ugXP3yhmZEfT%2Flocalhost_8080_admin-david_demo-object-linking-dev_settings_labeling.png?alt=media&#x26;token=70e64293-31f9-4ce2-8e83-6b585d187c61" alt=""><figcaption><p>Link attribute configuration</p></figcaption></figure>

## Link two objects and edit link attributes

The tool bar has a new button to activate the object linking tool.

<figure><img src="https://1553794111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHczBG7NHgAtEe4ql1rXH%2Fuploads%2F6jgWKGUu0UeQkkPLpXvc%2Flocalhost_8080_admin-david_demo-object-linking-dev_samples_daaa4b5d-0f68-456f-bee6-0b0afd35847e_ground-truth_track%3D1.png?alt=media&#x26;token=54b1f914-c1c9-4e11-854d-cff023d9e81e" alt=""><figcaption><p>The toolbar with the object linking tool activated</p></figcaption></figure>

The below video shows how to link two objects, in this case a traffic light and a lane:

1. Select an object
2. Activate the object linking tool
3. Click on the other object you want to link it to
4. The link is now shown in the right sidebar. You can also set the link attributes here.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHczBG7NHgAtEe4ql1rXH%2Fuploads%2FWZWdiyFwfwPTFvDewlvU%2Foutput.mp4?alt=media&token=738e3ad5-13d7-4cc7-89de-9dbaf5644308>" %}

## Unlink two objects

The following video shows how to delete a link:

1. Select the object
2. Select the object linking tool
3. Click on the other object to break the link

Alternatively a link can be deleted by clicking the trash bin icon in the sidebar next to the link.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHczBG7NHgAtEe4ql1rXH%2Fuploads%2F54i7hchuiS315FpQGw6W%2Foutput.mp4?alt=media&token=a61385bb-88c9-40e0-a323-0ca584d0f7f2>" %}

<figure><img src="https://1553794111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHczBG7NHgAtEe4ql1rXH%2Fuploads%2FuXMjIe7HxByEvDUEWNUK%2Flocalhost_8080_admin-david_demo-object-linking-dev_settings_labeling%20(1).png?alt=media&#x26;token=02e0d947-d787-431f-97e3-2af82389fe0b" alt=""><figcaption></figcaption></figure>
