The Taxonomy tag is used to create one or more hierarchical classifications, storing both choice selections and their ancestors in the results. Use for nested classification tasks with the Choice tag.

You can define nested classifications using the Choice tag, or retrieve external classifications using the apiUrl parameter. For more information on these options, see the Taxonomy template page.

Use with the following data types: audio, image, HTML, paragraphs, text, time series, video.


Param Type Default Description
name string Name of the element
toName string Name of the element that you want to classify
[apiUrl] string Beta – Retrieve the taxonomy from a remote source. This can be a JSON-formatted file or a hierarchical data source read as an API. For more information, see the Taxonomy template page
[leafsOnly] boolean false Allow annotators to select only leaf nodes of taxonomy
[showFullPath] boolean false Whether to show the full path of selected items
[pathSeparator] string "/" Separator to show in the full path (default is “ / “). To avoid errors, ensure that your data does not include this separator
[maxUsages] number Maximum number of times a choice can be selected per task or per region
[maxWidth] number Maximum width for dropdown
[minWidth] number Minimum width for dropdown
[required] boolean false Whether taxonomy validation is required
[requiredMessage] string Message to show if validation fails
[placeholder=] string What to display as prompt on the input
[perRegion] boolean Use this tag to classify specific regions instead of the whole object
[perItem] boolean Use this tag to classify specific items inside the object instead of the whole object1
[legacy] boolean Use this tag to enable the legacy version of the Taxonomy tag. The legacy version supports the ability for annotators to add labels as needed. However, when true, the apiUrl parameter is not usable.


Labeling configuration for providing a taxonomy of choices in response to a passage of text

  <Taxonomy name="media" toName="text">
    <Choice value="Online">
      <Choice value="UGC" />
      <Choice value="Free" />
      <Choice value="Paywall">
        <Choice value="NY Times" />
        <Choice value="The Wall Street Journal" />
    <Choice value="Offline" />
  <Text name="text" value="You'd never believe what he did to the country" />

  1. 1.fflag_feat_front_lsdv_4583_multi_image_segmentation_short should be enabled for perItem functionality
Try Starter Cloud for free Get Started