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
  • Create an account
  • Create your first project
  • Picking a template
  • Build your first map
  • Build your map by hand
  • Decorate elements and connections
  • Use the profile to add additional information
  • Create your first decoration
  • Refine your view
  • Filter
  • Focus
  • Showcase
  • Cluster
  • Add a contributor

Was this helpful?

Edit on GitHub
  1. Getting started

First steps

PreviousKumu 101NextQuick tips

Last updated 1 month ago

Was this helpful?

This overview is a great place to start if you're new to Kumu. Take some time to read it through from end to end!

Jump to a section

Create an account

Create your first project

Work through the next couple of screens to name your project, decide whether it will be public or private, give it a description, etc. During this process, you'll also create your first map, and Kumu will ask you to pick a template for your map.

Picking a template

After creating a new project in Kumu, your next step is to pick which template you want to use for your first map:

We recommend most people start with the system, stakeholder, or SNA template, unless they have a good reason to do otherwise. Below is a description of each template's effect:

  • System template. Pick this template if you are creating a system map, causal loop diagram, or a stock and flow diagram. You'll position elements manually in a fixed position.

  • Stakeholder template. Pick this template anytime you are mapping the people and organizations involved in a system, and the relationships between. Elements will float around, finding their final position automatically.

  • SNA template. Pick this template anytime you are mapping large networks (1000+ elements). This template uses our "fast" mode, which draws elements as squares and connections as straight lines to improve performance. Elements are positioned automatically and will float around.

  • Custom template. Pick this template if you'd like to start out without any custom decorations or settings. Elements will float to find their final position and are displayed as small, grey circles.

Build your first map

Once you've chosen a template, you'll land on this screen:

This is your blank canvas, where you'll add elements (circles) and connections (lines) to visualize your system or network. If you're mapping a system, you will probably be adding loops (groups of two or more connections) as well.

At this point, you need to decide how to get all of this information into the map. There are three basic ways to do this:

Build your map by hand

Building your map by hand is a good choice for system maps or smaller network maps. If your map will have less than 50 elements, you can probably build it comfortably by hand. There are two ways to build a map by hand.

The green button

Click on the green button at the bottom of the map, and you'll see several options:

  • Add element

  • Add connection

  • Add loop

  • Sketch

  • Import

Try clicking on the first option, Add element, to create a new element. Kumu will prompt you to give the element a label and press the enter key on your keyboard. Voila! You've added your first element.

Add a few more elements, then try selecting Add connection from that menu to connect your elements. Once you have a few connections, you can select Add loop to create a group of connections.

Tip: Speed up this process by using keyboard shortcuts! Press E to add an element, C to add a connection, and L to add a loop. Or, hold alt on Windows/option on Mac, then click the map to add an element. Hold alt and click-and-drag from an element to create a connection.

Sketch mode

If you're building your map by hand, you should definitely give sketch mode a try! Click the green button and select Sketch to activate sketch mode.

Once sketch mode is activated, you can add an element by clicking anywhere on the map, and you can add a connection by clicking and dragging from an existing element.

Quickly enter sketch mode by pressing K on your keyboard, and press the esc key to exit. While in sketch mode, you can move elements by holding the alt key on your keyboard, then clicking and dragging the element.

Decorate elements and connections

To add that information, you'll use the panel on the left side of the map, which is called the profile.

Use the profile to add additional information

Each element, connection, and loop has a profile that can be used to store additional information in various fields.

Label, Type, Description, and Tags are all examples of fields. Use these fields to provide additional context for each element and connection, and click +NEW FIELD to add a custom field.

For this walkthrough, fill out the Type field for each of your elements—try to use a few different values so that you can assign decorations to them.

Create your first decoration

If you have filled out the Type field for your elements, try selecting Element Type from the dropdown menu next to Color by. Kumu will automatically color-code all of your elements by Type, and you can click the expand icon to choose a different color scale.

Refine your view

Great work so far—you've created a project, started building your first map, and even added decorations to liven things up. But as you expand your map with more data, you will probably want to view different slices of the data at different times, so you can tell a story without overwhelming your map readers.

To do that, you'll use filter, focus, showcase, and cluster—four different ways to refine what is visible or dominant in the map.

Filter

Filters make it easy to show and hide elements, connections or loops based on data stored in the profile. To experiment with filters, just open the Basic Editor, and select Filter.

