Legends
Last updated
Was this helpful?
Last updated
Was this helpful?
Adding a legend to your map is an important step to make sure your readers can easily understand your decorations. There are a number of different ways to add and remove legend entries—this guide will explain all of them!
Note that you can only create a legend through . If you're using (the toolbar) to color, then you won't have a legend.
Skip to section:
There are two ways to create your legend from the :
Using the Color by, or Shape by options
Using the (Decorate Elements & Decorate Connections)
Color by is a great way to get a legend up and running quickly, while the decoration builders are useful when your legend needs to be a bit more customized. Read on to learn more about both options.
Only color by the values being used
In some projects, you might have a long list of field values, but only use some of them on a given map. If that is the case, your Color by legend will include all of the possible field values, not just the values being used on your map.
Add a new field—this new field can have any name, but something like "Color coding field" might be clear and easy to remember.
Scroll down to the fields "Advanced settings" section.
In the Expression box, paste in {{Field Name}}, replacing Field Name with the name of the field you originally wanted to color by. For example, if you want to color by the element type field, paste in {{element type}}.
Click "Save" to save the field
With that done, you can return to the map, and use the Color by tool to color by your new computed field. Regardless of how many possible values you have in the original field, the legend will now only include the values being used on the current map.
You can use the decoration builders to add many different kinds of items to your legend—for example, icons to indicate that elements or connections are being scaled in size:
For all other fields (including Element Type, Connection Type, and Loop Type), follow these steps:
Click the menu in the upper left of your map and choose FIELDS
Click on the field you want to edit
Find the value you want to delete. Then, click the delete button next to the value to delete it.
Scroll down and click SAVE to save your changes
Refresh the page
After you follow these steps, the field value(s) you deleted will no longer show up in prompted lists, in legends, or in controls.
If you used the decoration builder to add a legend entry, you can go to the existing decorations section, click the pencil icon next to the decoration, and clear out the Label for Legend box. This will remove the legend item, but keep the decoration—if you'd rather delete both, you can click the delete icon in the existing decorations section.
There are two ways to re-order legend entries, depending on how they were added. If you added legend entries using the Color by tool, follow these steps to change the order:
Select Fields from the sidebar on the left
Select the same field you selected in the Color by tool—it's settings panel will open up
Drag and drop field values to change their order
Click Save at the bottom of the field settings to save your changes, then reload the page
If you added legend entries using the decoration builder return to the Advanced Editor and locate the codes generated by Kumu for your custom decorations, cut and past the codes to re-arrange the legend entries the way you want them to appear on your map.
Replace entry-type with either elements or connections to tell Kumu what your decoration rule applies to. Replace Entry Label with the text that will appear in the legend. Your decoration rule should start on the next line down in the Advanced Editor.
Here's a working example from a decoration in one of the screenshots above:
Note that you can combine multiple decoration rules into one block of code, and Kumu's legend will combine many of your rules into one legend icon. The code above will create the following entry in the legend, complete with color, border color, and scale:
If you'd like to change the title of your legend from "Legend" to something more descriptive, you can use the following code:
This is what it'll look like:
If you want to completely hide the legend, you can use the Advanced Editor to do so. Here's some sample code to get you started:
Below is a list of all the icons you can add to your legend, as well as instructions on how to access the icons from the Basic and Advanced Editors.
None
Decorate elements > Change color > Set a fixed element color
Decorate elements > Add shadow > color
Decorate elements > Add bullseye > color
Decorate connections > Change size > Scale connection widths by field
Decorate connections > Change color > Set a fixed connection color
Decorate connections > Change style > dashed
None
Decorate elements > Change color > Set a fixed element color
Decorate elements > Add shadow > color
Decorate elements > Add bullseye > color
Decorate connections > Change size > Scale connection widths by field
Decorate connections > Change color > Set a fixed connection color
Decorate connections > Change style > dashed
When you use the tool in the Basic Editor, Kumu will automatically create your color legend, adding an item for each possible value in the field you're coloring by. For example, this map is colored by Element Type using the bujumbra scale:
This automatic legend feature also works when you're using Color by to add .
Note that the Color by tool will stop adding legend entries after it runs out of colors in its default color palette (seven colors). To make sure all your field values get included in the legend, you might need to click the expand icon and choose a . If the Color by tool is including some unwanted field values in your legend, try .
One more caveat about Color by: when you're using this tool, it's not possible to remove, replace, or edit individual colors from the color palette. To fully customize the colors in the palette, you can follow the guide to . Alternatively, you can read through to learn how to create a custom legend without using the Color by tool.
Using Kumu's feature, you can quickly solve this problem and create a legend with only the used values:
Open your and click "Fields"
For bonus points, use to hide your computed field from all profiles.
To add custom colors and icons to your legend, use the . Once you build out your decoration rule, fill in the "Label for Legend" box at the bottom of the decoration builder, and Kumu will add your decoration to the legend.
For a full list of legend icons you can add, .
The legend entries added from the decoration builder will be listed in the Basic Editor among other . If you hover over a custom decoration, you can click the pencil icon next to it to edit that entry, or you can click the trash can to delete that decoration.
Legend entries added using the Color by tool can only be removed by or that you don't want to see. To do this, you need to delete the underlying field value. This process is different depending on the field's .
For fields that have their prompt set to "Autocomplete" or "None" (this includes the Tags field), you can only delete the field value by removing it from every element, connection, and loop in the project, including the .
Some legend entries get added automatically when you apply different . Here's how to delete those entries:
For Person and Organization entries (stakeholder template), and Stock, Flow, Variable, Source, and Sink entries (stock and flow template), follow the guide to . Delete these values from the Element Type field.
For Adds to / same direction and Subtracts from / opposite direction entries (causal loop template), follow the guide to . Delete these values from the Connection Type field.
Opposite entry (system template): Open your , and, in the Template settings section, clear out the "Opposite connection label" box and click SAVE at the bottom.
Click the menu icon to bring up the
If you're working on decorations in the , you can add a comment above a decoration to tell Kumu that it should be included in the legend. The syntax is:
For a full list of legend icons and how to use them from the Advanced Editor, .
For more info on why and how this works, check out .
