Team administration

Configure readable IDs with taxonomy

Set team numbering and optional project-specific sequences for work items.

Taxonomy assigns readable custom IDs to experiments, ideas, and insights. Team taxonomy supplies a default across projects; project taxonomy is an optional override.

Configure team or project taxonomy

  1. Open Settings → Organization → Taxonomy for the team's defaults, or Settings → Project → Taxonomy for the selected project.
  2. Open the section for Experiments, Ideas, or Insights.
  3. Edit the scheme's name, template, and next number, or create a project taxonomy where none exists.
  4. Review Preview and save.

Without a configured project section, new work uses the team taxonomy and global ID scope. Confirm the intended scope before creating a separate project sequence.

Team taxonomy settings for experiments showing the readable-ID template, next sequence number, and generated EXP-0001 preview.

Build a template

VariableMeaning
{number}Next sequence number
{number:0000}Sequence number padded with zeroes
{year}Current four-digit year
{entity}EXP, IDEA, or INS
{project_code}Project code; frozen when a project sequence is created

For example, {entity}-{number:0000} produces IDs such as EXP-0021. Preview the actual output before saving, especially when combining team and project naming conventions.

Assign IDs to existing records

The backfill action assigns IDs to eligible existing work. Inspect the scheme and selected scope before running it. Changing a template governs the numbering configuration; do not assume it rewrites every already assigned ID.

Custom IDs help people refer to work. They are separate from the numeric resource IDs used by the REST API.

Was this article helpful?

Need more help? Copy this article's details and paste them into a request on our feedback portal. You may need to sign in.

Open feedback portal

On this page