# Custom Fields

Extend work items with custom fields to track any data you need.

## Overview

Custom fields let you add extra data to work items beyond the built-in fields (title, description, assignee, etc.).

## Field Types

| Type | Description | Example |
|------|-------------|---------|
| Text | Single line of text | Customer name |
| Long Text | Multi-line text | Requirements |
| Number | Numeric value | Story points |
| Date | Date picker | Target date |
| Select | Single choice from list | Environment |
| Multi-select | Multiple choices | Affected versions |
| Checkbox | Yes/no toggle | Needs review |
| User | Team member picker | Reviewer |
| URL | Web link | Documentation |

## Creating Custom Fields

1. Go to Workspace Settings > Custom Fields
2. Click "New Field"
3. Enter name and choose type
4. Configure options (for select fields)
5. Choose which item types use this field

## Field Options

### Required

Make the field mandatory. Work items can't be saved without it.

### Default Value

Pre-populate the field for new items.

### Description

Help text shown below the field.

### Visibility

- **All item types** - Field appears on all work items
- **Specific types** - Only on selected item types (Bug, Task, etc.)

## Select Field Options

For Select and Multi-select fields:

1. Add options with labels and colors
2. Set a default option
3. Reorder options by dragging
4. Archive unused options (keeps historical data)

## Using Custom Fields

### On Work Items

Custom fields appear in the work item detail view. Edit inline or in the detail panel.

### In Filters

Filter the backlog and board by custom field values.

### In Reports

Group and aggregate by custom fields in reports.

## Import/Export

Custom field values are included when:

- Exporting to CSV
- Using the API
- Bulk importing items

## Best Practices

1. **Name clearly** - Use descriptive names
2. **Limit fields** - Too many fields slow down data entry
3. **Use select over text** - Easier to filter and report on
4. **Archive, don't delete** - Preserve historical data