Attributes (Metadata, Tags, and Labels)

You can use attributes to annotate your files, trigger pipelines, and so on without changing the actual data in your files. There are three different types of attributes as shown in the table:

Attribute TypeDescriptionUsage
Metadata- Part of the S3 object, and generates a new file each time it is added or deleted.
- Limited to 2 KB of data per file; this is an S3 limitation.
- Stored as key:value pair and is limited to one key per value.
Consider using metadata if you want to annotate the file with fairly simple information that could be tracked, and the limitation is to one key:value
Tags- Part of the S3 object, and generates a new file each time it is added or deleted from the file.
- You can include up to 128 characters per tag.
Consider using a tag to store data, such as the name of a test event.
Labels- Stored as an array in the database; therefore, it does not generate a new version of the file if it is changed.
- While the label key is limited to 128 characters, the value size can be up to 1 GB.
- You can have an unlimited number of labels per file.
Consider using a label for temporary annotations, or if you need to annotate more complex information.

Note: Labels are not archived with TDP, so if you need something more permanent, or trackable, then consider using metadata or tag instead.

You can manage attributes in the Attribute Management page. To learn how to manage attributes, click here.

You can add, edit, and delete attributes in multiple places in the Tetra Data Platform (TDP). To learn how to apply attributes, click here.

Attribute Type Comparison Summary

Although you can use metadata, tags, and labels to annotate (or "decorate") files, they are designed to be used in very different ways. You can review this table for a comparison summary:

ItemLabelMetadataTag
FormatKey:Value (Array)
Example: Status[Complete, Unprocessed, Pending]
Key:Value Pair
Example: SignOff:False
String
Example: ChromaTest099
Generates a New Version of File When Changed or Added?NoYesYes
More than One Value Allowed?Yes. Because a label is an array, one field can store several values.No, there is one value per key.No, there is one value.
Maximum sizeLabel Name (Key): 128 characters
Label Value: 1 GB
Metadata Value:
2KB

(Note that the limit of all Metadata and Tags associated with a single file is 2KB.)
Tag Value:
128 characters

(Note that the limit of all Metadata and Tags associated with a single file is 2KB.)
Characters AllowedKeys can include only letters, numbers, spaces and selected symbols (+, -, .or _)

Values can include only letters, numbers, spaces and selected symbols (+, -, ., _, / or ,)

Limits: Unlimited Number of Characters
Keys can include only letters, numbers, spaces and selected symbols (+, - or _)

Values can include only letters, numbers, spaces and selected symbols (+, -, ., _, /, or ,)

Limits: 2K
Tags can include only letters, numbers, spaces and selected symbols (+, -, ., _ or /)

Limits: Up to 128 characters
Additional NotesStored in the Database and not the S3 Object. Not archived with the product.Stored as part of the S3 Object in the S3 Bucket.Stored as part of the S3 Object in the S3 Bucket.