About settings for users, teams, projects, or organizations

TFS 2017 | TFS 2015 | TFS 2013

You configure resources either for yourself or for your team, project, or project collection from the Settings page. The settings you can configure depend on the security group or administrative role that you belong to.

If you're just getting started as a Project Administrator, see Get started as an administrator.

User settings

Individual contributors can set their user preferences, enable features that are in preview, and manage their favorites and notifications.

Area

Supported tasks

Notes


Security

For an overview of default permission assignments by role, see Default permissions and access.


Authentication

For an overview of supported authentication methods, see Authentication overview.


Favorites

For an overview of supported authentication methods, see Authentication overview.


Notifications

Notifications alert you through email messages when changes occur to work items, code reviews, pull requests, source control files, builds, and more. When a project is created, a number of notifications are defined. If you want to opt out of these, you can.


Team administrator role and managing teams

Team administrators configure team resources, which mostly correspond to Agile tools and dashboards. To configure team resources, you must be added as a team administrator for the specific team, or be a member of the Project Administrators or Project Collection Administrators groups.

For a complete overview of all Agile tools that you can configure, see Manage teams and configure team tools.

Area

Supported tasks

Notes


Team profile

Members of a team are included within the team group, which can be used in queries and @mentions in pull requests and work item discussions.


Dashboards

New dashboards added to a project are associated with a team. The default permissions allow team members to create and edit dashboards for their team.


Notifications

Many team notifications are automatically defined when a team is added. For more information about how notifications are managed, see About notifications.


Project Administrator role and managing projects

Members of the Project Administrators group configure resources for a project and manage permissions at the project-level. Members of the Project Collection Administrators group can configure team settings as well.

See also Get started as an administrator.

Project-level settings
From the administrative Project settings page, you can configure settings available from the tabs shown in the following image.

Screenshot of Project settings tab selected, TFS versions.

Note

Project settings differ depending on your on-premises TFS version. Some settings aren't available for earlier versions of TFS.

Area

Supported tasks

Notes


General

  • Set project description

Update the project description or change its visibility.


Teams

A default team is created when you create a project. You add a team when you want to provide a group of users in your organization a set of Agile tools, which they have full ownership to configure and manage. Teams have access to a product backlog, portfolio backlogs, sprint backlogs, dashboards, team-scoped widgets, and more. For an overview of all tools that support a team, see About teams and Agile tools.


Security

Project Administrators can add users to a project or a team. When you add a user to a team, you automatically add them to the project. Users added to a project can only view and contribute to that specific project. For an overview of security concepts, see Get started with permissions, access, and security groups and About access levels. For a list of project-level permissions, see Permissions and groups reference, Project-level permissions.


Notifications

Many project-level notifications are automatically defined when a project is added. Notifications at the project-level are managed in much the same way as they are at the team level.


Service hooks

With service hooks, you can automate a task on other services, such as Campfire, Flowdock, HipChat, and more. You can use service hooks in custom apps and services to drive activities as events happen.


Dashboards

New dashboards added to a project inherit the default dashboard permissions. The default permissions allow team members to create and edit dashboards for their team.


Boards, Project configuration

Area and iteration paths set at the project level are then used to set team defaults. To configure additional product backlogs, Kanban boards, and dashboards, you first add a team.


Build and release (Agent Pools, Release)

Area and iteration paths set at the project level are then used to set team defaults. To configure additional product backlogs, Kanban boards, and dashboards, you first add a team.


Repos, Code version control

You can manage code using Git repositories or one TFVC repository..


Test

Manual testing relies on work item types to create and manage test plans, test suites, test cases, shared steps, and shared parameters. You can customize the test plans, test suites, and test cases using an inherited process. For more information, see Customize a process.


Wiki

To share information with your team, you can use Markdown format within a project Wiki, within your project README file, or other repository README file. For more information, see About READMes and Wikis.


Extensions

Individual contributors and project administrators can request a Marketplace extension is installed. Only members of the Project Collection Administrators group can respond to these requests and actually install extensions.


Team configuration

For more information, see About teams and Agile tools.


Service connections

For more information, see a list of common service connection types.


Project Collection Administrator (PCA) role and managing collections of projects

Members of the Project Collection Administrators group configure resources for all projects that are defined for an organization or collection. They also can do all tasks to add projects, manage projects, and manage permissions for the collection, a project, a team, or an object.

Collection-level settings
From the administrative page for a collection, you can configure the settings shown in the following image and listed in the following table.

Note

Project collection settings differ depending on your on-premises TFS version. Some settings aren't available for earlier versions of TFS.

Screenshot of Collection settings options, TFS.

For an overview of managing collections, see Configure and manage Azure DevOps Server resources.

Area

Supported tasks

Notes


Projects

A project provides the fundamental resource for storing your code, managing your CI/CD operations, and planning and tracking work for your project. In general, minimize the number of projects you create, to keep things simple. For more information, see About projects and scaling your organization.


Global notifications

Many notifications are automatically defined when an organization is added. Notifications at the organization-level are managed in much the same way as they are at the team level.


Extensions

An extension is an installable unit that contributes new capabilities to your projects. You can find extensions from within the Visual Studio Marketplace in the Azure DevOps tab to support planning and tracking of work items, sprints, scrums, and so on; build and release flows; code testing and tracking; and collaboration among team members.


Build and release

You manage resources that support CI/CD operations for all projects through the Agent pools page.


Server Administrator role

Members of the Team Foundation Server Administrators group configure resources for all project collections. They also can do all tasks to administer projects, collections, and server instances.

Server Administrators set access levels for a user or security group via the web portal. See Change access levels.

For more information, see Team Foundation Server Administration Documentation.