Kumu
  • Getting started
    • Welcome
    • Kumu 101
    • First steps
    • Quick tips
    • Webinars
  • Overview
    • Kumu's architecture
    • Accounts and workspaces
    • Kumu.io and Kumu Enterprise
    • Billing
    • User interfaces
      • Dashboard
      • Settings
      • Map editor
      • View editors
      • Quick Actions
    • Collaborating and sharing
    • Actions and permissions
    • Security
    • Advanced Editor hub
      • @settings reference
      • @controls reference
      • Color reference
      • Property reference
      • Selector reference
  • DISCIPLINES
    • SNA / Network Mapping
    • Systems mapping
    • Systems Practice workbook
  • Guides
    • Activity feed
    • Add-ons
      • Disqus
    • Bridge
    • Cluster
    • Controls
      • Cluster control
      • Color-legend control
      • Filter control
      • Focus control
      • Image control
      • Label control
      • Showcase control
      • SNA-dashboard control
      • Tagged-timeline control
      • Text Control
      • Title Control
      • View toggle control
    • Decorations
      • Direct decorations
      • Data-driven decorations
      • Flags
      • Icons
      • Images
      • Label templates
      • Popovers
    • Default view settings
    • Export
    • Fields
      • Computed fields
    • Filter
    • Focus
    • Forking
    • Grids & Guides
    • Import
      • Structure your data for Kumu
      • Excel / CSV
      • Google Sheets
      • JSON / Blueprints
    • Imported views
    • Layouts
      • Fixed
      • Force-directed
      • Remove overlap
      • Scatter
      • Snap-to
    • Legends
    • Licensing
    • Lightbox
    • Loops
    • Metrics
    • Two-factor authentication
    • Pro workspaces
      • Archiving projects
      • Discussions
    • Partial views
    • Presentations
    • Profiles
      • Markdown
    • Project admin
    • Selectors
    • Shapes
    • Share and embed maps
    • Shortcuts
    • Showcase
    • Slugs
    • Table
    • Templates
      • Geo template
    • URLs
    • Views
    • Widgets
  • About Kumu
    • What is Kumu?
    • How does it work?
    • Where can I get help?
  • Enterprise
    • About enterprise
    • Getting started with VMWare
    • Upgrading
    • Configuration
    • Creating user accounts
    • SSH Access
    • Single sign-on
    • Backing up enterprise data
    • Restoring enterprise data
    • Command line utilities
    • Changelog
  • Frequently Asked Questions
    • Does Kumu have a public API?
    • Does Kumu make use of AI?
    • How do I add annotations?
    • How do I add anchors to my map description?
    • How do I add arrows to my connections?
    • How do I add documents to profiles?
    • How do I add more than one element with the same label?
    • How do I add text dropdowns to my map overview?
    • How do I adjust arrow size?
    • How do I avoid duplicating data?
    • How do I change connection curvature?
    • How do I change font color?
    • How do I change font size?
    • How do I change the default for currency fields?
    • How do I change the length or strength of connections?
    • How do I change the order of control options?
    • How do I change the position of my element labels?
    • How do I cite Kumu?
    • How do I collapse duplicate connections?
    • How do I copy a map to another project?
    • How do I control label size while scaling element size?
    • How do I control text wrapping?
    • How do I convert a project from private to public?
    • How do I convert a project from public to private?
    • How do I create dynamic on/off toggles for my map?
    • How do I customize link text in popovers?
    • How do I customize the order of my legend?
    • How do I delete a project, map, or view?
    • How do I delete data from my project?
    • How do I downgrade my subscription?
    • How do I edit virtual elements?
    • How do I get rid of duplicates?
    • How do I hide elements without connections?
    • How do I hide images from the map but keep them in the profile?
    • How do I hide labels on my map?
    • How do I hide the settings button?
    • How do I keep elements from moving?
    • How do I list an element's connections in its profile?
    • How do I make elements transparent?
    • How do I make sense of my receipt?
    • How do I open a sub-system when clicking on an element?
    • How do I remove the Opposite entry from my legend?
    • How do I remove unneeded controls?
    • How do I remove unwanted legend entries?
    • How do I rename my map/view?
    • How do I restructure my adjacency matrix?
    • How do I save my changes in Kumu?
    • How do I select options by default in my control?
    • How do I set a minimum or maximum zoom level for my map?
    • How do I show the Settings button?
    • How do I size elements based on number of connections?
    • How do I transfer a project?
    • How do I update my credit card information?
    • How much data can my Kumu project handle?
    • How do my readers switch between maps and views?
    • My data won't import. What can I do?
    • My Kumu embed is not working. What can I do?
    • My map disappeared. How do I bring it back?
    • My PDF won't export. What can I do?
    • What pricing plans does Kumu have?
    • Where can I find my invoices?
    • Where can I find example Kumu projects?
