Assignment Maps Overview

By Emalee Firestein

Learn about Assignment Maps, a new kind of Blueprint

Assignment Maps are a new type of highly visual and highly flexible Blueprint designed to reduce the overall number of Blueprints needed to meet even the most complex scoping requirements and provide the following benefits:

  • Assignment Rules that define which devices or which users should get which Library Items are reusable and easily grouped together, meaning you can define rules a single time, and assign as many Library Items as needed.
  • Nesting of Assignment Rules allows for conditions such as “full-time employees” AND in North America AND in the Pacific time zone.
  • Library Items can be reused on the same map, meaning the same Library Item or set of Items can be assigned differently without needing numerous Blueprints.
  • Inherent priority for “self-conflicting” Library Items, like Managed OS. A device that is in scope for multiple Library Items that conflict with one another will receive the Library Item farthest right on the map. This allows for “universal” update policies while still allowing for more specific policies for different users or devices, within the same Blueprint
  • Easy troubleshooting, even with increased flexibility. Assignment Maps have a device/user lookup feature that shows you the path a device took through the map to receive the Library Items assigned to it.

Assignment Map Components

Assignment Map Blueprints are made up of the following components:


  • All Devices node
    • This is the first node on the map and cannot be removed. In some ways, this is like a Classic Blueprint inside an Assignment Map. Anything placed in this node gets distributed to all devices that match the Installs On field of the Library Item(s). For example, an iOS app placed here will get assigned to all iOS devices on the Blueprint. A custom profile with Installs On set to Mac and iPad would be installed on all Mac computers and iPad devices, but not iPhones or Apple TVs.
  • Library Items
    • Unlike Classic Blueprints, with Assignment Maps, you configure Library Items first and then assign them later on the map; they are not added to maps from the Library Item itself. 
  • Library Item Bank (in edit mode only)
    • This is the list of all Library Items in your Kandji tenant. They can be filtered, sorted, and selected and dragged onto the map.
    • Multiselect is supported using Command + Click for individual items and/or Shift + Click to drag multiple items onto the map simultaneously.
  • Library Item Detail Pane
    • When clicking a Library Item in the bank or on the canvas, it appears on the right side of the page with more details about the Item, including its statuses.
  • Conditional Blocks
    • These are simple groups of If/Else conditions that use Assignment Rules, which reference both user and device-specific data (“facets”). 
    • Example: “User group is Marketing”. If you decide to group by department, you may have a conditional block that contains If statements (Assignment Nodes) for Marketing, Sales, R&D, etc.
    • These blocks can be nested within each other
    • Conditional Blocks always contain an “Else” Assignment Node for when a condition is not matched.
  • Assignment Nodes
    • Library Items are dragged and dropped onto the map into these.
    • These represent logical conditions that use Assignment Rules. 
    • These are contained in the Conditional Blocks.
  • Root line
    • All Conditional Blocks eventually connect back to the root line. This ensures that you cannot make a branch on an Assignment Map that is a “dead end”.


  • Library Items
    • This is a deduplicated or distinct list of Library Items used on the map with aggregated statuses. You can search and filter this list.
  • Devices
    • This is a list of devices assigned to the Blueprint and their statuses. You can filter and sort this list and/or take mass actions to delete or move devices.
  • Parameters
    • Configured on the Parameters tab, these are the same local compliance controls available for Mac computers as on Classic Blueprints. 
    • To more easily move to Assignment Maps, you can choose to import Parameters from a currently configured Classic Blueprint.
  • Activity
    • This is the activity stream for the Blueprint showing actions taken
    • More activity entries for Library Item and/or Map edits are coming soon.

To simplify problem-solving, Assignment Maps include a feature that allows you to search for devices using either user information or device specifics. This feature displays the precise route that the device followed on the map, similar to the example provided

Further Reading

To learn more about Assignment Maps, check out our other articles: