Use the Project or Roadmap app in Teams

Add a Project or Roadmap tab to a Teams channel

When you add a tab using the Project or Roadmap app, you can either add an existing project or roadmap, or create a new one.

1. In your Teams channel, select Add a tab +.

   

2. In the Add a tab dialog box, choose Project or Roadmap (you may have to use Search to locate them).

   

   : If you don't see the apps when you search, you might be searching from Chat or from a private Teams channel. The Project and Roadmap apps aren't available from those locations.

3. In the Project or Roadmap dialog box, do one of the following:

   

   • To create something new, choose Create New Project or Create New Roadmap, and then type a name for your project or roadmap. All newly created projects will be automatically placed in the default environment.

     

   • To add an existing project or roadmap, choose from the list. In the brackets, you will be able to see the environment from which the project is stored.  

     : If you don't see an existing project or roadmap in the list, it might not be shared with your team. Find it on project.microsoft.com and in the upper right of your project or roadmap, select Group members to find out what Microsoft 365 group it's shared with or to share it with the group associated with your Team.

4. Choose whether to post to the channel about the tab, and then select Save.

   The tab will be added alongside your other team channel tabs, and you'll be able to start working with it there.

   

Repeat this procedure to add as many projects or roadmaps as you want for your channel.

Work on your project in Teams

In the Project app, you can do almost everything you can do in Project for the web. Here are some resources to get you started :

• Get started with Project for the web

• Build a project in Grid and Timeline views

• Organize your project in Board view

• Share a project and assign tasks

One thing you can't do in the Project app in Teams is copy a project. You'll need to go to the Project for the web website (in your Project tab, choose Go to website) to Copy a project. 

Work on your roadmap in Teams

In the Roadmap app, you can do everything you can do in the web version of Roadmap. Find out more about using Roadmap by watching Welcome to Roadmap, or get started with some of these actions:  

• Connect a row to Project

• Share a roadmap with a group

Remove a Project or Roadmap tab

When you're done using a Project or Roadmap tab in Teams, you can remove it from your team channel but keep the underlying project or roadmap. 

1. In your team channel, select the Project or Roadmap tab you want to remove, select the arrow next to the tab name, and select Remove.

   

2. In the Remove dialog box, select Remove.

If you want to access your project or roadmap after the tab has been removed from your Teams channel, you can either add it back as a tab or find it at project.microsoft.com. 

Delete a project or roadmap

If you want to completely delete both the Project or Roadmap tab in Teams and the underlying project or roadmap, follow these steps.

Open your project or roadmap on the web

All projects and roadmaps that you've created in Teams or added to a Teams channel can also be found on the web. There are two ways to find them:

• From the project or roadmap tab in Teams:    In Teams, select your team and channel and select the project or roadmap tab you want. To the far right of your tabs, choose the Go to website icon.
  
  
  
  A browser window will open showing your project or roadmap.

• From Project home on the web:    Go to project.microsoft.com and look for your project or roadmap by name under Recent, Shared with me, or Created by me. Choose Show more if you don't see it at first. Select the project or roadmap name to open it.

Add Teams conversations to Project Tasks

Project Teams app users can have Teams conversations around specific tasks. Use the conversation icon on task detail pane to open the ‘conversation pane’. Alternatively, you can open a conversation using the ‘view conversation’ button. 

Start the conversation by typing something and sending it. Any previous messages in the conversation will be shown in the conversation pane. 

All tasks which have an existing conversation will have an icon indicator in the Quick look column.

Here are a few things to keep in mind when using this feature:

• Each task can only have one conversation associated with it.

• Users can start, respond, and view Teams conversations for tasks only within the Project Teams app. The user also must have a Teams license.

• The conversation associated to a task is stored in the Teams channel where the conversation was initiated. Users can view the conversation within the Project Teams app and within the “Posts” tab of the channel.

• If a channel is deleted, all conversations associated to that task and channel are also deleted.

• If a Project is pinned to multiple channels, a conversation associated to a task will remain stored in the channel where the conversation was initiated. A conversation can only be stored in one channel.

• If you do not see this feature, it is because you are on older version of CDS. Please reach out to your admin to upgrade your CDS to 1.0.14.98 or later.

Troubleshooting guide for Project in Teams

I am unable to locate the specific project that I wish to add in the list of available projects for integration with Teams.

• Please try again after opening the project and ensuring that you have the necessary access to the required project in Project.microsoft.com.  

I am unable to open the project and encountering an "Access restricted" error message when accessing the tab.

• If you are, please make sure that you have the appropriate permissions to access the project. This error typically indicates that your current level of permissions does not allow you to access the project. To resolve this issue, I recommend reaching out to the project administrator or the individual responsible for managing permissions. They will be able to review your access rights and adjust them accordingly to ensure you can access the project successfully.