Create a team project

VSTS | TFS 2018 | TFS 2017 | TFS 2015 | Previous versions


If you don’t want to manage an on-premises server, you can sign up for VSTS and create a team project. This topic applies to creating a team project when you have an on-premises Team Foundation Server (TFS) deployed.

Create a team project to establish a repository for source code and a place for a group of developers and teams to plan, track progress, and collaborate on building software solutions. Team projects differ from software application projects or solutions.

If you have a team project already, and want to start coding an application project, then see one of the following topics: Set up Git on your dev machine or Develop your app in Team Foundation version control.


When you create a team project from the web portal, several process template files are ignored. Specifically, the files that would create a Report Manager site and a SharePoint project portal aren't supported. These features aren't supported for VSTS.

If you want these features to be to be available on your on-premises TFS, then create your team project from Visual Studio or Team Explorer. For details, see Process template and plug-in files, Client support for project creation.

From the web

  1. If you're not a member of the Project Collection Administrators Group, get added as one. To create team projects you must have the Create new projects permission set to Allow.

  2. Navigate to the administration overview page by choosing the Settings Icon (TFS Web Portal) gear icon at the top of the page.

  3. Choose New team project....

    New Team Project VSTS

  4. Provide a name for your new team project, select its initial source control type, select a process, and choose with whom to share the project.

    See choosing the right version control for your project and choose a process for guidance.

    Create Team Project VSTS

From Team Explorer

You can create a team project from Team Explorer after you have connected to an on-premises server.


For TFS 2018 and later versions, users will be redirected to the web. They will no longer be able to create a team project from Visual Studio.

TFS 2018 and later versions no longer support native integration with SharePoint products. If you're planning to upgrade to TFS 2018, read About SharePoint integration to learn about the options available to you.

  1. If you're not a member of the Project Collection Administrators Group, get added as one. To create team projects you must have the Create new projects permission set to Allow.

  2. Ask your TFS administrator about the following resources and get additional permissions as needed:

    • Which team project collection you should connect to when you create your team project? If you installed TFS using the Basic Server Configuration Wizard, you have only one project collection named DefaultCollection. Unless you work in an enterprise organization and will be supporting hundreds of team projects, you should add all your team projects to a single project collection. If you need to create additional collections, see Manage team project collections.

    • Has SQL Server Analysis Services and SQL Server Reporting Services been configured for the deployment? If so, ask your administrator to add you as a member of the Team Foundation Content Managers group on the server that hosts SQL Server Reporting Services. Without these permissions, you’ll be unable to create a team project.

    • Has a SharePoint Web application been configured for your deployment? If you want to configure a SharePoint portal when you create your team project, ask the SharePoint administrator to give you Full Control permissions on the server that hosts SharePoint Products. Otherwise, you can skip this step and configure a portal at a later time.

  3. Open the same version of Visual Studio as the version of TFS that you're connecting to. If you don’t see the Team Explorer pane, open View>Team Explorer from the menu.

    As needed, Download and install Visual Studio Community to get a free copy of the latest version.

  4. Connect to the server and team project collection where you want to create your team project.


    You can access Team Explorer for free by installing Visual Studio Community or any other Visual Studio version.

    You must connect from a client that is at the same version level as TFS. That is, you must connect to TFS 2015 from a version of Visual Studio 2015.


    Tip: If you are running Team Explorer from a server that hosts SharePoint Products and SQL Server Reporting Services, you might need to run Visual Studio as an administrator.

  5. If it’s your first time connecting to TFS, you’ll need to add TFS to the list of recognized servers.


  6. Open the New Team Project Wizard.

    New link on Connect page (Team Explorer)

  7. Name the team project. Don’t specify more than 64 characters.


  8. Choose a process template. For a comparison of the default process templates, see Choose a process.


  9. Choose your version control, either Git distributed repositories or TFVC, one centralized repo.


    Not sure which system to use? Learn more about Git or TFVC.

    After you've created your team project, you canadd repositories.

  10. Unless your team project collection is configured to support a SharePoint project portal, you’re done.


    If the Next button is active, you can configure your project portal.

    If the wizard encounters a problem, you’ll receive an error message and a link to the project creation log. Review the log file for specific errors and exceptions.

  11. When you’re finished, you can see your team project in Team Explorer. You can also choose the Web Access link to connect to your team project from the web portal.

    Team Explorer Home page w/ TFVC as source control Team Explorer Home page with Git as source control

Try this next

Add team members to enable other users to connect to your team project.

Also, with the team project created, you can start developing your app in Team Foundation version control or use Git.

To start planning work and collaborating as a team, see Agile tools.

Add repositories

From the admin context of the web portal, you can add additional repositories to a team project, either Git (distributed) or TFVC (centralized). While you can create many Git repositories, you can only create a single TFVC repository for a team project.

Add repositories to an existing team project

Feature availability: The ability to work from both Git and TFVC repositories from the same team project is only supported when you connect to VSTS or an on-premises application server that you've upgraded to TFS 2015 Update 1. Additional steps to address permissions may be required. See Git team projects or TFVC team projects.