The first part of our training course covers the basics of using draw.io in Confluence (Cloud, Server, or Data Center): adding a diagram to page and editing existing diagrams.

Of course, you will need to know how to add blank and template diagrams to a Confluence page and change how it is displayed when someone views your page.

Task 1: Insert a diagram

A. Insert a blank diagram

For Confluence Cloud

  1. To insert the draw.io macro when editing a Confluence page, type /draw, and select draw.io diagram.
  2. In the template manager, go to Basic in the left column (if another diagram type was selected).
  3. Enter a name for the diagram.
  4. Click on Blank Diagram and select Create (or double-click on Blank Diagram).
  5. Click Save & Exit.
  6. Save the Confluence page.

For Confluence Server/Data Center

    1. To insert the draw.io macro when editing a Confluence page, type {draw and select Drawio (or select “+” from the toolbar and click draw.io Diagram).
    2. In the template manager, go to draw.io Diagram at the top left (if another diagram type was selected).
    3. Click on Blank and select Create (or double-click on Blank Diagram).
    4. Click Save & Exit.
    5. Enter a name for the diagram.
    6. Save the Confluence page.

B. Insert an existing diagram

If you’ve already created draw.io diagrams, you can always use these existing files to adapt them after copying them.

For Confluence Cloud

  1. Type /draw and select the macro Embed draw.io diagram to look for an existing diagram to embed
  2. Now you will see a screen where you can either:
    • Choose from one of the recent diagrams
    • Search for existing content
    • Embed existing diagrams from Google Drive or OneDrive
    • Upload files or embed a diagram from a URL
    • Click on the diagram of your choice and click Select.

For Confluence Server/Data Center

  1. Insert the macro as in the previous step.
  2. In the template manager, go to draw.io Diagram at the top left (if another diagram type was selected).
  3. Beneath the option Blank, there is a section of Recent diagrams. Select one of the recent diagrams or (if the diagram you are looking for wasn’t create recently), click on the option Search in the left toolbar, and type in your search terms for the specific diagram.
  4. Click on the diagram. You will now see the following options: Link to Diagram and Copy.
  5. The option Copy will copy the template which you can then use to adapt it for a new diagram.
  6. The option Link to diagram will create a diagram, which will always be synced with the parent file.  When you want to edit it will then take you to the parent diagram.

Add a draw.io blank diagram to a Confluence page


Task 2: Open and save a template diagram

If you want to create a diagram for a specific use case quickly, you can choose from a variety of predefined templates from our template libraries. draw.io includes many templates by default.  This includes diagrams like flowcharts, mind maps, and more. You can find these in the various categories listed to the left of  your workspace. Generating a clone of these templates is very easy:

For Confluence Cloud

  1. Insert the draw.io macro when editing a Confluence page.
  2. Enter a name for the diagram.
  3. Select a template from the template manager in the left toolbar and click “Create” (in Cloud) or “Copy” (in Server/Data Center) to open it (double-clicking is also fine.
  4. Click Save & Exit.
  5. Save the Confluence page.

For Confluence Server/Data Center

  1. Insert the draw.io macro when editing a Confluence page.
  2. Select a template from the template manager in the left toolbar and click Create (in Cloud) or Copy (in Server/Data Center) to open it (double-clicking works too).
  3. Click Save & Exit.
  4. Enter a name for the diagram.
  5. Save the Confluence page.

Please Note: Once you have given the diagram a name, you can’t change it.

draw.io - open diagram


Task 3: Change how the diagram appears on the Confluence page

You can change the display of the diagram when editing the Confluence page.

For Confluence Server/Data Center

You can customize the appearance quite extensively: from sizing to borders, and much more. When you click on a diagram in edit mode, a toolbar is displayed either above or below the diagram.

  1. Edit the page and select the draw.io diagram.
  2. Click on Edit Macro and change the settings as follows: Width 600, Border inactive, Toolbar Embedded.

Tip: When viewing the Confluence page, you can change the zoom level as required.

You can use this toolbar to:

  • Change how the diagram is displayed within the Confluence page (border, toolbar, etc.)
  • Duplicate the diagram.
  • Change the displayed size within the page (in the same way as images in Confluence).
  • Remove the diagram.

For Confluence Cloud

In Confluence Cloud, the macro handling is unfortunately limited, so we don’t have that many options to change the appearance of a draw.io diagram. In the editing mode of a page, hover over der macro to make the toolbar appear at the bottom of the diagram. From here, you can edit the diagram, change sizes, or remove the diagram from the page.

draw.io: resize a diagram on a Confluence page

That’s it for the first exercise in this self-directed training course. Keep an eye out for the next installment in this series where you will learn how to work with text and connectors, create a tree diagram from scratch and work with the symbol library.