What Are Metadata Fields?
Metadata fields are custom fields that project admins can add to work items. They let you capture information specific to your project that does not fit into the standard fields like title, priority, or assignee.
For example, a software team might add a Repository field to track which repo a work item relates to, or an Affected Version text field to record which release introduced a bug.
Supported Field Types
| Type | Description |
|---|---|
| Text | A free-form text value |
| Number | A numeric value (integer or decimal) |
| Select | A dropdown with a fixed list of options you define |
| User | A reference to a team member in your organization |
| Repository | A reference to a connected code repository |
| Branch | A reference to a branch within a connected repository |
All field types support a single value or multiple values (array mode), which you configure when setting up the field.
Configuring Metadata Fields
To add or edit metadata fields for a project:
- Go to Project Settings and open the Metadata Schema section.
- Click Add Field and choose a field type.
- Enter a field name and, for select fields, define the list of allowed options.
- For repository and branch fields, you can set a default value that pre-populates the field when a new work item is created.
- Toggle Allow multiple values if team members should be able to select more than one value for the field.
- Click Save to apply changes.
Fields take effect immediately. Existing work items will show the new field as empty until a value is set.
Filling In Metadata Fields
On the work item create or edit form, metadata fields appear below the standard fields. Depending on the field type, you will see a text input, a number input, a dropdown, or a picker for users, repositories, and branches.