Use diagrams.net in Microsoft Teams

With the diagrams.net app for Microsoft Teams, you and your team can collaborate in real time on diagrams directly from your team’s channel in a Teams tab.

Secure and private: Your diagrams are securely stored in your linked Microsoft OneDrive or Google Drive account, and in your browser or the Teams app while you are working on them.

Fully-featured diagramming app: With diagrams.net in Teams, your team has an easy-to-use diagramming application for quick online whiteboard sketches through to complex diagrams: BPMN diagrams, flowcharts, mindmaps, org charts, UML diagrams, infographics, network diagrams, mockups, rack diagrams, and many more types of diagrams.

Install the diagrams.net app in your channel

  1. Click on Apps at the bottom of the left navigation panel in Microsoft Teams.
  2. Search for diagrams.net, then select the app to see the app listing details.
  3. Click Add to add it to your current team’s channel. Click the down arrow next to Add and select Add to a team to add it to a different team channel.

Add a new diagram to your channel

  1. Click Add a tab at the top of your team’s channel.
    diagrams.net in Teams: Add a new tab to add a diagram to your team's channel
  2. Search for and select diagrams.net.
    diagrams.net in Teams: Search for diagrams.net and click on the logo to add a diagram tab
  3. Enter a Diagram Name in the text field. This will be used as the name of the tab in your Teams channel. Click on the location where you want to save your file: Sharepoint, OneDrive or Google Drive.
    diagrams.net in Teams: Enter the name of your new diagram and then click where you want to save the diagram file
  4. Choose whether you want your diagram to be Editable and a Post to the channel about this tab published, then click Save.
    diagrams.net in Teams: Choose whether you want the new diagram to be editable by others and whether it should be announced to the team, then click Save

The new tab will be added, and the diagrams.net editor will load with a new blank diagram.

Add an existing diagram to your channel

  1. Click Add a tab at the top of your team’s channel, search for and select diagrams.net.
  2. Using the buttons next to Open Diagram, click on the location where you have stored your diagram file.
    diagrams.net in Teams: Select the location where your diagrams.net file has been saved to add it to a new tab in Teams
  3. Browse to its folder and select the diagram file, then click Open.
    diagrams.net in Teams: Browse to the diagram file, select it, then click Open
  4. Choose whether you want your diagram to be Editable and a Post to the channel about this tab published, then click Save.

The new tab will be added, and the diagrams.net editor will load your existing diagram.

Introduction to the diagrams.net editor

The diagrams.net editor in Teams uses the minimal Sketch editor theme by default so it feels like an easy-to-use whiteboard.

  • A toolbar on the left contains the most common shapes and connectors.
  • Another toolbar on the bottom right allows you to move around the canvas.
  • Click the diagrams.net logo for the menu. The notification bell in the top right indicates when your diagram has auto-saved.

Further diagramming tools and options are located in floating panels, that are minimised or hidden by default. You can move these around the canvas to maximise your diagramming space.

Getting started with diagrams.net in Teams

diagrams.net in Teams: A basic visual tutorial

Drag or click on a shape, sticky note, text, or connector in the left toolbar to add it to the canvas.

Alternatively, double click on a blank area on the canvas and select from a list of common shapes.

When you add a shape to the canvas, start typing to add a text label.
Add shapes from the toolbar or double click on the online whiteboard canvas and select a shape

Click on a shape on the canvas to select it. You’ll see blue dots around the shape, a blue arrow in the top right, and when you hover over the shape, four blue direction arrows.

  • Click on one of the four blue direction arrows to add and connect a shape in that direction.
  • Alternatively, drag a connector from one of the four direction arrows and drop it on another shape to connect them.
    Learn more about connectors

Drag connectors between shapes or add them from the toolbar in the diagrams.net online whiteboard

Drag one of the blue dots to resize the selected shape, just as you would resize an image in a document.

Drag the arrow in the top right to rotate the selected shape.
Drag shapes to move them in your online whiteboard at sketch.diagrams.net or drag the grab handles to rotate or resize shapes

Click on the three tools at the bottom of the toolbar on the left.

If you feel a bit lost, hover over any part of the diagrams.net app to see a tooltip.

