customize-cards.md

title	titleSuffix	description	ms.global_help.title	ms.global_help.keywords	ms.technology	ms.prod	ms.assetid	ms.manager	ms.author	author	ms.topic	monikerRange	ms.date
Customize cards on a board	VSTS & TFS	Customize cards on the Kanban or Sprint/Scrum/Task boards in Visual Studio Team Services & Team Foundation Server	Customize cards	ms.vss-work-web.boards-hub, 6	devops-agile	devops	951A73EA-7411-4A2A-B3F0-ACBBC7EFC68F	douge	kaelli	KathrynEE	conceptual	>= tfs-2013	03/20/2018

Customize cards

VSTS | TFS 2018 | TFS 2017 | TFS 2015

::: moniker range=">= tfs-2013"

Note

Reordering cards requires TFS 2015 or later version.
::: moniker-end

::: moniker range=">= tfs-2015" While many work tracking views show up as lists—such as your backlogs and queries—board views display cards. Information rich cards not only provide at-a-glance info of interest to you and your team, they also provide a way for you to update a field without opening the work item. And, with style rules, you can highlight those work items with select colors based on the criteria you set.

Each card corresponds to a work item which you use to share information, track status, and assign work.

In this example, the bug work item type (WIT) shows all the core fields, three additional fields, and tags. Also, To make severity 1 bugs stand out, a styling rule has been added to cause the card to display as yellow.

In the card shown below, the following customizations have been set for the bug work item type (WIT):

• Show all core fields: ID, Assigned To, Story Points, Tags
• Show three additional fields: State, Changed By, and Changed Date
• Apply tag colors
• Apply styling rule to display bugs with Severity=1 as yellow and bold and underline the Title field

::: moniker-end

::: moniker range="vsts"

Note

You can customize a work item type which is different then customizing the card displayed on the Kanban board or taskboard. You customize a WIT by adding fields, changing the workflow, adding custom rules and more. You can also add custom work item types and custom backlog levels. For details, see Customize an inheritance process.

::: moniker-end

::: moniker range=">= tfs-2015 <= tfs-2018"

Note

You can customize a work item type which is different then customizing the card displayed on the Kanban board or taskboard. You customize a WIT by adding fields, changing the workflow, adding custom rules and more. You can also add custom work item types and custom backlog levels. For details, see Customize the On-premises XML process model.

::: moniker-end

You can either increase or simplify the information that displays on your cards. It all depends on what's of interest to your team. Does your team like to refer to work items by their ID? Do they want to see estimates? Do they want to highlight work items according to set criteria? Or, will just the bare bones of title and assignment suffice?

Your best bet is to show fields on cards based on what your team frequently refers to or updates when using the Kanban and task boards. Also, add fields with information that you can use to filter the board. If you're new to working with these tools, see Kanban basics and Sprint planning.

Add fields and update them from the board

Using the board views provides you with quick and easy ways to update work items as work progresses. Making daily or frequent updates helps everyone on your team stay in sync with what's been done and what needs doing next.

To update status of a work item, you simply drag-and-drop cards to a different column. To change the order or stack ranking of a work item, you drag a card up or down within a column.

For example, on the Kanban board, moving the card from Analyze to Develop updates the corresponding State field. In this case, the State field updates from Approved to Committed.

Another handy feature is to simply update a field without having to open the work item. You can update most fields shown on the card. Here we reassign a requirement.

This quick update feature is particularly useful when you need to update a number of work items at once. For example, you can add estimates for backlog items on the Kanban board or update remaining work on the task board.

To change the title, click the pencil icon in the upper-right corner. To add tags, double-click the work item to open it. And, just a reminder, you can't change the IDs for a work work item, not from the card and not from within the form.

To customize cards on the Kanban board, see Change how cards display on the Kanban board. To customize task board cards, see Change how cards display on the task board.

Highlight work items based on custom criteria

With styling rules, you can cause cards to change color when their corresponding work items meet criteria that you set. Here, we highlight severity 1 bugs by having the cards display as yellow.

::: moniker range="tfs-2015" This feature requires TFS 2015.1 or later versions. ::: moniker-end

Example styling rules

What rules should you apply to highlight work items? Here are a few examples and their associated criteria .

[!div class="mx-tdCol2BreakAll"]

Work items	Criteria
High priority items	Priority = 1
High effort items	Effort 20 or Story Points 20
Stale items unchanged in the last 5 days	Changed Date @Today-5
Title contains a key word	Title Contains Yes
Severity 1 bugs	Severity = 1 - Critical AND Work Item Type = Bug
High value business items	Business Value 50
Items assigned to specific feature area	Area Path Under Fabrikam Fiber\Phone
Contains specific tag	Tags Contain RTM
Blocked tasks (Scrum process only)	Blocked = Yes

Change how cards display on the Kanban board

As a first step, you'll see that you can change the card display for each work item type (WIT) that shows up on your Kanban board.

0. From your Kanban board, click the gear icon to open Settings.
   ::: moniker range="vsts || >= tfs-2017 <= tfs-2018"
   
   ::: moniker-end
   ::: moniker range="tfs-2015"
   
   ::: moniker-end
   If you're not a team admin, get added as one. Only team and project admins can customize cards. Learn more about accessing and using your Kanban board from Kanban basics.

