Draw.io Diagrams by Miro

Available for: Free, Starter, Business, Education, and Enterprise plans

With the Miro-built Draw.io app, you can create and collaborate on various types of diagrams, uniting cross-functional teams, projects, and technical documents in a single workspace. It's ideal for crafting technical diagrams such as UML and ERD, designing server racks, and visualizing network and cloud architectures.

Miro UI updates in phased rollout
Miro is enhancing the board user interface to be more inclusive and intuitive, and introducing an evolution of Projects called Spaces. Miro is now rolling out these updates over several weeks.

 

This article describes updated entry-points. To see an overview of all updates, see Miro's new simplified user interface. 

Streamline your diagramming process with advanced features:

• Access over 50 shape packs including ArchiMate’s enterprise architecture, electrical circuits, and floor plans, and search for shapes in open-source icon libraries. 
• Import diagrams from draw.io, Visio, and Lucidchart.
• Enjoy advanced features like layers, tags, smart containers, auto-layout, and shape metadata.
• Format text with HTML and use mathematics typesetting in labels.
• Generate diagrams text using PlantUML, Mermaid code, CSV spreadsheet data and formatting information, or SQL code.
• Generate diagrams from text descriptions using draw.io smart templates.

✏️ Enterprise Admins can add the Draw.io Diagrams app to their approved app list from their app settings.

How to use draw.io

1. Navigate to the creation toolbar on the left side of your board.
2. Click the Tools, Media and Integrations (+) icon and search for ‘Draw.io Diagrams’.
3. Launch the Draw.io Diagrams app.

Launching the Draw.io Diagrams app from the creation toolbar

Pinning draw.io to the toolbar

For easy access, you can pin the Draw.io Diagrams app to your creation toolbar. After searching for the app in the toolbar:

1. Hover over the app in the search results.
2. Click the Pin to toolbar icon.

Pinning the Draw.io Diagrams app to the toolbar

Creating a diagram

With Draw.io Diagrams, you can either create a new diagram or choose a template.  

💡 You can add your existing draw.io diagrams to a Miro board. Learn how to import Draw.io diagrams.  

Create a new diagram 

✏️ Use Draw.io’s rulers, customizable grid, and positioning guidelines to help you diagram faster.

1. Launch the Draw.io Diagrams app.
2. You'll be presented with a blank canvas to start your diagram. You can also drag and drop draw.io files onto the draw.io canvas.
3. On the left sidebar, you'll see various shape categories.
4. Click and drag shapes (e.g. a rectangle or oval) from the sidebar onto the canvas.
5. Continue adding shapes and connectors as needed to complete your diagram. You can also add other elements like text boxes, images, and more from the left sidebar.
6. Once done, click Save and close in the top-right corner of the Draw.io Diagrams app.

Creating a new diagram using the Draw.io Diagrams app

Choose a template 

1. Launch the Draw.io Diagrams app.
2. In the top toolbar, click the Insert icon (+).
3. Click Template.
4. Select a template.
5. Edit the template as needed.
6. Once done, click Save and close in the top-right corner.

Choosing a template from the Draw.io Diagrams app

Modifying your diagram

Connect shapes

1. Hover over a shape.
2. Small connection points will appear.
3. Click and drag from one of these connection points to another shape to create a connector line.
4. Click on a connector line to customize it. In the right-side panel, you can change the connector's style (straight, curved, etc.), add arrowheads or other endpoints, and adjust the line's color and thickness.

Connecting shapes in the Draw.io Diagrams app

Add labels to shapes and connectors

1. Double click on the shape or connector and start typing.
2. Format the label, from the text menu on the right side of the canvas. You can change the font styling, color, direction, and height.

Adding labels to shapes in the Draw.io Diagrams app

Move, resize and delete objects

1. To move a shape or connector, click and drag it to the desired location.
2. To resize a shape, click on it and drag any of the small blue circles.
3. To delete an object, select it and press the Delete key on your keyboard or click the Delete icon in the top toolbar.

Moving, resizing and deleting an object in the Draw.io Diagrams app

Edit shape metadata

Add important details to your shapes to make them more informative.

1. Launch the Draw.io Diagrams app.
2. Select a shape in your diagram.
3. Right-click the shape and select Edit Data.
4. A dialog will open with the shape metadata. Property names are on the left, and their values on the right.
5. Add key-value pairs for the information you wish to associate with the shape.
6. Click Apply to save the metadata to your shape.
7. Hover over the shape to view its metadata.

Editing shape metadata

Add layers to your diagram

Elevate the organization and clarity of your diagrams. Layers allow you to separate different parts of your diagram for focused editing or viewing, perfect for complex projects.

