Skip to main content

Using layers in draw.io

Layers add structure and organisation to your diagrams. When you interact with a complex diagram to display or hide its various layers, you can understand the diagram more easily.

Each shape (or group) can only be placed on one layer - it can't belong to multiple layers. Learn more about how layers work in draw.io.

Connectors can connect source and target shapes on different layers.

Tip: Open an example gitflow with layers in the draw.io editor - use the linked documentation below to learn how to work with these layers in a diagram.

Open the Layers dialog​

Select View > Layers or press Ctrl+Shift+L / Cmd+Shift+L to display or hide the Layers dialog.

Select View /> Layers to open the Layers dialog

By default, a new diagram has a single Background layer, to which all shapes, connectors and text are added.

From the Layers dialog, you can:

Tip: Make sure you select the layer you want to add shapes to in the layers dialog first, before you add shapes and connectors.

How do layers work?​

Shapes are arranged in the order you added them to the drawing canvas, within the layer you added them. Shapes and connectors placed on a higher layer can not go behind shapes on a lower layer - they can only be arranged from front to back within their layer.

Learn more about how layers work in draw.io.

With layers and custom links you can add interactivity - click on a shape with a custom link your diagram to hide or display layers.
Paste the custom link into the first text field and click Apply

Diagrams that work well with layers​