Create a project in Azure DevOps

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

You create an Azure DevOps project to establish a repository for source code and to plan and track work. You can manage and structure each project to support your business needs. Each project you create provides boundaries to isolate data from other projects. To learn more about projects and when to create one, see About projects and scaling your organization.

Important

Select a version from Azure DevOps Content Version selector.

To view the content available for your platform, make sure that you select the correct version of this article from the version selector which is located above the table of contents. Feature support differs depending on whether you are working from Azure DevOps Services or an on-premises version of Azure DevOps Server.
To learn which on-premises version you are using, see What platform/version am I using?

If you don't want to create a project in Azure DevOps, you can create Azure DevOps Projects.

Note

If you don't want to manage an on-premises server, you can sign up for Azure DevOps Services and create a project.

Prerequisites

  • You create a project within a project collection. If you haven't created a project collection yet, do that now. For more information, see Create a project collection.
  • You must be a member of the Project Collection Administrators group or have the Create new projects permission set to Allow. For more information, see Change project collection-level permissions.

Important

To create a public project, or to make a private project public, see Create a public project in your organization or Change the project visibility, public or private. Additional policy settings must be enabled to work with public projects.

Create a project

You can create up to 1000 projects within an organization defined in Azure DevOps Services. For additional project limits, see Work tracking, process, and project limits.

Important

When you create a project from the web portal, several process template files are ignored. Specifically, the files that would create a Report Manager site aren't supported. You can add reports later by following the instructions provided in Add reports to a teams project.

There isn't any limit on the number of projects that you can create within a project collection, however for performance purposes, we recommend you limit the number to 300 or fewer. To learn more, see Work tracking, process, and project limits.

  1. Select Azure DevOps logo Azure DevOps to open the Projects page.

  2. Choose the organization, and then select New project.

    Screenshot of Open Projects.

  3. Enter information into the form provided. Provide a name for your project. Your project name can't contain special characters, such as / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ], can't begin with an underscore, can't begin or end with a period, and must be 64 or fewer characters. Enter an optional description. Choose the visibility, initial source control type, and work item process. For more information, see Choosing the right version control for your project and Choose a process.

    Create new project form

    Select visibility of either public or private. When you choose public visibility, anyone on the internet can view your project. With private visibility, only people who you give access to can view your project. For more information about public projects, see Create a public project in your organization. If the Public option isn't available, you need to change the policy.

  4. Select Create. The welcome page appears.

    Project creation confirmation dialog.

    Select one of the following options to continue:

  1. Select Azure DevOps logo Azure DevOps to open the Projects page.

  2. Choose the organization, and then select Create project.

    Screenshot of Open Projects, current page.

  3. Enter information into the form provided. Provide a name for your project. Your project name can't contain special characters, such as / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ], can't begin with an underscore, can't begin or end with a period, and must be 64 or fewer characters. Enter an optional description. Choose the visibility, initial source control type, and work item process. For more information, see Choosing the right version control for your project and Choose a process.

    Create new project form, latest Azure DevOps

    Select your project visibility of either public or private. When you choose public visibility, anyone on the internet can view your project. With private visibility, only people who you give access to can view your project. For more information about public projects, see Create a public project in your organization. If the Public option isn't available, you need to change the policy.

  4. Select Create. The welcome page appears.

    Project creation confirmation dialog, current page.

    Select one of the following options to continue:

  1. Select Azure DevOps logo Azure DevOps to open the Projects page. Then, select New project.

    Choose new project, horizontal navigation

  2. Complete the form provided. Provide a name for your new project, initial source control type, work item process.

    On completion, the project summary displays. For more information, see Share your project, view project activity.

    New Project 2017

List and connect to projects

Connect to a project, collection, or server from your web browser.

  1. To view the projects defined for an organization, select Azure DevOps logo Azure DevOps to open the Projects page.

  2. Choose the organization to view the list of projects. The page lists the last two or three projects you connected to at the upper screen. Select any project to connect to that project.

    Screenshot of Open Projects, then select Create Project, preview page.

  3. Or, choose Organization settings and then select Projects to list all projects.

    Choose Organization settings and then select Projects to list all projects.

    You can choose a project to open project settings for that project on this page. For more information, see About settings at the user, team, project, or organization-level. Or, you can rename a project or delete a project.

  1. To view the projects defined for a collection, select Azure DevOps logo Azure DevOps to open the Projects page.

  2. Choose the collection to view the list of projects. The page lists the last two or three projects you connected to at the upper screen. Choose any project to connect to that project.

    Select any project to connect to that project, previous versions.

  3. Or, select Admin settings and then choose Projects to list all projects.

    Select Admin settings and then choose Projects.

    You can choose a project to open project settings for that project on this page. For more information, see About settings at the user, team, project, or organization-level. Or, you can rename a project or delete a project.

Add a repository to your project

From the admin context of the web portal, you can add additional repositories to a project. Add either Git (distributed) or TFVC (centralized) repositories. You can create many Git repositories, but only a single TFVC repository for a project. Additional steps to address permissions may be required. For more information, see Use Git and TFVC repos in the same project.

Next steps