If you're filtering by element or connection type, simply un-check the types you want to hide. To filter using other fields, use the Also include and But ignore tools. Click the rocket ship icon in each of those tools to select what you want to hide or make visible.

If you've hidden certain elements and connections using the Type checkboxes above, you can use the Also include tool to bring things back into view. But, you first have to un-check some of the boxes above, or this tool will have no effect.

Use the But ignore tool to hide elements and connections from your map. Anything you add here will override the settings in the checkboxes above and the Also include tool.

Focus

Focus works by showing only the portion of the network within a certain number of connections. Focus is activated in one of two ways:

  1. Click and hold on any element or connection, OR

  2. Select one or more elements, connections, or loops (press shift and click to select multiple items), then click the focus button in the bottom right of the profile.

Once focus is activated, everything except your selected items will be hidden from the map. Press the + key on your keyboard to extend the focus further out from your selection, and press the - key to narrow the focus back to your selection. Also, you can click and hold on any element to bring that element's direct connections into view.

To extend focus to a specific degree, use the numbers 0-9 on your keyboard. To quickly clear your focus, press the esc key.

Showcase

Showcase is similar to filter, which allows you to show or hide elements, connections, and loops based on the information they contain. But, instead of hiding your data, showcase will make it translucent, fading it into the background.

Experiment with showcase by opening the Basic Editor, and clicking Showcase.

Click the rocket ship icon to build the selection of items that you want to showcase.

Cluster

Clustering allows you to connect elements based on the data in their fields, and it's particularly useful on stakeholder and network maps. To set up your first cluster, open the Basic Editor, and use the dropdown next to Connect by to select a field. (If you've followed this guide all the way through, Element Type is a great first choice).

When clustering is activated, Kumu will create new elements to represent each possible value for the field that you chose, and it will draw a connection between your elements and the value(s) in their field. For example, if you have an element with the element type "Organization", Kumu will create an element labelled "Organization" and connect your element to it.

Just click Add rule to cluster by any of the information inside your elements.

Add a contributor

Building maps in Kumu can be a lot of work! Inviting somebody else to contribute to your project is a great way to reach your final destination more quickly. Even if your project is small and manageable, it's a good idea to let someone else weigh in on your data and design to make sure your story gets told effectively.

In the Username box, type the Kumu username of the person you want to add (if they don't have a username, they can get one for free at https://kumu.io/join) and click Add contributor.

Create an account by visiting . You'll use this account to sign in to Kumu and manage all of your projects inside of .

To create your first project, visit your and click on the NEW PROJECT button.

Not sure which one you need? .

In this guide, we'll cover how to build your map by hand. If you'd rather import from a spreadsheet or Google Sheets, .

Once you have built part of your map, it's the perfect time to learn how to use decorations to bring the data to life. It's possible to , but it's much faster and more scaleable to create decoration rules based on the information stored inside your elements and connections.

Click the settings icon on the right side of the map to open up the Basic Editor. You'll see the most popular settings listed, allowing you to easily size or color elements by a field. There's more options here, but let's start with the most basic ones! For the full explanation of each possible setting, visit .

Your first decoration is complete! If you like what you see, click SAVE at the bottom of the Basic Editor, and click the settings icon again (or press T on your keyboard) to return to your map.

When you're ready to add more customized, detailed decorations, take a look at our .

Settings for filter, focus, showcase, and cluster can be saved to a View, allowing you to easily switch between different refined versions of your data. To learn more, .

If you'd like to clear your focus and bring back the full map, click the focus icon on the right (underneath the settings icon ) and select Clear.

To add multiple cluster rules, click the settings icon to the right of the Connect by tool.

to learn more.

To add a contributor to a project, click the menu icon in the upper left of your project, then select MEMBERS from the sidebar.

For more info on collaboration in Kumu, visit .

You've completed the Getting Started series! For additional help, you can browse our other guides or email us at . We're always happy to help!

https://kumu.io/join
workspaces
dashboard
Check out our full guide on templates
check out our full guide on imports
change the color or size of individual elements and connections
decorations guide
check out our guide on Views
Check out our full clustering guide
our full guide on collaboration
support@kumu.io
Sketch mode
Create an account
Create your first project
Picking a template
Build your first map
Decorate elements and connections
Refine your view
Add a contributor
The green button
the Basic Editor guide
Template Selection
Filter menu
focus animation
Showcase
Showcase basic editor
Cluster basic editor