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 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
  • Add images to elements
  • Add icons to elements
  • Add a background image

Was this helpful?

Edit on GitHub
  1. Guides
  2. Decorations

Images

PreviousIconsNextLabel templates

Last updated 21 days ago

Was this helpful?

In Kumu, there are a number of different places where you can use images to enrich your project.

Skip to section:

  • Adding images to elements

  • Adding icons to elements

  • Adding a background image

Add images to elements

Note: when you're uploading images, only JPEG, PNG, and GIF files smaller than 5mb are supported at this time.

Importing images through Google Sheets

If you're importing data with Google Sheets, then you'll have to include a URL to an image hosted publicly on the web. First, add an "Image" column in the "Elements" sheet of your Google Sheets file, and then add the public URL for the image that you want to add to each element (e.g. each row).

Note that the URL should lead directly to the image, so you might need to create such a URL first through an image hosting platform. Some images allow you to simply right-click on them and choose "Copy image address". You can then use that link as the image URL.

Troubleshooting images

Have you uploaded images, but are not seeing images on the map? Here are a few steps you can take to troubleshoot the problem:

  • If you're entering image links directly:

    • Make sure your link leads directly to the image, rather than a webpage with the image on it. There are many places where you can host your images, but this website is generally a good place to start. Some images also allow you to simply right-click on them and choose "Copy image address".

    • Make sure your image URL is using a secure connection—that is, the link starts with https instead of just http

Using decorations to add images

#my-element {
  image-url: url(https://example.com/my-element-image.png);
  image-size: contain;
  image-visibility: visible;
}

Be sure to check out our property reference for full documentation on properties that can be used in the Advanced Editor.

Add icons to elements

Using the Advanced Editor, you can easily bring in any Font Awesome icon to decorate your elements.

For more guidance, check out our full guide on icons.

Add a background image

  1. Create an element and change its label to background.

  2. Pin the element (press P on your keyboard, or click the pin icon in the left side panel).

  3. Copy/paste the following code into your Advanced Editor:

@settings {
  culling: off;
}
#background {
    image-url: url(https://s3.amazonaws.com/cloud.kumu.io/accounts/2057/201677/44522144-b11e-48dd-96b1-aeca8c3592d9.png);
    layer: background;
    shape: rectangle;
    height: 10000;
    width: 10000;
    color: transparent;
    image-size: contain;
    image-resolution: original;
    label-visibility: none;
}
  1. Click SAVE at the bottom of the Advanced Editor to save your changes.

You can replace the image-url in that code with a link to any image online. To get an image URL from any image you see online, you can right-click the image and select "Copy Image Address". When you're pasting your new image url into the Advanced Editor, make sure to put it inside the url( ) parentheses.

Also, if your image isn't big enough, or if it's so tall or wide that it's affecting your zoom fit, you can change the height and width numbers in the code to adjust the dimensions.

Some images won't be displayed in Kumu, because they are using an insecure connection (the link starts with http instead of https), or because they are traveling through a proxy server. If your image isn't displaying in Kumu, you can save the file to your computer and follow the steps below to upload the image directly to your Kumu project.

  1. Complete the initial steps above to create your background element, add your Advanced Editor code, and save your changes.

  2. Click More Options

  3. Select Decorate elements

  4. In the element decoration builder, set the dropdown at the top to "Decorate custom selection"

  5. Set the second row of dropdown menus to Label is background (assuming your background element's label is background)

  6. Check the box next to "Add image", then click "upload image"

  7. Upload your image, and click Done at the bottom of the decoration builder

  8. Click SAVE at the bottom of the Basic Editor

If you need to adjust the position of the image element in the map, you'll need to remove the layer: background; line. Click and drag the element to adjust its position, and then add back that line of code when you're done.

Notes:

  • "background" is the label of the element that will contain the background image in this example, but the label can be anything you want. Just make sure you update the #background selector in your code to match your new label.

  • image-resolution can have values of auto, original, or any number. The number you include (e.g. 1000) will adapt the resolution for an image of that width (1000px).

If you add a control to your map, you'll see that the background gets filtered out. If you want to keep your background as you filter, follow these steps:

  1. Create the control first. Don't forget to save it!

  2. Then go into the Advanced Editor and change the line from target: element; to target: :not(#background);

  3. Now the control won't affect the background!

As always, if you have any questions on how this works, email us at support@kumu.io for help!

If you are , you can easily upload an image file from your computer directly to Kumu. Just click an item (element, connection, or loop) on your map, click the camera icon in the upper right of the profile, and click "select a file" to upload your image.

You can upload images to descriptions and the map overview as well. To do this, click to edit any text area in the , and look for "select a file" below the text area.

Make sure you're not using the SNA template, which doesn't support images. If you are using that template, you can .

Disable image proxy: click the menu icon in the upper left of the map editor, then click Admin and click disable it.

With decorations, you can create rules that add the same image to multiple elements. To do this, , select which elements the rule will apply to, and check the box next to "Add image". You'll be prompted to add an image URL or upload an image from your computer, and your image will be added to the selected elements.

You can also use to add images and tweak their appearance on the map. In a decoration in the Advanced Editor, use the image-url property to set the image url for your selection, and use the image-visibility property to hide images or make them visible on the map. You can also use the image-size property to choose whether images on the map will completely cover their parent elements, or be fully contained inside the parent element.

To add a background image to a map, you can use a snippet of code in the . The following instructions will help you add an image of a world map, but they can be adapted to add any background image.

You can also use the to upload an image from your computer to your Kumu project—this will override the image-url in your code. Follow these steps:

Click the settings icon to open the Basic Editor.

building a map by hand
side panel
open the element decoration builder
advanced decorations
switch to a different one
Advanced Editor
Basic Editor
Gif showing how to upload an image to Kumu
elements with icons to show element type