Display or hide diagram elements using the tags plugin

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

The tags plugin allows you to display and hide elements of your diagram based on metadata, or tags. This can be useful for exploring complex diagrams, for example to indicate which code segments run on which system, or which department is responsible for which steps in a flow chart.

Learn more about plugins

Load the tags plugin

There are a number of ways to add tags to shapes. You can add the tags property to the shape metadata manually, but it may be easier to use the Hidden Tags dialog.

  1. Click Extras > Hidden Tags. Select a shape or multiple shapes.
  2. If you want to apply an existing tag, click on the existing tag name.
  3. To add a new tag, type its name into the text field, and press Enter.
    Add a tag via the Hidden Tags dialog

Remove a tag from a shape

You can edit the shape’s data and delete the tag name from the tags property manually, or you can use the Hidden Tags dialog to remove it.

  1. Click Extras > Hidden Tags.
  2. Select a shape or multiple shapes, and click on one of the blue tag names in the dialog. This removes the tag from the shape. For example, to remove the manage tag from the orange shapes, first select them, click on manage in the dialog.
    Remove a tag via the Hidden Tags dialog

Permanently load the tags plugin

If you want to use tags in your diagrams regularly, add the tags plugin to the plugins list to load it 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 tags in the drop-down list of built-in plugins, then click OK.
    Add the tags plugin
  4. Click Apply.
    Add the tags plugin

Note: Plugins are not supported in draw.io for Confluence.