> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Blueprint Routing

> Set up Blueprint routing rules in Iru Endpoint to automatically assign devices to the correct Blueprint during enrollment based on device attributes.

<Callout icon="earth-americas" color="#B84A7A" iconType="regular">This guide applies to all device platforms</Callout>

## What is Blueprint Routing?

Blueprint Routing lets you assign devices to Blueprints dynamically during enrollment. Device and user information collected at enrollment is evaluated against your rules, and each device is routed to a Blueprint on a first-match basis. You don't need to hand out Blueprint-specific enrollment codes or assign devices to Blueprints beforehand, for example with [Apple Automated Device Enrollment (ADE)](/en/endpoint/settings/apple-integrations/configure-automated-device-enrollment).

## How It Works

Blueprint Routing uses blocks of Assignment Rules, similar to [Assignment Maps](/en/endpoint/blueprints/assignment-maps/creating-a-blueprint). During enrollment, Iru evaluates initial device and user information against those rules and routes devices to the matching Blueprint. You get a single enrollment entry point across all platforms.

## Configuring Blueprint Routing

<Steps>
  <Step title="Navigate to Blueprint Routing">
    As an Iru tenant **admin**, go to **Enrollment** and click **Blueprint Routing** in the upper-right corner.
  </Step>

  <Step title="Edit configuration">
    Click **Edit**.
  </Step>

  <Step title="Set ADE Library Item (optional)">
    For Apple devices enrolling with ADE, optionally select a default **ADE Library Item for Apple devices**.

    <Frame>
      <img src="https://mintcdn.com/iru/SNmCOsh4D_3DR-Yp/assets/media/images/blueprint-routing-ade-default.png?fit=max&auto=format&n=SNmCOsh4D_3DR-Yp&q=85&s=48854d600c6194723f26819ecde1f3dd" alt="Blueprint Routing ADE Library Item default selection" width="745" height="233" data-path="assets/media/images/blueprint-routing-ade-default.png" />
    </Frame>
  </Step>

  <Step title="Configure rules and default Blueprint">
    Configure your rules in the **if** and **if else** rule blocks, and click **+ add else if** to add additional rule blocks.

    <Frame>
      <img src="https://mintcdn.com/iru/SNmCOsh4D_3DR-Yp/assets/media/images/blueprint-routing-add-rules.png?fit=max&auto=format&n=SNmCOsh4D_3DR-Yp&q=85&s=e682aed33832fc368ae71a911336bc95" alt="Blueprint Routing add rules and rule blocks" width="2043" height="969" data-path="assets/media/images/blueprint-routing-add-rules.png" />
    </Frame>
  </Step>

  <Step title="Set default Blueprint (Fallback)">
    Set a default Blueprint for when no rules match—called the **Fallback** route in the **else** block.

    <Frame>
      <img src="https://mintcdn.com/iru/SNmCOsh4D_3DR-Yp/assets/media/images/blueprint-routing-blueprint-default.png?fit=max&auto=format&n=SNmCOsh4D_3DR-Yp&q=85&s=6d18e249f47e3b78460d2a5e7fc30191" alt="Blueprint Routing default Blueprint Fallback selection" width="2043" height="270" data-path="assets/media/images/blueprint-routing-blueprint-default.png" />
    </Frame>
  </Step>

  <Step title="Reorder rules">
    To change the order in which rules are evaluated, drag rule blocks using the drag handle.

    <Frame>
      <img src="https://mintcdn.com/iru/SNmCOsh4D_3DR-Yp/assets/media/images/blueprint-routing-reorder-rules.png?fit=max&auto=format&n=SNmCOsh4D_3DR-Yp&q=85&s=afeed89adea64ded0a21dca599085079" alt="Blueprint Routing rule blocks with drag handle for reordering" width="1061" height="459" data-path="assets/media/images/blueprint-routing-reorder-rules.png" />
    </Frame>
  </Step>

  <Step title="Add custom block labels (optional)">
    You can optionally add a custom label to each routing block. Labels appear in the upper-right corner of the block, in the Blueprint Routing configuration, and in Activity entries.

    <Frame>
      <img src="https://mintcdn.com/iru/SNmCOsh4D_3DR-Yp/assets/media/images/blueprint-routing-label.png?fit=max&auto=format&n=SNmCOsh4D_3DR-Yp&q=85&s=784d752c788178960ba34c3042e6e8e3" alt="Blueprint Routing block with custom label" width="362" height="222" data-path="assets/media/images/blueprint-routing-label.png" />
    </Frame>
  </Step>

  <Step title="Save">
    Click **Save**.
  </Step>
