---
title: "label"
canonical: "https://help.vicon.com/space/ShogunPost121/1253737418/label"
format: markdown
---
# Description

Labels the selected trajectory by transferring its keys to a marker on the character currently being labeled. See [labelOptions](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737510) for various ways the label can be applied.

If the `targetLabel` argument is not specified, the current label (in the **Labeling** panel) will be used.

## Functional area

Data editing

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `label ["targetLabel"]` |

### Arguments

| Name | Type | Required | Comments |
| --- | --- | --- | --- |
| `targetLabel` | string | no | The name to label the selected trajectory. |

### Flags

None

## Return value

string

Returns the label of the selected marker.

## Examples

```plaintext
// Label the selected marker as LFHD.
label "LFHD";
```

# Additional information

## Related commands

- [labelOptions](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737510)