1. Select the WIT you want to customize. Different WITs may present different options for customization.

   Here we choose User Story. Your choices will vary based on the process used to create your team project and whether your team has chosen to treat bugs like requirements or like tasks.

   ::: moniker range="vsts || >= tfs-2017 <= tfs-2018"
   
   ::: moniker-end
   ::: moniker range="tfs-2015"
   TFS 2015.1 options:
   
   TFS 2015 options:
   
   ::: moniker-end

2. Once you've clicked a WIT, select all the options that you want for that work item type.

   If you want work estimates to show, check the Show Effort, Story Points, Size, or Cost option. Cost corresponds to these fields: Effort (Scrum), Story Points (Agile), and Size (CMMI) field.

3. To add a field to a card, click to select a field from the drop-down menu.

   

4. To add a custom field, you must first add it to the WIT definition.

   Here we've added three fields:
   

   

   [!TIP]
   You can edit a value in a field you add to a card, unless it's a read-only field, such as the Change By and Changed Date fields. You can also customize the cards that appear on the Kanban board for features and epics. You follow similar steps, however you start from the corresponding portfolio backlog.

Change how cards display on the task board

Scrum teams use the task board to burn down work and report on progress during daily standups. Your task board shows cards that correspond to both requirements and tasks. If you want bugs to appear on the task board, change your team settings for show bugs on the backlogs and boards.

You change the way cards display on the task board the same way you change the Kanban cards display. Only here, you start from the task board.

1. Open Settings from your task board.

   

   Remember, only team or project administrators can customize the task board.

2. Just as before, choose the WIT you want to customize, and then checkmark or select the options you want.
   ::: moniker range="vsts || >= tfs-2017 <= tfs-2018"
   
   ::: moniker-end
   ::: moniker range="tfs-2015"
   TFS 2015.1 options:
   
   TFS 2015 options:
   
   ::: moniker-end

3. Repeat this step for each WIT you want to change. Don't be surprised if the options change when you click on a different WIT. For example, Show Remaining Work only applies to tasks and perhaps bugs, but not to PBIs or requirements.

4. To add a field to a card, click the add field icon to select a field from the drop-down menu.

Add style rules to highlight work items with color

1. To cause a card on the Kanban board to change color based on criteria you specify, open Styles. Add a styling rule and set the criteria for the rule.

   ::: moniker range="tfs-2015" Requires TFS 2015.1 or later version. ::: moniker-end Follow these rules when creating and ordering your style rules: - The criteria you specify works in a similar fashion as when [constructing a query](../track/using-queries.md) - All clauses are considered AND clauses, grouping clauses isn't supported - Card rules apply to all work items that meet the rule criteria - Rule color applies to work items based on the order in which rules are listed. If you add more than one style rule, make sure that you move them in the order of most importance. Simply drag them into the order you want them applied. - You can quickly enable and disable a style rule

2. To highlight work items on the task board, open Styles from the task board Settings and add a styling rule.
   Here we add a Stale tasks rule which highlights tasks that haven't changed in the last five days.

   

Add color to your tags

1. Prior to setting tag colors, first add tags to backlog items that you want to highlight with color.

2. To add color to Kanban cards, open Tag colors and select a tag and the color you want it to display.

   ::: moniker range="tfs-2015" Requires TFS 2015.1 or later version. ::: moniker-end If tags don't display on the cards, open Fields and make sure that you've checked Show Tags.

::: moniker range="vsts || >= tfs-2017 <= tfs-2018"

Annotations

With the Kanban board, you gain a rich set of tools and a rich set of customization options. Annotations provide visual cues about work items, indicating the number of tasks or tests that have been defined for that work item. Click an annotation to expand the set or gain more information.

As shown in the following examples, the Task and Test annotations indicate that two each of tasks and tests have been defined for the work item. If you find that there are some features you're not using, you can disable them from the Annotations tab.

[!div class="mx-tdBreakAll"]

Task annotations	Test annotations	No annotations

To learn more about using these features, see Add task checklists and Add, run, and update inline tests.

::: moniker-end

::: moniker range="vsts || >= tfs-2017 <= tfs-2018"

Enable or disable an annotation

1. To open, click the gear icon from your team's Kanban board.

   

   If you're not a team admin, get added as one. Only team and project admins can set team settings.

2. From the Annotations tab, check those annotations that you want enabled. For example, to enable tasks but disable tests, check the following boxes.

   

   The setting you choose applies to all active Kanban boards for your team, i.e., backlog, features, and epics.

::: moniker-end

::: moniker range="vsts || >= tfs-2017 <= tfs-2018"

Configure inline tests

You can control the test plan under which inline tests you add through the Kanban board are created. You can choose to create a new test plan for each new test that you add, or add all new tests to a selected test plan going forward.

1. To open, click the gear icon from your team's Kanban board.

   If you're not a team admin, get added as one. Only team and project admins can set team settings.

2. From the Tests tab, choose the option you want. You must enable the Test annotation feature in order to configure tests. To select a test plan, click the actions icon and select one test plan from the query provided.

   

3. Save your changes.

Open the test plan, test suite from a card

From a card on the Kanban board, you can easily navigate to the underlying test plan and test suite under which the tests are created. Click the open icon to open another browser tab showing the Test hub and associated test plan and test suite that controls the inline tests.

::: moniker-end

Related articles

That's all there is to card customization. See these choices for further options to customize the Kanban and task board:

• Add, rename, move, and delete columns
• Card reordering
• Split columns
• Expedite work
• Show bugs on backlogs and boards