Skip to content
Foundation Docs

Labels

The Labels column renders each label as a separate lozenge. You can add, remove, or replace labels on any issue inline.

Edit labels

Section titled “Edit labels”
  1. Click the Labels cell.
  2. An input opens with the current labels as a comma-separated list. The full value is pre-selected, so you can immediately start overtyping or press Delete to clear it.
  3. Type the new label list. Separate each label with a comma: 
    backend, security, tech-debt
  4. Press Enter or click outside the cell to commit.

Foundation converts the comma-separated text back into a proper Jira labels array and writes it to the issue. Leading/trailing whitespace is trimmed, and duplicates are collapsed.

Clear all labels

Section titled “Clear all labels”
  1. Click the cell.
  2. Press Delete or Backspace (the full value is already selected on open).
  3. Press Enter.

Jira removes every label from the issue.

What’s allowed in a label?

Section titled “What’s allowed in a label?”

Jira labels follow the platform’s rules:

  • No spaces — Jira trims them automatically.
  • No special characters — stick to letters, numbers, hyphens, and underscores.
  • Case sensitive — Backend and backend are different labels. Foundation preserves whatever you type.

If Jira rejects a label — for instance, because it contains invalid characters — the write fails, the cell reverts, and a red toast shows the Jira error.

Searching and filtering by label

Section titled “Searching and filtering by label”

Labels work well with Foundation’s filter tools:

  • Use Quick filters from the toolbar to show only rows with a specific label.
  • Use Pipeline Studio to build label-based conditions alongside other criteria.

See Quick Filters for details.

Section titled “Related”