The Labels tag provides a set of labels for labeling regions in tasks for machine learning and data science projects. Use the Labels tag to create a set of labels that can be assigned to identified region and specify the values of labels to assign to regions.

All types of Labels can have dynamic value to load labels from task. This task data should contain a list of options to create underlying <Label>s. All the parameters from options will be transferred to corresponding tags.

The Labels tag can be used with audio and text data types. Other data types have type-specific Labels tags.


Param Type Default Description
name string Name of the element
toName string Name of the element that you want to label
[choice] single | multiple single Configure whether you can select one or multiple labels for a region
[maxUsages] number Maximum number of times a label can be used per task
[showInline] boolean true Whether to show labels in the same visual line
[opacity] float 0.6 Opacity of rectangle highlighting the label
[fillColor] string Rectangle fill color in hexadecimal
[strokeColor] string "#f48a42" Stroke color in hexadecimal
[strokeWidth] number 1 Width of the stroke
[value] string Task data field containing a list of dynamically loaded labels (see example below)


Basic labeling configuration to apply labels to a passage of text

  <Labels name="type" toName="txt-1">
    <Label alias="B" value="Brand" />
    <Label alias="P" value="Product" />
  <Text name="txt-1" value="$text" />

Example (This part of config with dynamic labels)

<Labels name="product" toName="shelf" value="$brands" />
<!-- {
  "data": {
    "brands": [
      { "value": "Big brand" },
      { "value": "Another brand", "background": "orange" },
      { "value": "Local brand" },
      { "value": "Green brand", "alias": "Eco", showalias: true }
} -->

Example (is equivalent to this config)

<Labels name="product" toName="shelf">
  <Label value="Big brand" />
  <Label value="Another brand" background="orange" />
  <Label value="Local brand" />
  <Label value="Green brand" alias="Eco" showAlias="true" />
Try Starter Cloud for free Get Started