</Steps>

### Example Blueprint Routing Configuration

One way to use Blueprint Routing is to send devices to different Blueprints based on who they’re for and what type they are.

In the example below, the first rule assigns all devices whose asset tag contains "MKT-" to the Marketing Blueprint. The second matches on asset tag "WXP-"; those devices (Windows) are sent to the WXP Blueprint. The third sends all iPad devices to the iPad Devices Blueprint. The Fallback sends every other device to a Default Blueprint.

Each rule block in this configuration has a label in the upper-right corner, next to the trash can icon, highlighted in blue. Labels make it easy for your team to see the purpose of each block.

<div className="blueprint-routing-config-image">
  <Frame>
    <img src="https://mintcdn.com/iru/SNmCOsh4D_3DR-Yp/assets/media/images/blueprint-routing-config-example.png?fit=max&auto=format&n=SNmCOsh4D_3DR-Yp&q=85&s=c2d9e8a4df61cf15172b18bc67387fd6" alt="Blueprint Routing configuration example showing rule blocks and default Blueprint selection" width="2048" height="1454" data-path="assets/media/images/blueprint-routing-config-example.png" />
  </Frame>
</div>

## Rule Evaluation

Rules are evaluated from top to bottom; the first rule that matches determines the device's destination Blueprint.

Blueprint Routing supports the same rules as [Assignment Maps](/en/endpoint/blueprints/assignment-maps/creating-a-blueprint), except for FileVault. This includes tags, which you can assign to ADE devices before enrollment and use in routing rules. See [Tags for Devices](/en/endpoint/devices/device-record-management/tags-for-devices#tags-for-automated-device-enrollment) for details.

A rule unique to Blueprint Routing, **ADE enrolled and token**, applies only to Apple ADE enrolled devices and is useful when using the Iru Endpoint API for multiple tokens. See [Configure multiple ADE tokens using the Iru Endpoint API](/en/endpoint/settings/apple-integrations/configure-multiple-automated-device-enrollment-tokens).

### When Rules Are Evaluated

Blueprint Routing rules are only evaluated during enrollment. For ongoing dynamic configuration management, see [Using Conditional Logic in Blueprints](/en/endpoint/blueprints/assignment-maps/using-conditional-logic-in-blueprints).

Blueprint Routing decides which [Assignment Map](/en/endpoint/blueprints/assignment-maps/creating-a-blueprint) a device should be assigned to, and conditional logic within an [Assignment Map](/en/endpoint/blueprints/assignment-maps/creating-a-blueprint) decides which Library Items the device should receive.

## Blueprint Routing Activity

The **Activity** tab of Blueprint Routing shows all activity related to Blueprint Routing, including:

* When the Blueprint Routing configuration is edited, who made the change, and when
* When devices enroll using Blueprint Routing
* Routing actions taken against devices enrolling through Blueprint Routing, including the ruleset that matched and the device information available to Iru at the time the routing decision was made
* Manual Enrollment changes for Blueprint Routing, including when it is turned off or on for Manual Enrollment, and/or if the enrollment code is changed

Some of these entries also appear on the [Activity Page](/en/endpoint/devices/activity-page), and device enrollment and routing entries are recorded in the device's own activity log.

**Device Routed** activity entries include the first ruleset that matched, its position in the routing configuration, and its label (if configured). All device details used to evaluate both the matching ruleset and all preceding rulesets are also listed.

<Frame>
  <img src="https://mintcdn.com/iru/SNmCOsh4D_3DR-Yp/assets/media/images/blueprint-routing-device-routed.png?fit=max&auto=format&n=SNmCOsh4D_3DR-Yp&q=85&s=c55ac36422d02cd6ded1b52cd279f8c9" alt="Device Routed activity entry showing matched ruleset and device details" width="654" height="958" data-path="assets/media/images/blueprint-routing-device-routed.png" />
</Frame>

## Enrolling with Blueprint Routing

Blueprint Routing is available for the following enrollment methods:

### Manual Enrollment with Blueprint Code and Android Work Profile

Blueprint Routing appears as a choice at the top of the list of Blueprints in the **Enrollment > Manual Enrollment** section. You can turn Blueprint Routing off or require authentication for it, just like you can with any other Blueprint.

<Frame>
  <img src="https://mintcdn.com/iru/SNmCOsh4D_3DR-Yp/assets/media/images/blueprint-routing-manual-enrollment.png?fit=max&auto=format&n=SNmCOsh4D_3DR-Yp&q=85&s=0cf04a8c9b18c57b4cb90f3a5445cf88" alt="Manual Enrollment section showing Blueprint Routing at the top of the Blueprint list" width="1688" height="224" data-path="assets/media/images/blueprint-routing-manual-enrollment.png" />
</Frame>

### Automated Device Enrollment

#### Assigning Devices to Blueprint Routing

Blueprint Routing appears as a choice in the Blueprint selector to assign devices awaiting enrollment. For setting up ADE and syncing devices from Apple Business or Apple School Manager, see [Configure Automated Device Enrollment](/en/endpoint/settings/apple-integrations/configure-automated-device-enrollment).

<Frame>
  <img src="https://mintcdn.com/iru/SNmCOsh4D_3DR-Yp/assets/media/images/blueprint-routing-ade-enrollment.png?fit=max&auto=format&n=SNmCOsh4D_3DR-Yp&q=85&s=ff7cab23f278f4104ebb933eb866abb2" alt="Automated Device Enrollment awaiting enrollment list with Blueprint Routing in the Blueprint selector" width="506" height="336" data-path="assets/media/images/blueprint-routing-ade-enrollment.png" />
</Frame>

If you assign a device awaiting enrollment to Blueprint Routing, it will re-enroll through Blueprint Routing on every subsequent enrollment until you reassign it to a different Blueprint. This means Blueprint Routing can be reused on the same device without admin intervention.

#### ADE Library Item Assignment

Optionally set or override the ADE Library Item for a device (or multiple devices) instead of using the one from Blueprint Routing.

<Steps>
  <Step title="Navigate to Automated Device Enrollment">
    In Iru Endpoint, go to **Enrollment** → **Automated Device Enrollment**.
  </Step>

  <Step title="Filter and select devices">
    Filter by **Awaiting Enrollment** (or **All**) to view unenrolled devices, then select the device(s) whose ADE Library Item you want to set or override.
  </Step>

  <Step title="View the ADE Library Item Column">
    The **ADE Library Item** column shows the name of the ADE Library Item assigned to the Blueprint selected for enrollment or Blueprint Routing, or **None** if none is assigned.

    <Frame>
      <img src="https://mintcdn.com/iru/CVmlkJ7omYtYwEGw/assets/media/images/iru-ade-library-item-unlink-from-blueprint.png?fit=max&auto=format&n=CVmlkJ7omYtYwEGw&q=85&s=65516a3ce4998d75a3c412983e4ad9d1" alt="ADE Library Item column showing None and Unlink from Blueprint button" width="878" height="174" data-path="assets/media/images/iru-ade-library-item-unlink-from-blueprint.png" />
    </Frame>
  </Step>

  <Step title="Unlink from Blueprint">
    To override the assignment so you can choose a different ADE Library Item, click **Unlink from Blueprint** or **Unlink from Blueprint Routing**, whichever appears.
  </Step>

  <Step title="Re-link or select an ADE Library Item">
    Once unlinked, choose **Re-link to Blueprint** or **Re-link to Blueprint Routing**, or select an **ADE Library Item** from the list. You can do this for one device or for many via multi-select.

    <Frame>
      <img src="https://mintcdn.com/iru/CVmlkJ7omYtYwEGw/assets/media/images/iru-ade-library-item-select-or-relink.png?fit=max&auto=format&n=CVmlkJ7omYtYwEGw&q=85&s=e63eae7cd50bcce6164613d35cafd773" alt="ADE Library Item dropdown with Select ADE Library Item and Re-link to Blueprint options" width="458" height="482" data-path="assets/media/images/iru-ade-library-item-select-or-relink.png" />
    </Frame>

    <Note>
      A direct assignment is sticky and will always apply to the device unless you manually re-link it to the Blueprint or Blueprint Routing. Re-linking can be done one device at a time or in bulk.
    </Note>
  </Step>
</Steps>

#### Tags for ADE Devices

You can assign tags to ADE devices before they enroll; those tags carry over to the enrolled device and stay in sync. Tags can be used in Blueprint Routing rules to route devices to Blueprints during enrollment. See [Tags for Devices](/en/endpoint/devices/device-record-management/tags-for-devices#tags-for-automated-device-enrollment) for instructions.

## Considerations for Apple Automated Device Enrollment

### Without Blueprint Routing

Automated Device Enrollment (ADE) settings are configured using the ADE Library Item assigned to specific Blueprints. ADE devices awaiting enrollment are also assigned to those Blueprints, so the path is: Devices → Blueprints → ADE Library Item(s).

### With Blueprint Routing

Rules are evaluated just in time during enrollment, so you don't know the destination Blueprint until the device enrolls and device and user information is collected. To configure ADE settings for those devices, set the ADE Library Item to use in the Blueprint Routing config itself (see the optional step in Configuring Blueprint Routing).

<Note>
  Assignment to Blueprint Routing persists across re-enrollments until the device's awaiting enrollment record is set to a different Blueprint.
</Note>

## Enterprise API Actions for Blueprint Routing

The following are supported for Blueprint Routing via the Enterprise API:

* Changing the Manual Enrollment code
* Turning Manual Enrollment off or on
* Assigning Awaiting Enrollment devices to Blueprint Routing
* Viewing Blueprint Routing activity

For more details, visit the [Iru Endpoint API documentation](https://api-docs.kandji.io).

## Related Articles

<CardGroup cols={3}>
  <Card title="Tags for Devices" icon="tag" href="/en/endpoint/devices/device-record-management/tags-for-devices#tags-for-automated-device-enrollment">
    Organize and group devices using tags
  </Card>

  <Card title="Creating a Blueprint" icon="box" href="/en/endpoint/blueprints/assignment-maps/creating-a-blueprint">
    Create a Blueprint with Assignment Maps
  </Card>

  <Card title="Using Conditional Logic in Blueprints" icon="code" href="/en/endpoint/blueprints/assignment-maps/using-conditional-logic-in-blueprints">
    Use conditional logic in Assignment Maps
  </Card>

  <Card title="Configuring Blueprints" icon="cog" href="/en/endpoint/getting-started/blueprints-and-library/configuring-blueprints">
    Create and configure device Blueprints for policy management
  </Card>

  <Card title="Configure Automated Device Enrollment" icon="apple" href="/en/endpoint/settings/apple-integrations/configure-automated-device-enrollment">
    Set up Automated Device Enrollment for zero-touch deployment and lifecycle management of corporate Apple devices
  </Card>
</CardGroup>
