Skip to main content
This guide applies to all device platforms

​
About Migration from Classic Blueprints to Assignment Maps

Migration from Classic Blueprints to Assignment Maps is the process of moving from the legacy Blueprint system to the modern, flexible Assignment Maps system in Iru Endpoint. This provides better organization and more detailed Library Item scoping capabilities.

​
How It Works

Moving to Assignment Maps improves how you manage your devices in Iru Endpoint. Here’s what you need to know, along with some tips to make the transition as smooth as possible.

​
Automatic vs. Manual Migration

  • If you have Classic Blueprints with Library Items but no Assignment Rules, those Blueprints will be automatically converted to Assignment Maps later this year. You don’t have to wait, though—you can migrate them now by following the steps below.
  • If your Classic Blueprints include Library Items with Assignment Rules, you’ll need to convert those manually. Automatic migration isn’t available for Classic Blueprints with Assignment Rules.

​
Simplifying your Blueprint Landscape

Blueprints are designed to group similar devices, and Assignment Maps take that idea further. As you migrate, aim for clarity and simplicity. If possible, consolidate multiple Classic Blueprints into a single Assignment Map to reduce complexity and make management easier.

​
How to Perform an Automatic Blueprint Migration

1

Access Blueprints

From the left navigation, select Blueprints.
2

Locate Classic Blueprints

Scroll down to the Classic Blueprints section.
3

Identify Migration Type

4

Start Conversion

Click the ellipses.
5

Convert to Assignment Map

Click Convert to Assignment Map.
6

Confirm Conversion

Click Confirm.
7

Verify Migration

Scroll to the top of the page and note that the migrated Blueprint is now listed in the top Blueprints section.

​
How to Perform a Manual Blueprint Migration

​
Create a New Blueprint

If desired, you can create a one-to-one Assignment Map for each Classic Blueprint; however, we recommend consolidating where possible.
1

Access Blueprints

From the left navigation, select Blueprints.
2

Add New Blueprint

Click + Add Blueprint.
3

Start from Scratch

Select Start from scratch.
4

Configure Blueprint

Give your new Assignment Map a name and, optionally, a description.
5

Create Blueprint

Click Create Blueprint.

​
Add Library Items

If you’re bringing over Library Items from a Classic Blueprint without Assignment Rules, you can filter those items and drag them into your new Assignment Map.
1

Search Library Items

Search for the Library Items you want to migrate.
2

Filter by Blueprint

Click Filters > Blueprint, then check the box next to the Classic Blueprint you’re working with.
3

Select and Drag Items

You can select multiple items at once (shift-click) and drag them into your Assignment Map.
Considerations If you’re using a separate Blueprint for each department, this is a good time to consolidate. Use conditional logic in your Assignment Map (like if/else structures) to handle department-specific assignments. Filter for each department’s Classic Blueprint and drag the right items into the corresponding node. For more information on using conditional logic in Assignment Maps, see our Using Conditional Logic in Assignment Maps support article.
  • If you have Library Items with rules, make note of them and recreate that logic in assignment nodes within Conditional Blocks in your Assignment Map. Think about ways to simplify—like grouping items or updating your scoping logic to make things more efficient.
    • Example: If you’re deploying a custom app to several Okta groups, consider nesting those groups under a main group in Okta and referencing that group in your Assignment Map, rather than listing each group individually.

​
Import Parameters (Optional)

If you’re using Parameters, you can bring them from a Classic Blueprint into your new Assignment Map.
1

Access Parameters Tab

Inside your Assignment Map, navigate to the Parameters tab.
2

Import from Existing Blueprint

Click Import from existing Blueprint.
3

Select Blueprint

Choose the Blueprint you want to import from.
4

Import Parameters

Click Import Parameter.

​
Reassign Devices to the New Assignment Map

Once you’ve migrated your Library Items, Parameters, and Assignment Rule logic, you’re ready to move devices from their old Classic Blueprint to the new Assignment Map. You can do this one device at a time or in bulk. Changing a device’s Blueprint only updates Library Item assignments if they’re different between the old and new Blueprint. For example, if both Blueprint include the same WiFi Library Item, moving the device won’t affect its WiFi configuration. It’s a good idea to move a single device or a small group first to confirm everything works as expected. To move an individual device:
1

Open Device Details

Open the Device Details page for the device you want to move.
2

Edit Device Details

Click Edit Device Details.
3

Edit Blueprint

Click Edit Blueprint.
4

Select New Assignment Map

Select the new Assignment Map.
To move devices in bulk:
1

Select Devices

In the Devices view, filter and select the checkboxes next to the devices you want to move.
2

Change Blueprint

Click Change Blueprint.
3

Select Assignment Map

Select the new Assignment Map from the dropdown.
4

Confirm Change

Click Change.
For more detailed information on moving devices between Blueprints, see our Move a Device to a Different Blueprint support article.