Hold the right mouse button and drag to move the diagram canvas around.

  • Alternatively, click on the Outline tool in the bottom right to open a panel with an overview of the entire canvas. Drag the blue area in the Outline panel to move to another location on the canvas quickly.

Use the mouse wheel or click on the Zoom tools in the bottom right to zoom in or out. Click on the number to return to 100%.

Select a shape or connector and click on the Format floating panel title. Depending on what you have selected, different options will be available.

  • Style tab: Change the outline and fill colours and shape styles. If you selected a connector, you can change the arrow ends and line style.
  • Text tab: Change the font, text colours and size.
  • Arrange tab: Set a specific angle for the rotation, or values for the shape size. Bring overlapping shapes forward or backwards on the canvas.
    Learn more about shape styles

Format shapes, connectors and text with the floating Format panel in the sketch.diagrams.net online whiteboard

Click on the diagrams.net logo in the top left to export and print your diagram and set various preferences for the editor.

Tip: you can right-click on the canvas or on a shape or connector to open a context menu that lets you select and manipute shapes and connectors, add links and metadata to shapes and connectors, and set various options.

Import a diagram file to Teams

You can drag and drop diagram files into the diagrams.net editor in teams to import them. This works for diagrams.net files, as well as diagrams in other formats.

If your team members are new to diagramming, import the following visual diagram.net tutorial into your Teams channel to help your team members get started quickly.

diagrams.net in Teams: A basic visual tutorial

Right-click to download this tutorial diagram from our Github repository

Import a diagram: Add a new diagram tab as described above, and simply drag the diagram file from your device onto the canvas to import it.

  • Alternatively, click on the diagrams.net logo to open the menu, select Import from, then select the location or format you want to import.
  • Add images to the canvas in a similar way - drag and drop, or import them via the menu.

Zoom out and drag the canvas (right mouse button) to position the tutorial so that it lines up with the diagrams.net editor in your Teams browser window. diagrams.net in Teams: Drag and drop a diagram file into a diagram tab in Teams to import it

Rename a diagram tab in Teams

  1. Click on the down arrow next to the diagram tab’s title, and select Rename.
    diagrams.net in Teams: Rename a diagram tab in Teams
  2. Enter a new name for your tab and diagram and click Save.
    diagrams.net in Teams: Rename a diagram tab in Teams

Remove a diagram tab from Teams

  1. Click on the down arrow next to the diagram tab’s title, and select Remove.
    diagrams.net in Teams: Remove a diagram tab in Teams - this does not delete the diagram file in your cloud storage
  2. Confirm you want to remove the diagram tab.
    diagrams.net in Teams: Remove a diagram tab in Teams - this does not delete the diagram file in your cloud storage

Note: This does not remove your diagram file from your Cloud storage location - it only removes the diagram tab. To add it again, follow the steps to open an existing diagram in a Teams tab at the start of this tutorial.

Add a diagram to a conversation in Teams

  1. Click on Start Conversation, then click on the diagrams.net icon.
    diagrams.net in Teams: Click on the diagrams.net logo underneath the text field to add a diagram to the conversation
  2. Select your diagram or add a new diagram following the same steps as for adding a diagram tab above.
  3. Send your message to the conversation channel. A thumbnail preview of the first page of your diagram will be displayed in the message, but a new diagram tab will not be added to your team’s channel.
    diagrams.net in Teams: A diagram added to chat will display the first diagram page as a thumbnail
  4. Click on Edit to open the diagram file in the diagrams.net editor.
  5. Click on View to see a larger view of the diagram - you can step through pages, click on embedded links in the diagram and hide or display layers using the toolbar that appears when you hover over the diagram.
    • Zoom in and out with the magnifying glass tools in the toolbar.
    • Click and drag with the left or middle mouse button to move the canvas around.
      diagrams.net in Teams: Use the toolbar at the bottom of the viewer to zoom in

Note: If you don’t see the diagrams.net icon underneath the conversation entry field, click on the three dots ..., then search for diagrams.net in the list of apps. Click on diagrams.net and follow the remaining steps above to add your diagram to the conversation.
diagrams.net in Teams: Rename a diagram tab in Teams

FAQs