Share your project vision, view project activity

Last Update: 3/28/2017

Team Services


Feature availability: The project page described in this topic is in preview for Team Services. It is enabled or disabled when you enable or disable the Account Landing Page from your profile/account menu. For users of TFS 2017.1 and later versions, this feature is enabled by default and can't be turned off.

You can quickly get started with a team project from the project page. You can share your project vision with your team, add team members, and check the latest activity. Use this page to leverage all the built-in DevOps functionality of Team Services and to perform the following activities:


The features and functions available from your project page depend on the source control—Git or Team Foundation Version Control (TFVC)—that you selected when you created your team project.

Git repository

TFVC repository

To view the project page, open your web browser to the following URL:


If your page isn't similar to one of the following images, then you need to enable the feature.

Get started with a new team project

Upon adding a team project to your collection, you'll see the get started page. This page guides you to get started quickly by adding code to your repository when you choose one of the options to clone, push, import, or simply initialize a repo. You can easily get started by adding members, setting up builds, or adding work from this page.

Git repository

Git new project

TFVC repository

TFVC new project

Share your project vision

You can share your project vision and objective, as well as ways for team members to contribute to the project through a Project readme.

To edit the project file, click the Edit button. You'll need to be a member of the Project Administrators group or have your Edit project-level information permission set to allow.

You can use Markdown language to format the README file and add images. To learn more about adding a README file, see Create a README for your repo and Markdown guidance.

Example project home page

Use these pages to orient contributors to working within your project. Consider adding guidance about:

  • The project focus
  • Prerequisites
  • Setting up the environment
  • Tips for getting things done within the project
  • Purpose or use of specific files
  • Project-specific terms and acronyms
  • Workflow guidance about committing or uploading changes and adding branches
  • Project sponsors or contacts

View cross project activity

In addition to sharing information, the project home page pulls data from the various functional hubs to give visitors a bird's-eye view of your project activity.

Project Home Page, Activity

To add team members or manage membership in the team project, click Add team members button Add button.

Required permissions

To edit information on the team project page or manage team membership, you must be a member of the Project Administrators group or have your Edit project-level information permission set to allow.

To view the team project page, you must be a valid member of the team project. For more information, see Permissions and groups, Valid user groups.