---
title: "Migrating from Classic Blueprints to Assignment Maps"
slug: "migrating-from-classic-blueprints-to-assignment-maps"
updated: 2025-06-12T16:22:06Z
published: 2025-06-12T16:26:39Z
canonical: "support.kandji.io/migrating-from-classic-blueprints-to-assignment-maps"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.kandji.io/kb/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrating from Classic Blueprints to Assignment Maps

Moving to Assignment Maps is a big step forward for managing your Apple devices in Kandji. 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. From the left navigation, select **Blueprints**.
2. Scroll down to the **Classic Blueprints** section.
3. Blueprints below the yellow banner will need to be migrated following the [How to Perform a Manual Blueprint Migration](/docs/migrating-from-classic-blueprints-to-assignment-maps#how-to-perform-a-manual-blueprint-migration) section.
4. Blueprints below the blue banner will automatically be migrated by the end of 2025.
5. Click the ellipses.
6. Click **Convert to Assignment Map**. ![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/Kandji-Support-KB-0736AM@x.png)
7. Click **Confirm**.

![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/Kandji-Support-KB-0820AM2x.png)
8. Scroll to the top of the top of the page.
9. Note that the migrated Blueprint is now listed in the top Blueprints section.

![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/Kandji-Support-KB-0818AM2x.png)

### How to Perform a Manual Blueprint Migration

#### **Create a New** Blueprint

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

1. From the left navigation, select **Blueprints**.
2. Click **+ Add Blueprint**. ![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/Kandji-Support-KB-0647AM 2@2x.png)
3. Select **Start from scratch**.

![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/Kandji-Support-KB-0650AM@2x.png)
4. Give your new Assignment Map a **name** and, optionally, a **description**.
5. Click **Create Blueprint**. ![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/Kandji-Support-KB-0652AM@2x.png)

#### **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 for the Library Items you want to migrate.
2. Click **Filters >** Blueprint, then check the box next to the Classic Blueprint you’re working with.
3. You can select multiple items at once (shift-click) and drag them into your Assignment Map. ![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/Kandji-Support-KB-0708AM@2x.png)

**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](/docs/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. Inside your Assignment Map, navigate to the Parameters tab.
2. Click **Import from existing Blueprint**.
3. Choose the Blueprint you want to import from.
4. Click **Import Parameter**. ![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/Kandji-Support-KB-0713AM@2x.png)

#### **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 the Device Details page for the device you want to move.
2. Click **Edit Device Details**.
3. Click **Edit** Blueprint.
4. Select the new Assignment Map.

**To move devices in bulk:**

1. In the Devices view, filter and select the checkboxes next to the devices you want to move.
2. Click **Change Blueprint**.
3. Select the new Assignment Map from the dropdown.
4. Click **Change**.

For more detailed information on moving devices between Blueprints, see our [Move a Device to a Different Blueprint](/docs/move-a-device-to-a-different-blueprint) support article.