Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Create an Azure DevOps project to set up a source code repository and organize your work. You can tailor and manage your project to meet your business requirements. Each project isolates its data from other projects. For more information, see About projects and scaling your organization.
Important
Select the version of this article that corresponds to your platform and version. The version selector is above the table of contents. Look up your Azure DevOps platform and version.
Note
If you don't want to manage an on-premises server, sign up for Azure DevOps Services and create a project.
Tip
You can use AI to help with this task later in this article, or see Enable AI assistance with Azure DevOps MCP Server to get started.
Prerequisites
| Category | Requirements |
|---|---|
| Organization | An organization. |
| Permissions | Member of the Project Collection Administrators group or the collection-level "Create new projects" permission set to Allow. Organization owners are automatically members of this group. |
| Category | Requirements |
|---|---|
| Project collection | A project collection. |
| Permissions | Member of the Project Collection Administrators group or the collection-level "Create new projects" permission set to Allow. Organization owners are automatically members of this group. |
Create a project
You can create up to 1,000 projects within an organization in Azure DevOps. For more information, see Work tracking, process, and project limits.
Important
When you create a project from the web portal, Azure DevOps ignores several process template files. 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's no limit on the number of projects that you can create within a project collection. However, for performance purposes, limit the number to 300 or fewer. For more information, see Work tracking, process, and project limits.
Sign in to your organization (
https://dev.azure.com/{Your_Organization}).Select the
Azure DevOps logo to open the Projects page.Select New project.
Tip
If you don't see the New project button, you might not have the required permissions. You must be a member of the Project Collection Administrators group or have the "Create new projects" permission set to Allow.
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 initial source control type, and work item process. For more information, see Choosing the right version control for your project and Choose a process.
- Provide a name for your project. Your project name can't contain special characters, such as
Select Create. Azure DevOps displays the project welcome page.
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.
Sign in to your collection (
https://<your-devops-server>/<your-collection>).Select the
Azure DevOps logo to open the Projects page.Select New project. You can also create a project from a process.
Tip
If you don't see the New project button, you might not have the required permissions. You must be a member of the Project Collection Administrators group or have the "Create new projects" permission set to Allow.
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 initial source control type, and work item process. For more information, see Choosing the right version control for your project and About processes and process templates.
- Provide a name for your project. Your project name can't contain special characters, such as
Select Create. Azure DevOps displays the welcome page.
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.
List projects
View a list of projects from your web browser.
Sign in to your organization (
https://dev.azure.com/{yourorganization}).Select Organization settings and then select Projects.
Open your desired project. For more information, see About settings at the user, team, project, or organization-level.
Add a repository to your project
You can add Git (distributed) or TFVC (centralized) repositories to your project. You can create many Git repositories, but only a single TFVC repository for a project. You might need to take extra steps to address permissions. For more information, see Use Git and TFVC repos in the same project.
Use AI to create and configure projects
Tip
You can use AI to help with this task later in this article, or see Enable AI assistance with Azure DevOps MCP Server to get started.
If you use GitHub Copilot, the Azure DevOps MCP Server can help you create and configure Azure DevOps projects through natural language prompts.
Example prompts for project creation
| Task | Example prompt |
|---|---|
| Bootstrap a new project | Create a new Azure DevOps project for our mobile app team using the Agile process template, initialize it with a Git repo, and set up the default area and iteration paths for a 2-week sprint cadence |
| Migrate project structure | We're splitting a monorepo project into separate microservice projects. Walk me through creating the new projects, moving repos, and preserving work item links across projects |
| Set up a project from a template | I need to create standardized projects for each client engagement. Show me how to create a project with predefined teams, area paths, and iteration paths that match our delivery framework |
| Troubleshoot project creation | I'm getting a TF30321 error when trying to create a project with a name I used before. Explain why this happens and how to resolve it so I can reuse the name |
| Audit existing projects | List all projects in my organization, show when each was created and last accessed, and identify any that might be candidates for deletion or archiving |
| Configure project permissions | I just created a new project and need to set up security so that only the core team has Contributor access, external stakeholders get Stakeholder access, and the tech lead group can manage repos and pipelines |
Tip
For the best results, use these prompts in agent mode with the Azure DevOps MCP Server connected. Customize the prompts with your specific organization name, process template, or team structure.
Next steps
Related content
Frequently asked questions (FAQs)
Q: How do I resolve permission-related errors?
A: If you receive an error message that states you don't have permission to create a project, request organization-level permissions. See Change permissions at the organization- or collection-level.
A: If you receive an error message that states you don't have permission to create a project, request collection-level permissions. See Change permissions at the organization or collection-level. If you have SQL Reporting Services installed in the collection, you also need permissions for reports to the Team Foundation Content Managers group.
Q: How do I resolve Error TF30321?
A: Error TF30321: The name you entered is already used for another project on the Team Foundation Server indicates that you should use a different name for your project. The name you entered is either in active use or is partially deleted but not fully deleted.
Even when you deleted a project, you might get the same name error. Some components might be created or deleted even though others aren't. In this event, you can't reuse the name associated with the project.
Q: How do I add my custom process template to the list?
A: Upload your template by using the Process Template Manager. For more information, see Customize process.
Q: Where is the log file located?
A: The log file is stored in $:\Users\user name\AppData\Local\Temp and labeled vso_TeamProjectCreation_yyyy_mm_dd_hh_mm_ss.log.
The log shows each action taken by the wizard at the time of the failure and might include more details about the error. You can review the log entries to find network or file related problems by searching for Exception or Error.
Q: How do I add SQL Server Reporting services?
A: See Add reports to a project.