Draw freehand shapes and annotate diagrams

draw.io 01 Jun 2021


When you draw a freehand shape in draw.io, it is saved as an image with a transparent background on the drawing canvas by default. You can change the freehand-drawn shape’s style like you would many other shapes: line colour, fill colour, opacity and more. You can also resize, flip and rotate your freehand drawing.

Add a new freehand drawing

  1. Open the Freehand panel. You can move this panel so it doesn’t obstruct where you want to draw.
  2. Click and hold to draw a freehand line on the drawing canvas.
    Click on Start drawing then click and draw on the drawing canvas to add a freehand shape

Use the freehand brush

The freehand brush can draw different line widths. Click the Brush checkbox and move the slider to the width you want to use.
Use the freehand drawing tool in a draw.io Board diagram to markup diagrams or draw shapes with your mouse

Stop drawing

Stop drawing in one of the following ways.

  • Press Esc.
  • Click on Stop drawing in the Freehand floating panel.
  • Close the Freehand panel.
  • Click on the drawing canvas without moving the mouse.
  • Style the freehand shape you just drew in the format panel on the right.
  • Add a new shape from the shape libraries.
  • In the Sketch editor theme, click again on Freehand in the toolbar on the left.
    Use the freehand drawing tool in a draw.io Board diagram to markup diagrams or draw shapes with your mouse

To draw another freehand shape after you have previously stopped drawing, click on Start Drawing in the floating Freehand dialog.

Tip: Freehand drawing also works on mobile devices, using your finger or a smart pen to tap and draw instead of the mouse.

Add a label to your freehand shape

  1. Double-click on the freehand shape you have finished drawing.
  2. Enter the label text, and style it using the Text tab in the format panel.
    Double click on the freehand shape and enter your label text, then style it in the format panel

Tip: If you want to use multiple text formats inside your label, make sure the Formatted Text checkbox is selected.

Style your freehand shape

Select the shape and use the Style tab of the format panel to style your freehand shape.

  • Change the colour using the style palette or add a custom Fill and Line colour.
  • Change the style by selecting a different one from the Line drop-down list, width of the line by change the number next to the line style.
  • Change the Opacity, add a Shadow, or use the Sketch style.
  • Expand the Properties at the bottom of the Style tab of the format panel to change many more style settings on your freehand shape.
    Use the Style tab in the format panel to change the style of your freehand shape

Resize, rotate and reposition a freehand shape

You can change the size, rotation angle and position of a freehand shape, just like you would any other shape.

  • Resize: Drag the round grab handles of a selected freehand shape to resize it, or edit the Width and Height values in the Arrange tab of the format panel. If you want the freehand shape to be resized proportionally, make sure Constrain Proportions is selected in the Arrange tab.
  • Rotate: Drag the circular arrow in the top right of a selected freehand shape, or enter a new Angle in the Arrange tab of the format panel. Alternatively, Flip the shape horizontally or vertically via the Arrange tab.
  • Reposition: Drag the freehand shape to a new position on the drawing canvas, or enter a new Position in the Arrange tab of the format panel. Bring it to the front or send it to the back by clicking To Front or To Back in the Arrange tab.
    Use the Arrange tab in the format panel to resize, rotate, and reposition the freehand shape

Use connectors with freehand shapes

  1. Drag the end of a connector to a freehand shape to connect them like you would any other shape.
  2. Drop the connector when you see a blue highlight for a floating connector, or when the highlight is green for a fixed connector.
    Drag and drop connectors onto freehand shapes

Follow us on GitHub, Twitter, Facebook.