Direct decorations

Usually, it's faster and easier to decorate elements, connections, and loops according to the data in their fields—for example, creating a decoration rule that selects all elements with the element type "Organization", and color-codes them based on their tags.

But, if you haven't added field data, or you just want to tweak the style of one single item on the map, direct decorations is the perfect tool.

To use them, simply hover over an element, connection, or loop, and the direct decorations toolbar will appear:

If you'd rather have the toolbar appear when you click on an item instead of hover, add the following in the Advanced Editor:

@controls {
  toolbar: click;
}

If the toolbar is a distraction and you prefer to use rule-based decorations, you can disable the toolbar altogether:

@controls {
  toolbar: false;
}

Direct decorations reference

The table below lists all of the icons you'll find in the direct decorations toolbar for elements, connections, and loops, and what action each icon exposes to you.

Undo direct decorations

You can undo your direct decorations for either one, or all, of the entities on your map.

To view what has been decorated with the toolbar, click on the Settings button on the right-hand side of your map and hover over the blue text "Disable direct decorations". You'll then see what elements/connections have been affected by direct decorations.

If you wish to undo all of the direct decorations, you can click on "Disable direct decorations" to return your map to the way it was before. Similarly, if you want to enable direct decorations again, click on the same blue text that is now "Enable direct decorations".

Another option is to disable direct decorations for one or a few single items on your map. To do so:

Note that you can here also choose for a "hard reset", which resets the direct decorations of your entire map.

Similarly, if you wish to undo the direct decorations of only a few selected items, select those items first, and then follow the steps above.

Caveats for direct decorations

There are just a few additional things you should know about direct decorations:

Direct decorations can't be used when importing from Google Sheets

If you're data is coming in from a Google Sheet, you'll notice that the direct decorations toolbar doesn't show up. If you'd still like to use direct decorations, please switch to importing your data with Excel.

Direct decorations always override decorations in your Views.

This includes all the code in your Advanced Editor. For example, if you direct decorate an element to color it blue, and then you use the view to color it red, it will still be blue.

Direct decorations, just like element position and connection curvature, are stored separately for each map in the project.

If you want to change the direct decoration for an item, you can duplicate the map and make your changes in the new copy.

When you're editing the map, the direct decorations toolbar will hide popovers.

However, anyone who has view-only access to the map or is viewing a presentation or a shared/embedded map will still see your popovers (the direct decorations toolbar is hidden for them, since they can't make edits to your map).

If you're building popovers and just want to see how they look before you publish, you can either follow the instructions above to turn off the direct decorations toolbar, or click the ellipsis icon in the bottom right corner and select "Switch to preview mode".