Appearance
Annotate object links
With the object linking feature you can annotate relations or links between objects in the scene. These links can also contain link attributes.
The format of the link annotations in the exported label attributes is documented here.
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).
Enable category restrictions
With the "Enable category restrictions" flag disabled, links can be created between any two objects. With the flag enabled (default), links can only be created between whitelisted categories. These categories need to be configured in the categories editor.
Configure link attributes and category restrictions
Link attributes and category restrictions can be configured in the category editor.
.DgRvHygd.png)
Category restrictions
Configure which categories can be linked to the current category by adding them in the "Allow linking with these categories" input field. If a category can be linked to itself, it should also be added in the list. Since links have a direction, pay attention to which categories are added to each configuration.
Link attributes
Once the feature is activated, it's possible (but not required) to configure link attributes for each category.
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.
Visualize links and backlinks
Links have a direction. An outgoing link goes from the selected object to another object; a backlink is an incoming link from another object to the selected object. For example, if a traffic light links to a lane, selecting the lane shows the traffic light as a backlink.
- Select an object and open the Links section in the labeling sidebar.
- Open the section's three-dot menu and enable Show backlinks. Incoming links appear alongside outgoing links. This setting is off by default.
- Hover over a linked object's header to highlight it in the scene. Outgoing links are highlighted in cyan, and backlinks in purple.
- Hover over the link icon beside the Links heading to preview all links at once. Click the icon to keep the highlights visible; click it again to release them. This highlight lock lasts for the current session.
- Click a linked object's header to select that object and inspect its relationships.

Outgoing links are highlighted in cyan, and backlinks in purple.
Showing a backlink does not create a reverse link. Link attributes still belong to the original directed link and are defined by its source category. To remove an incoming link, select its source object and delete the outgoing link there.
Link two objects and edit link attributes
The tool bar has a new button to activate the object linking tool.
The toolbar with the object linking tool activated
To link two objects, for example a traffic light and a lane:
- Select an object
- Activate the object linking tool
- Click on the other object you want to link it to
- The link is now shown in the right sidebar. You can also set the link attributes here.
Edit link attributes in the timeline
In sequence datasets, selecting an object also shows its link attributes in the active-track timeline. You can inspect values across frames and right-click a selected range to edit them. Enable Show backlinks in the sidebar's Links menu to include incoming links.
See Link attributes in the timeline for the editing workflow and frame-range behavior.
Unlink two objects
To delete a link:
- Select the object
- Select the object linking tool
- 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.
%20(1).EEjoJDN6.png)