Unique ID

The Unique ID field displays a persistent identifier for each record. Choose the record’s internal ID or a sequential ID.

Internal record IDs

Internal record IDs are the default. Blue assigns each record a 25-character CUID when it creates the record.

When Auto-increment is off, the field displays this internal identifier. A Project Administrator can add an optional prefix.

Sequential IDs

Sequential IDs use increasing numbers, such as 1, 2, and 3. You can add zero-padding and a prefix to create values such as TASK-001 or TICKET-002.

Configure a sequential ID when you create or edit the field:

1. Turn on Auto-increment.
2. Set Number of digits from 1 through 10. For example, three digits produce 001, 002, and 003.
3. Set Starting value. The default is 1.
4. Enter a value in Prefix (optional). Blue suggests an abbreviation based on the record alias or workspace name.

Sequential IDs provide readable references for communication and consistent numbering for processes such as support requests. They also support external systems that require numeric identifiers. A workspace can use a sequential ID field and its prefix to generate record titles automatically.

Restart numbering per field value

By default, a sequential ID field runs one number series for the whole workspace. You can restart the series for each value of another field. Use this to number order line items 1, 2, 3 within their order, or subtasks within their parent task.

Configure restarted numbering when you create or edit the field:

1. Turn on Auto-increment.
2. Under Numbering, select Restart numbering for each.
3. Select the scope field. You can use a single Select, a single Reference, or an Assignee field from the same workspace.

Each group restarts at 1. Blue assigns a number when the scope value is first set on the record. A record without a scope value stays unnumbered until you set one.

Grouped numbers do not change:

• A number is assigned once and stays with the record.
• Numbers are never reused. The next number in a group is the highest number ever used in that group, plus one.
• If you remove the scope value, the record keeps its number and the group keeps a gap.
• If you set the same scope value again, the record keeps its number.
• If you set a different scope value, the record gets the next number in the new group.

On the record panel, Blue shows the group size after the number, for example 2 of 5. This is the count of records that share the same scope value at that moment.

When you turn on restarted numbering, Blue numbers all records that already have a scope value.

Grouped numbers are unique only within their group. Two records in different groups can have the same number. For this reason, the GitHub integration does not accept Unique ID fields that use restarted numbering as linking fields.

Use Unique IDs

• Link records to external systems with a stable identifier.
• Refer to a record in an audit trail.
• Search for a record by ID after its name changes.
• Use sequential IDs for readable references and numeric integrations.
• Restart numbering per field value to number line items or subtasks within their parent record.