> ## Documentation Index
> Fetch the complete documentation index at: https://docs.labelbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metadata

> Instructions for adding, filtering, and modifying metadata in the app UI.

**Developer guide**: [Metadata](/reference/metadata)

Metadata is non-annotation information about an asset. You can use metadata to search and filter your data rows in Labelbox. The metadata schema lives at the organization level. This allows you to apply the same metadata fields across multiple datasets. You can use reserved metadata fields and add custom metadata fields.

## Data types

All metadata needs to be one of the following types:

| Type            | Descriptions                                                                                                                            | Filtering                                |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| `DateTime`      | An ISO 8601 datetime field. All times must be in UTC timezone                                                                           | Equals, greater than, less than, between |
| `Number`        | Floating-point value (max: 64-bit float)                                                                                                | Greater than & less than                 |
| `String`        | free text field. Max 4,096 characters.                                                                                                  | Equals & prefix matching                 |
| `Enum`          | Enum field with options. Multiple options can be imported.                                                                              | Equals                                   |
| `Option (Enum)` | Option of an enum. Max 64 options can be created per Enum type. 128 for enterprise customers and can be further increased upon request. | Equals                                   |
| `Embedding`     | 128 float 32 vector used for similarity                                                                                                 |                                          |

## Reserved fields

By default, Labelbox defines several metadata fields on your data rows. You don't have to use these fields and can change the field values, but you can't delete or rename these fields.

Each metadata field has a unique schema ID used to upload data to Labelbox.

| Name               | Type       | Description                                                                               |
| ------------------ | ---------- | ----------------------------------------------------------------------------------------- |
| `tag`              | `String`   | The tags of the data row                                                                  |
| `split`            | `Enum`     | The split of the dataset that the data row belongs, including`train`, `valid`, and `test` |
| `captureDateTime`  | `DateTime` | The timestamp when the data is captured                                                   |
| `skipNFrames`      | `Number`   | (Video data only) The number of frames to skip                                            |
| `turnInstructions` | `String`   | JSON string that contains instructions for each turn in a Multi-modal chat conversation.  |

## Custom fields

