Automatically number shapes as you insert them

Important: The Enumerate shape property allows you to add a numbered label to selected shapes and connectors. It can not be applied by default to any new shape added to the drawing canvas.

The Enumerate shape property, however, gives you control over what parts of your diagram are numbered, and can be customised to work on shapes and connectors inside container shapes or table cells, unlike the number plugin.

Learn how to use the Enumerate shape property

Use the number plugin instead

This plugin should be used as-is, as an unsupported example for developers.

Add automatic numbering to the shapes in your diagram with the number plugin. It will number each shape as they are added to your diagram.

You can change the order by bring shapes to forwards or backwards in the Arrange tab of the format pannel - the numbering is based on their z-order (depth) in the diagram.

Note: This does not work on container shapes and table shapes because they are compound shapes - the number plugin will number each part. Use the Enumerate shape property instead.

The number plugin automatically includes numbers on shapes as you add them to your diagram

Open this diagram in the viewer

More information about draw.io plugins

Load the number plugin

Permanently load the number plugin

If you want to always use the number plugin, add it to the plugins list so it will be loaded each time you create or edit a diagram.

  1. From the menu, select Extras > Plugins.
    Open the plugins list
  2. Click Add.
    Add a new plugin
  3. Select number in the drop-down list of built-in plugins, then click OK.
    Add the number plugin
  4. Click Apply.
    Add the number plugin

Reload your browser tab to load the plugin into the diagram editor.

Show or hide the numbering in your diagram

Click View > Number to show or hide the numbering in your diagram.

Share a diagram using the properties plugin

By default, diagrams published to URLs do not load plugins.

To allow someone to see your diagram with its numbers on shapes, when you publish a diagram to a URL (File > Publish Link), add the &p=number URL parameter to the link before you share it (as highlighted in blue in the screenshot below).

Share a link to your diagram and enable the number plugin

Note: Plugins work with the web version of draw.io (app.diagrams.net) or our Docker image if you want to run your own server. They do not work with draw.io for Confluence/Jira or with draw.io Desktop.