Skip to main content

Build a Map: Start to Finish

Learn how to build a map from start to finish in Kadince

Summary

Every Kadince map is constructed the same way: reports supply the data, and the map stacks that data in layers.

This guide walks through one full, generic build to help you understand the principles behind mapping, and how you can build your own. From a blank map to a board-ready view of your impact by county. Swap in your own states, counties, objects, and dates and the steps stay the same.

The example map shows 2026 donations and events across the counties where an institution has branches.

The core idea: a map never pulls entries directly. Each data layer (a Map Element) reads one saved report. If the report shows the right entries, the map shows them too.


Before You Start

  • Permissions: your role needs Report and Dashboard Builder Access to build maps (see User Roles: Permissions).

  • Addresses: entries only appear on a map if they have a full address on the Location tab and it geocoded successfully. Open an entry and check its geocoding confidence on the Location tab.

  • Sketch your layers first. Write down each layer you want, from back to front. For the example map:

Layer

Data Source

Style

Counties

Other → Counties

Boundaries

2026 Donations

Reports → Your Donations Report

Points or Clustered Pins

2026 Events

Reports → Your Events Report

Points or Clustered Pins

Each data layer needs its own saved report, so build those first (Step 1).


Step 1: Build the Report That Feeds Each Data Layer

Build one report per data layer (for example, one for Donations and one for Events).

  1. Click Reports in the side navigation

  2. Click the Add New Report button

  3. Name the report (e.g., Donations - 2026), select the object (e.g., Donations), and choose a folder

  4. Click Submit

  5. Confirm the report shows the entries you expect before adding any filters

Limit the Report to a Date Range (Optional)

A date range takes two filters on the same date field: one for the start and one for the end.

  1. Open the report and expand the filters area

  2. Click the three-dot menu button and select Add Filter

  3. Choose a date field, set the logic to after or equal to, and enter the start date (e.g., 01/01/2026)

  4. Click Submit

  5. Add a second filter on the same date field, set to before or equal to and the end date (e.g., 12/31/2026)

  6. Make sure the filter group is set to Match All

  7. Click Save and Refresh

Tip: Pick a field that holds a real calendar date. If the field's values are choices like "Monthly" or "Annually," it's a dropdown, and date logic won't work on it. When in doubt, add the field as a column first and look at its values.

Tip: The map updates on its own. Any new entry that matches the report's filters and has a mappable address appears on the map the next time it loads.

For more on filters, see the Reports: Filters & Filter Groups article.

Step 2: Create the Map

  1. Click Mapping in the side navigation

  2. Click the Add New Map button

  3. Enter a Map Title and select a Folder Location

  4. Click Submit

  5. Click the open map icon to open it

A new map opens as a blank base map. Everything you see on it comes from the Map Elements you add next.

Step 3: Add Boundary Layers (Counties, States, and More)

Boundary layers outline the areas you serve. They come from public data, not your reports.

  1. Scroll to the Map Elements section and click the plus (+) button

  2. Enter a Name (e.g., Utah Counties)

  3. For Element Data Source, choose Other, then the boundary type (e.g., Counties)

    1. This may take a few seconds to load

  4. Set the State, then the County field: pick only the counties you want shown

  5. Choose a Style:

    • Boundaries: outlines only (best for a county map with pins on top)

    • Shape: filled areas, no outline

    • Boundaries & Shapes: both

  6. Set the Label Option to the name you want printed on each area (e.g., the county name)

  7. Make the lines easy to see from far away:

    • Boundary Width: 0–10 pixels. Try 2–3 so lines show when zoomed out

    • Boundary Opacity: try 100% for solid lines

    • Line color (under Palette): pick a dark color

  8. Click Submit, then Save

Need a second state? Repeat these steps with a new element (e.g., Idaho Counties). You can also Clone the first element from its three-dot menu and just change the state and counties.

Tip: The Variable field only appears for the Shape styles. Use it if you want to shade areas by a value; otherwise leave it blank.

Step 4: Add Your Data Layers (Donations, Events, and More)

  1. In Map Elements, click the plus (+) button

  2. Enter a Name (e.g., 2026 Donations)

  3. For Element Data Source, choose Reports, then select the saved report from Step 1

  4. Choose a Style:

Style

What it Shows

Best For

Points

One pin per entry; you can pick an icon

Board-ready maps where every activity should be visible

Clustered Pins

Nearby entries merge into a numbered circle until you zoom in

Lots of entries close together

Heat Map

A color gradient showing concentration

Showing where activity is densest

Radius Pins

A pin with rings at set distances

Showing reach around a location (e.g., branches)

  1. (Optional) Choose a Variable to color pins by a value, such as Amount, and pick an Element Color Palette

  2. Click Submit, then Save

  3. Repeat for each data layer (e.g., 2026 Events), using a different icon or color so readers can tell them apart

Seeing small circles with numbers in them? That's Clustered Pins working as designed: each circle groups nearby entries. Zoom in to split them apart, or switch the element to Points.

Step 5: Arrange, Print, and Share

Layer Order: drag the element tiles in Map Elements. The right-most tile is the front layer. Put boundary layers on the left (back) and data layers on the right (front) so pins sit on top of county lines.

Show or Hide a Layer: click an element's three-dot menu and select Show or Hide Element. If the menu offers Hide Element, the layer is already showing.

Print: frame the view you want first, because the print preview captures only what's on screen. Then click the map's three-dot menu, select Print Preview, and click the print icon.

Share: click Edit, then the pencil icon on Share Settings. Share with All Users (view only) or Specific Users (view or edit), then click Save.

Full details: Mapping Tool.


Troubleshooting & FAQ

My element saved, but I don't see anything. Why?

Zoom in first. With Clustered Pins, entries show as small numbered circles when you're zoomed out. Thin boundary lines can also disappear at a distance; raise the Boundary Width.

My report shows "No Data to Display" after I added a date filter.

Check that the filter uses a real date field (not a dropdown) and that both range filters use the same field with Match All. Remove the filters to confirm the entries exist, then add them back one at a time.

My county lines are faint or dotted.

Edit the boundary element: set Boundary Width to 2–3 pixels, Boundary Opacity to 100%, and pick a darker line color.

Only some county names show.

Confirm the Label Option is set to the county name. Labels may also be hidden at some zoom levels to avoid overlap.

Some entries are missing from the map.


Related Resources

Did this answer your question?