Configuring an Activation Condition - Jamf Pro Blueprints Configuration Guide

Jamf Pro Blueprints Configuration Guide
Solution
Application
Content Type
Technical Documentation
Utilities & Services
ft:locale
en-US

Each component block in a blueprint has its own activation condition. An activation condition controls when the components in that block activate on a device. When an activation condition contains multiple criteria, the "Match all" or "Match any" setting controls how those criteria are evaluated. "Match all" requires every criterion to be true. "Match any" requires at least one criterion to be true.

When the conditions you define are met, the components in that block activate. When they are not met, the components remain inactive until the device's state changes. If you do not configure an activation condition for a block, the components in that block activate on all devices in scope.

When your deployment scenario requires both types of logic in a single activation, click +Add block. This creates a container with its own "Match all" or "Match any" setting, evaluated independently from the top level. For example, you can require devices to have iOS 17 or later and also have a specific certificate installed or a compliant passcode.

Note:

The +Add block button applies only within the activation condition editor. It creates a logic group that combines "Match all "and "Match any" criteria. It does not add a component block. To add a component block to the blueprint, use the +Add component block button in the blueprint builder.

You can configure activation conditions using a visual builder or text input field. The visual builder guides you through available options using a tree-like interface and is recommended for most administrators. The text input field gives you direct control over the configuration and is intended for advanced use cases. For more information on using the text input field, see Activation Condition Expression Reference.

Note:

The visual builder supports the most commonly used criteria. If you enter a condition expression in the text field that the visual builder does not recognize, you cannot switch back to the structured view. After saving, the condition displays as the expression you entered rather than what was built in the structured visual view.

  1. Click Blueprints in the sidebar.
  2. Create or edit a blueprint.

    For more information, see Building a Blueprint from a Library of Components.

  3. Locate the component block you want to configure an activation condition for.
  4. Next to the component block's "Activation condition" label, click Edit .
  5. (Optional) To configure an activation condition using an expression using the text input field, click the Text tab.

    For more information on configuring an activation condition expression, see Activation Condition Expression Reference.

  6. In the Visual tab, click Add criteria.
  7. Choose a device attribute or "Device group" from the first pop-up menu.
  8. Choose an operator from the second pop-up menu.
  9. Enter or choose a value in the third field or pop-up menu.
  10. Add as many rows as your deployment scenario requires.
  11. If you have multiple rows, use the "Match all" or "Match any" options at the top of the builder to control how the activation evaluates multiple criteria.
    • Match all —

      The configuration activates when all criteria are true.

    • Match any —The configuration activates when at least one criterion is true.
    Note:

    You can only use one operator ("Match all" or "Match any") at a given level of the builder. To combine both operators in a single activation, click +Add block.

  12. Click +Add block. Within the block, add criteria and set the "Match all" or "Match any" independently of the top level.
  13. Click Save.

The activation condition is saved to the blueprint's component block. Components in the blueprint activate on devices in scope when the conditions you defined are met.