To create custom metadata fields via the UI, go to the [**Schema**](https://app.labelbox.com/schema/metadata) tab. Select **Create**.

<Frame>
  <img src="https://mintcdn.com/labelbox-1db23ff4/60Lzt2PDK3fJCHcg/images/docs/ecc7e91-Screenshot_2024-06-04_at_9.52.35_AM.png?fit=max&auto=format&n=60Lzt2PDK3fJCHcg&q=85&s=3f80f8ef17a417e31953d7fddc83b172" alt="" width="3410" height="1968" data-path="images/docs/ecc7e91-Screenshot_2024-06-04_at_9.52.35_AM.png" />
</Frame>

Each metadata field must have a unique name and a type. The max number of fields per organization is determined by account tier.

<Frame>
  <img src="https://mintcdn.com/labelbox-1db23ff4/2Od9VBnnAA3wl0Qw/images/docs/8cf7949-Screenshot_2024-06-04_at_9.54.05_AM.png?fit=max&auto=format&n=2Od9VBnnAA3wl0Qw&q=85&s=59c0376e5b5993e24a1aba154384b341" alt="" width="3432" height="1972" data-path="images/docs/8cf7949-Screenshot_2024-06-04_at_9.54.05_AM.png" />
</Frame>

To view your metadata schema, go to the [**Schema tab**](https://app.labelbox.com/schema/metadata) and then select the **Metadata** subtab.

<Frame>
  <img src="https://mintcdn.com/labelbox-1db23ff4/_MDTDLWsYj4TKxT6/images/docs/af167bf-Screenshot_2024-06-04_at_9.53.19_AM.png?fit=max&auto=format&n=_MDTDLWsYj4TKxT6&q=85&s=3d3d78954cd8195fb59e3a22757a4396" alt="" width="3394" height="1970" data-path="images/docs/af167bf-Screenshot_2024-06-04_at_9.53.19_AM.png" />
</Frame>

<Info>
  ### Metadata field limits

  You can modify the names of custom metadata schema by clicking the **Edit** button in the detail view of each schema, but you can't change the type once you create a field,. You also can't modify the names of reserved fields. See [limits](/docs/limits) to learn the maximum number of allowed metadata fields of your account.
</Info>

## Update custom metadata schema via the UI

Go to the Schema tab to update custom metadata fields via the UI. Then, find the metadata you want to modify and click the **Edit** button. Only the following can be updated:

* The name of custom metadata for [non-reserved](#reserved_fields) metadata
* The name of options for Enum metadata

## Bulk add metadata

Follow these steps to bulk add metadata to your data rows in **Catalog**. See [limits](/docs/limits) to learn the limits for bulk adding metadata to data rows in Catalog.

### Step 1: Select data rows

You will need to select a curated subset of data.

For example, you may select a cluster of data from the [projector view](/docs/model-runs). Another option could be to select the top results of a [natural language search](/docs/natural-language-search). This way, you can use neural networks like CLIP as zero-shot classifiers. A third possibility is to select all assets that look similar to each other - thanks to [Labelbox similarity search](/docs/similarity). Similarity search powered by embeddings allows you to leverage any off-the-shelf neural network as a zero-shot classifier.

There are three ways to select data rows:

* Option 1: Select all filtered data rows by choosing **Select all**.
* Option 2: Use the selection icon (checkbox) to manually select individual data rows.
* Option 3: Bulk select data rows by selecting the first data row, press and hold `Shift`, and then select the last data row. All data rows between the first and last ones are selected.

<Frame caption="In this example, we select all data rows containing the keyword &#x22;happy&#x22; ">
  <img src="https://mintcdn.com/labelbox-1db23ff4/_mv5eJ1aW03aS2X9/images/docs/e964bca-Screenshot_2023-03-25_at_11.56.50.jpeg?fit=max&auto=format&n=_mv5eJ1aW03aS2X9&q=85&s=51c7dca7c8232d4d1e3fea4570cc8bb0" alt="" width="3456" height="2006" data-path="images/docs/e964bca-Screenshot_2023-03-25_at_11.56.50.jpeg" />
</Frame>

### Step 2: Add metadata

After you select your data rows, select **Add metadata** from the selection menu.

<Frame>
  <img src="https://mintcdn.com/labelbox-1db23ff4/60Lzt2PDK3fJCHcg/images/docs/f408069-Screenshot_2023-03-25_at_11.58.26.jpeg?fit=max&auto=format&n=60Lzt2PDK3fJCHcg&q=85&s=a7c248f4e8e2703539db038561d863bc" alt="" width="3456" height="2000" data-path="images/docs/f408069-Screenshot_2023-03-25_at_11.58.26.jpeg" />
</Frame>

### Step 3: Pick a metadata field

From the selection menu, select the metadata field you want to apply.

You can search for metadata fields by typing their name if you don't see them in the dropdown.

Metadata fields must exist in Labelbox before they appear in the menu.

<Frame>
  <img src="https://mintcdn.com/labelbox-1db23ff4/_MDTDLWsYj4TKxT6/images/docs/afbfcbc-Screenshot_2023-03-25_at_12.01.03.jpeg?fit=max&auto=format&n=_MDTDLWsYj4TKxT6&q=85&s=db5b0b0336dbb016b0c41af738ac653a" alt="" width="3456" height="2006" data-path="images/docs/afbfcbc-Screenshot_2023-03-25_at_12.01.03.jpeg" />
</Frame>

### Step 4: Provide metadata values

Enter a metadata value. This metadata field and value will apply to all selected data rows.

Choose **Save** to apply the metadata in bulk. Changes can take time to be reflected in the data row metadata.

<Frame caption="Here, all data rows containing the keyword &#x22;happy&#x22; are tagged as &#x22;Sentiment > Positive&#x22; ">
  <img src="https://mintcdn.com/labelbox-1db23ff4/pX5sb6w9JhVLrazS/images/docs/073917f-Screenshot_2023-03-25_at_12.05.31.jpeg?fit=max&auto=format&n=pX5sb6w9JhVLrazS&q=85&s=7354c18ea7ed688033386a71ccf82170" alt="" width="3456" height="2002" data-path="images/docs/073917f-Screenshot_2023-03-25_at_12.05.31.jpeg" />
</Frame>

## View metadata

You can surface data rows with the new metadata values, by [searching on metadata in Labelbox](/docs/search#supported-attributes-for-search-and-filter).

<Frame caption="Here, only data rows with the metadata field &#x22;Sentiment&#x22; and value &#x22;Positive&#x22; are displayed.">
  <img src="https://mintcdn.com/labelbox-1db23ff4/60Lzt2PDK3fJCHcg/images/docs/f2d6ab8-Screenshot_2023-03-25_at_12.22.23.jpeg?fit=max&auto=format&n=60Lzt2PDK3fJCHcg&q=85&s=adb17632d082343f59031520e472cf41" alt="" width="3456" height="2000" data-path="images/docs/f2d6ab8-Screenshot_2023-03-25_at_12.22.23.jpeg" />
</Frame>

The newly created metadata tag will also show up in the detailed view.

<Frame>
  <img src="https://mintcdn.com/labelbox-1db23ff4/_MDTDLWsYj4TKxT6/images/docs/ac83ddc-Screenshot_2023-03-25_at_12.24.43.png?fit=max&auto=format&n=_MDTDLWsYj4TKxT6&q=85&s=af479c5c4d0a200b827a0f9aaf771ca9" alt="" width="3456" height="2000" data-path="images/docs/ac83ddc-Screenshot_2023-03-25_at_12.24.43.png" />
</Frame>

## Filter metadata

Once you upload your metadata, you can easily filter and view metadata in Catalog. If you want to label this set of data rows, you can filter by that metadata field and send them to a labeling project as a [batch](/docs/batches).

<Info>
  ### Metadata viewing access

  Labelers cannot filter and view metadata in Catalog. However, labelers will be able to view metadata information in the data row information panel.
</Info>

<Frame>
  <img src="https://mintcdn.com/labelbox-1db23ff4/lnhxZSTssM0QD0kK/images/docs/b9b3306-Screenshot_2024-06-04_at_10.02.45_AM.png?fit=max&auto=format&n=lnhxZSTssM0QD0kK&q=85&s=e4ea4a0fa2bdc1ce8659c18152c44a74" alt="" width="3398" height="1964" data-path="images/docs/b9b3306-Screenshot_2024-06-04_at_10.02.45_AM.png" />
</Frame>

Select a data row to open its detailed view. The **Metadata** panel shows all current metadata.

<Frame>
  <img src="https://mintcdn.com/labelbox-1db23ff4/sVOsXQe1Ox1EwD0L/images/docs/6feccb8-Screenshot_2024-06-04_at_10.06.50_AM.png?fit=max&auto=format&n=sVOsXQe1Ox1EwD0L&q=85&s=da042e14301569d94eb952cbf47c48ef" alt="" width="3424" height="1984" data-path="images/docs/6feccb8-Screenshot_2024-06-04_at_10.06.50_AM.png" />
</Frame>

## Export metadata

When you export your metadata, you can sync the newly created metadata with any outside system such as a cloud bucket, data lake, data warehouse, or database. To learn how to export data rows containing metadata, see [Export from catalog](/docs/export-from-catalog).

## Delete metadata

You can delete metadata for a data row through the SDK. Visit [this guide](/reference/metadata) for instructions.
