Custom task numbering (prefixes)

What is custom task numbering?

Sugester automatically assigns a unique number to each task (e.g. 1, 2, 3…). However, you can add your own prefix to make the numbers more readable and related to the project or team.

Examples:

• PRJ-123 - task number 123 with prefix PRJ
• DEV-456 - task number 456 with prefix DEV
• HR-78 - task number 78 with prefix HR

How to set a prefix?

The prefix can be set at three levels (in order of checking):

1. Project - all tasks in the project will have this prefix
2. Team - team tasks (when the project does not have a prefix)
3. Account - default prefix for the entire account

Setting via API

You set the prefix in the fields of the given object:

{
  "fields": {
    "organize": {
      "task": {
        "scope": "PREFIX"
      }
    }
  }
}

Example for a project:

PUT /organize/projects/{id}.json
{
  "project": {
    "fields": {
      "organize": {
        "task": {
          "scope": "DEV"
        }
      }
    }
  }
}

Requirements for the prefix

• Must start with a letter (a-z, A-Z)
• Can contain letters and numbers
• Valid: PRJ, Dev2, HR, Sprint1
• Invalid: 123, -PRJ, PRJ-

When is the prefix assigned?

The prefix is assigned to the task at the moment of its creation. Changing the prefix in the project later does not affect already existing tasks.

This means you can have tasks with different prefixes in one project if the prefix has been changed during the process.

Displaying the number with the prefix

The task number with the prefix (e.g. DEV-123) is displayed:

• On the task list (when enabled in settings)
• In the detailed view of the task
• In email notifications
• In time tracking reports