Create a project in Azure DevOps
Azure DevOps Services | Azure DevOps Server 2020 | 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
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 need an organization before you can create a project. If you haven't created an organization yet, create one by following the instructions in Sign up, sign in to Azure DevOps, which also creates a project. Or see Create an organization or project collection.
- You must be a member of the Project Collection Administrators group or have the collection-level Create new projects permission set to Allow. If you're the Organization owner, you're automatically added to the Project Collection Administrators group. For more information, see Change project collection-level permissions.
- 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.
Select
Azure DevOps to open the Projects page.Choose the organization, and then select New project.
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.
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.
Select Create. The welcome page appears.
Select one of the following options to continue:
- Invite: add others to your project. See Add users to a project or team. You can only invite users who are already in your organization. For more information, see Add users to a project.
- Boards: add work items. See View and add work items using the Work Items page.
- Repos: clone or import a repository, or initialize a README file for your project summary page. See Clone an existing Git repo.
- Pipelines: define a pipeline. See Azure Pipelines documentation.
- Test Plans: define test plans and test suites. See Create test plans and test suites.
- Artifacts: discover, install, and publish NuGet, npm, and Maven packages. See the Azure Artifacts overview.
- manage your services: disable the visibility of services. See Turn a service on or off.
Select
Azure DevOps to open the Projects page.Choose the organization, and then select Create project.
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.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.
Select Create. The welcome page appears.
Select one of the following options to continue:
- Invite: add others to your project. See Add users to a project or team. You can only invite users who are already in your organization. For more information, see Add users to a project.
- Boards: add work items. See View and add work items using the Work Items page.
- Repos: clone or import a repository, or initialize a README file for your project summary page. See Clone an existing Git repo.
- Pipelines: define a pipeline. See Azure Pipelines documentation.
- Test Plans: define test plans and test suites. See Create test plans and test suites.
- Manage your services: disable the visibility of services. See Turn a service on or off.
Select
Azure DevOps to open the Projects page. Then, select New project.
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.
List and connect to projects
Connect to a project, collection, or server from your web browser.
To view the projects defined for an organization, select
Azure DevOps to open the Projects page.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.
Or, 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.
To view the projects defined for a collection, select
Azure DevOps to open the Projects page.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.
Or, select Admin settings and then choose 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.
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
Related articles
Feedback
Submit and view feedback for