Powered by GitBook
On this page
  • Assigning shapes manually
  • Assigning shapes to specific selections
  • Categorizing your elements with shapes automatically
  • Assigning shapes from the Advanced Editor
  • More tips for shapes

Was this helpful?

Edit on GitHub
  1. Guides

Shapes

PreviousSelectorsNextShare and embed maps

Last updated 1 month ago

Was this helpful?

Shapes are are a useful visual tool when you need to differentiate between different types of elements. Kumu has several tools you can use to customize elements' shapes—this guide will help you pick which tool is the right one for your use case:

Assigning shapes manually

If you just need to assign shapes to a handful of elements, we recommend using the . Hover over any element, then click the Size/Shape icon , and pick a shape from the dropdown.

Assigning shapes to specific selections

To assign a shape to a specific selection of elements, use the element decoration builder.

  1. Click Decorate elements

  2. Check the Add shape box, and pick a shape

  3. If you'd like to add your shape decoration to the legend, fill in the Legend box

Categorizing your elements with shapes automatically

The quickest way to assign shapes to all elements automatically based on their profile data is the Shape By tool. Open the Basic Editor, and use the Shape By tool to pick a field from your elements' profiles. Note that Shape By only works with fields that can hold one value, like Element Type.

When you use Shape By, legend entries will be created for you automatically.

Assigning shapes from the Advanced Editor

In the Advanced Editor, you can use the shape property to assign shapes. Here's the basic syntax:

element {
  shape: circle;
}
  • circle

  • triangle

  • square

  • rectangle

  • pill

  • diamond

  • pentagon

  • hexagon

  • octagon

Two things to note:

  • When choosing the rectangle or pill shape, you also need to indicate their width and height:

element {
  shape: rectangle; 
  height: 100;
  width: 420;
}
  • To change the size of any shape other than the square, rectangle, or pill, use the size property, instead of width & height:

element {
  shape: triangle; 
  size: 200;
}

More tips for shapes

Instead of setting a shape directly, you can also use the categorize() function to assign shapes based on a field:

element {
  shape: categorize("Element Type");
}

The categorize() function has its own list of default shapes, but you can list your own shapes to customize which ones are used, and in what order:

element {
  shape: categorize("Element Type", diamond, hexagon, triangle);
}

Or, list a shape and a specific field value to control precisely how those shapes get assigned:

element {
  shape: categorize("Element Type", diamond "Person", hexagon "Organization");
}

Finally, if you'd like your categorized shapes to be automatically added to the legend, use the element-shape rule inside a @settings block:

@settings {
  element-shape: categorize("Element Type", diamond, hexagon, triangle);
}

Open the

You can replace element with any element , and circle with any valid shape:

By default, the limits you to squares and straight lines, but if you want it to support all shapes, add @settings { renderer: canvas; } to your Advanced Editor.

selector
geo template
direct decoration toolbar
Assigning shapes manually
Assigning shapes to specific selections
Assigning shapes to all elements automatically
Assigning shapes from the Advanced Editor
shapes direct decoration
decoration builder shapes
Automatic shaping by element type
legend shapes
Basic Editor