Edit

Share via


Azure Boards configuration and customization FAQs

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

You have many options to configure and customize an Azure Boards project. If you're new to this subject, see Azure Boards Configuration and Customization. Here you find answers to frequently asked questions about configuring or customizing Azure Boards. For FAQs specific to using Azure Boards or working with queries, see Azure Boards FAQs and Query FAQs.

General

Can sub hubs within Azure Boards be disabled?

No. You can disable an entire service, such as Azure Boards, Azure Repos, or Azure Pipelines, but you can't disable individual pages within a service. For more information, see Turn a service on or off.

Are there set limits regarding configuration or customization?

Azure DevOps imposes limits such as the number of Area Paths and Iteration Paths you can define for a project, the number of processes you can define, and more. For a full list, see Work tracking, process, and project limits.

Configuration

Who has permissions to configure Azure Boards?

In general, you need to be a member of the Project Administrators group to configure the following project-level objects. You can also grant permissions at the node level or object level to individual members or groups. For more information, see Change project-level permissions.

To grant permissions to an individual member or group to perform the following tasks, you must set the corresponding project-level permissions to Allow. See Change project-level permissions.

In general, you need to be a member of a team or have the Team Administrator role to configure the following team-level objects.

Customization

Who has permissions to customize Azure Boards?

In general, you need to be a member of the Project Collection Administrators group to customize an Inherited process, or have the following explicit collection-level permissions set to Allow:

To grant a project member permissions, see Change project-level permissions.

To modify an On-premises XML process, you need to be a member of the Project Collection Administrators group to manage process templates or the Project Administrators group to exercise a witadmin command. Or, have the following explicit collection-level permissions set to Allow:

Is there a way to determine who changed what within a process?

Auditing of process changes is available for Azure DevOps Services (cloud) only. For more information, see Access, export, and filter audit logs.

A best practice is to maintain process templates under source control so that changes are tracked through standard versioning.

How do I change the picklist of values?

Picklist value entries depend on the data type. Refer to the following articles based on the field type of interest:

Can I add or rename a portfolio backlog?

Yes. You can add up to five portfolio backlogs total. You can also rename a portfolio backlog and add custom work item types to it.

To learn how, see Customize your backlogs or boards (Inheritance process) or Add a portfolio backlog level (On-premises XML process).

How do I add my custom work item type to a backlog?

Modify your requirement backlog to include the custom work item type on the product backlog. For details, see Customize your backlogs or boards, Edit or rename the requirement backlog.

Note

The backlog level to which you add a custom work item type determines the parent work item type(s) for the work item type.

Can caching impact rules applied to work items?

Yes. Conditional rules based on user or group membership are cached for your web browser. If you find yourself restricted from updating a work item, you might have encountered one of these rules. If you believe the restriction doesn't apply to you, see Work item form IndexDB caching issues. To learn more about conditional rules, see Rules and rule evaluation.

Can I upload my own custom work item type icons for an Inherited process?

Example request: When I create a new work item type, I get an option to choose an icon. The icon set is limited and doesn't support the icons that we would prefer for our use case. Is there a way to associate a custom icon with a new work item type?

No. Uploading custom icons isn't a supported feature at this time.