1. Open your diagram in the Draw.io Diagrams app.
2. Click View, and select Layers to display the Layers dialog.
3. To add a new layer, click the plus (+) icon at the bottom of the Layers dialog.
4. To edit the layer name, double click on the layer, edit the text, and click Rename.
5. Select the layer to make it active for adding or editing elements.
6. To hide or show a layer, click the eye icon next to the layer name.
7. Click Save and close when you're done editing your diagram.

Adding layers in the Draw.io Diagrams app

Utilize a wide range of draw.io shape packs

Broaden your diagramming possibilities with draw.io's selection of shape packs, offering specialized shapes for every diagramming need.

1. Launch the Draw.io Diagrams app.
2. Click More Shapes at the bottom of the Shapes panel on the left side.
3. Explore the categories and check the boxes next to the shape packs you wish to add.
4. Click Apply to add the selected shape packs to your Shapes panel.

Selecting a draw.io shape pack

Add custom shapes with the scratchpad

Tailor your diagramming experience with custom shapes and stencils. Create and integrate personalized shape libraries to fit your project's unique needs.

1. Launch the Draw.io Diagrams app.
2. Navigate to View. 
3. Select Scratchpad.
4. The scratchpad will open in the left-hand panel. 
5. Add custom shapes by dragging and dropping the files over the scratchpad.

Add custom shapes with scratchpad

Edit custom shapes in the scratchpad

1. On the canvas, click on a shape.
2. Click and drag the blue dots to resize the shape. 
3. Use the right-side panel to further customize the shape, including the shape color, text, and size.
4. When you’re done, click on the shape, and then click the plus icon in the scratchpad.
5. The shape will be added to your custom shapes. 

Modifying custom shapes with scratchpad

Delete and rename custom shapes in the scratchpad

1. Within the scratchpad, click the pencil icon.
2. To delete a shape from the scratchpad, click the x in the top-right corner of the shape.
3. Click on the text field underneath a shape to enter a name. By default, shapes added to the scratchpad are untitled.
4. Click Save when you are done editing.

Delete and rename custom shapes with scratchpad

Export custom shapes as a shape library

1. Within the scratchpad, click the pencil icon.
2. Click Export to save your custom shapes as a library.
3. Enter a filename for your custom shape library and select the location where you want to save the file.
4. Click Save.

Export custom shapes as a library

Import and export Visio diagrams

Seamlessly transition between diagramming tools, ensuring you can work with your diagrams across different platforms without losing any detail.

1. Launch the Draw.io Diagrams app.
2. To import, click File in the top-left corner, hover over Import From, and select Device. You can also upload your Visio (VSDX) file using one of the cloud services in the menu.
3. Choose the Visio (VSDX) file from your device and click Open to import.
4. To export, after completing your diagram, click File, hover over Export as, and select Visio (VSDX).
5. Follow the prompts to complete the export process.

Importing and exporting diagrams in the Draw.io Diagrams app

Save your draw.io diagram

1. When you’ve finished making changes to your diagram, always remember to click Save and close in the top-right corner of the Draw.io Diagrams app.
2. The Draw.io Diagrams app will close, and your diagram will automatically appear on your Miro board.

Saving a diagram from the Draw.io Diagrams app

Edit your draw.io diagram

1. On your Miro board, select the diagram you want to edit.
2. A toolbar will appear.
3. In the toolbar, click the Edit pencil icon.
4. The Draw.io Diagrams app will open and you can make changes to the diagram.

Editing a diagram in the Draw.io Diagrams app

Export your draw.io diagram

You can export your diagram in several formats including PNG, JPEG, and PDF. 

1. Click File in the top-left corner of the draw.io diagrams app.
2. Hover over Export as.
3. Choose your desired format and follow the prompts.
4. Click Export.

Exporting a diagram from the Draw.io Diagrams app

When to use Draw.io Diagrams

Use Draw.io Diagrams when your projects require more specialized requirements:

• Niche shape libraries: Access niche shapes, whether for intricate electrical engineering diagrams or the specific layout of floor plans.
• Customization: Create your own shape packs with Visio (VSSX files) or directly within draw.io to tailor your diagrams exactly to your needs.
• Seamless integration: draw.io ensures smooth compatibility with major diagramming tools like Visio, Lucidchart, and more. Share and collaborate effortlessly, using Visio (VSDX) as the universal format.
• Preserve important details: Retain crucial layer and shape metadata (the text within your diagrams) to keep rich information intact when migrating from Visio, draw.io, or Lucidchart. 

✏️ This Third Party Platform app utilizes open source Draw.io code from the Github repository, and is hosted securely by Miro, no data is shared with third parties. Draw.io is closed to contributions. Therefore this Third Party Platform app is provided "as-is" with all bugs and errors, and is offered without any warranty, indemnity, security commitments, or support of any kind from Miro or Draw.io.

Frequently asked questions