Customising Task Properties

Modified on Wed, 23 Nov 2022 at 12:00 PM

Boards help teams visualise the flow of work, work collaboratively and get work done in a structured manner. 

In this article we will discuss how you can customise your boards to collect custom data that is relevant to your business process.

Regardless of the business domain, all boards consist of vertical columns to indicate which stage a task is in, tasks (or cards) that represent the work to be done, and themes (or epics / swimlanes) to group tasks that have the same organisation goal or belong to the same body of work.

Task properties allow you to add custom data to board cards to better describe your business process. For instance, they can be used to:

  • indicate which client a task is for
  • link to the project the submission is for
  • add additional business data like the sponsoring organisation or the executive sponsor
  • track the submission date or the submitter name

Below is an example of a Demand Management board using board task properties: 

In this article, you will learn how to:

          Create custom task properties

          Create custom task types

          Set custom task property values

Board settings page

You can customise board task properties at the time of the board creation or by navigating to the Board settings page if the board already exists. 

To access the board settings page, click on the Edit button on the top right of the board or backlog page.

NOTE: Only board owners can access the board settings page and customise themes.

Creating Board Task Properties

To create new task properties, you need to navigate to the Properties section located below the Task Types section on the board settings page.

Click on the Add Property button to open the dialog to create a new task property. (To edit an existing property, click on the pencil icon next the property name).

  • Data Type
    • This field is mandatory and describes the type of property you want to create.
    • You can learn more about custom properties data types here.
  • Name 
    • This field is mandatory and is the title of the property.
  • Label
    • If the name of the property is a technical name or a long name for instance, you can set a label to make the property more user friendly. The label will be used on the board cards instead of the property name.
  • Category
    • You can group task properties into categories. Simply give the name of the category the property applies to.
  • Select the types the property applies to (optional)
    • If the property only applies to certain task types, use this field to list the task types the property applies to. The property will then be visible on the board task dialog only if the task type is listed in the property definition.
    • Leave this field empty if the property applies to all tasks.
  • Required
    • Indicates whether the property is mandatory when a new board task is created.
  • Reportable 
    • Set the switch to Yes if the property should be displayed on the board card. 
    • Board cards can become very busy if all properties are displayed. Therefore, use this flag to only make the most important properties visible on the board. 
  • Hide to non board members
    • This property is important if your board is a community requests board. It allows you to set whether the property should appear on the work request form.
    • If it should not, set the value to Yes to make the property only visible to owners or members of the board.

Depending on the Data Type selected for the custom property, additional fields will be presented to set a default value for the new property or to set the list of options.

Setting Task Properties

Custom task properties can be set when creating a new task or editing an existing task. They are listed in the task dialog and are visible on the board card if they have been set to Reportable.

It is important to remember that you will only see the properties that apply to the type of task you are creating or editing.

You will be asked to enter a value for all properties that have been set as required. Note that the board card will only display the properties that have been set to reportable.

Grouping Task Properties

Custom task property values can be grouped as a way of managing board tasks. This functionality can be accessed from the board page or the backlog page using the Group option.

Once you click on the drop down on the Group option, select which task property you want to display and all board tasks with that property value will be displayed.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article