Create Custom Task IDs

Create unique task IDs for your Workspace.

Custom task IDs are automatically applied to subtasks.

Screenshot highlighting a custom task ID in task view.png

What you'll need

Enable the Custom Task IDs ClickApp

Workspace owners and admins can enable the Custom Task IDs ClickApp for your Workspace. 

To activate the Custom Task IDs ClickApp:

  1. Open the App Center.
  2. From the App Center's left sidebar, click All ClickApps.
  3. Browse or search for the Custom Task IDs ClickApp.
  4. Click the toggle to activate the Custom Task IDs ClickApp.
  5. You can use the dropdown menu to activate the ClickApp in specific Spaces.

When you enable Custom Task IDs for a Space, you'll be prompted to set the task ID prefix and starting index.

Set Custom Task ID prefix and starting index

When you enable Custom Task IDs for a Space, you'll be prompted to set the task ID prefix and starting index.

Task ID prefixes will always be in all caps. Only alphanumeric characters and underscores are supported. The starting index must be a number greater than 0.

Tasks will be assigned the new Custom Task ID based on their date created, from oldest to newest.

For example, you enter a prefix of CLK and a starting index of 1. The oldest task in the Space will use the Custom Task ID: CLK-1.

Edit custom task IDs

Once a custom task ID is created, a Workspace owner or admin can edit them at any time.

To edit custom task IDs:

  1. Navigate to the Space where you'd like to make the edits.
  2. Click the ellipsis ... beside the Space to open the settings menu.
  3. Select More.
  4. Select Customize Task IDs.
  5. Update the task ID.
  6. Click Save.

Show custom task IDs in List view

You can display the custom task IDs in List view.

To show custom task IDs:

  1. Open any List view with custom task IDs.
  2. Click the + icon to add a column.
  3. Select Custom Task ID to display the Custom Task ID column.

Screenshot of someone adding the Custom Task ID field to a List view.png

Show custom task IDs in Board view

You can also display custom task IDs in Board view. 

To show custom task IDs:

  1. Open any Board view with custom task IDs.
  2. In the upper-right corner, click Customize and select Fields.
  3. Search for and enable Custom Task ID to display the Custom Task ID on each card.

Use custom task IDs with integrations

You can use Custom Task IDs with our git integrations. Read more about how to get those set up here:

If Tasks in Multiple Lists is enabled, you must link your git repo to the Space containing the Home List task. Linking your repo to a Space that does not contain the Home List will not work.

See original task ID

Open any task and double-click its custom task ID to see its original task ID!

Was this article helpful?