Skip to main content

Using Blueprints

Blueprints are reusable templates for creating tasks and production lines. Define a blueprint once, then apply it to create pre-configured tasks across one or many production lines.

What is a Blueprint

A blueprint contains:

  • Task templates — predefined task definitions with activities, configurations, and dependencies
  • Task group templates — shared configuration for groups of related tasks
  • Variables — input fields that get filled in each time the blueprint is applied
  • Graph node groups — visual grouping of tasks on the production line graph

When you apply a blueprint, the tasks and task groups get created from the template, substituting variable values you provide at apply time.

When to Use Blueprints

Use blueprints when you need to:

  • Create the same set of tasks across multiple production lines
  • Standardise how a specific workflow is configured
  • Bulk-create tasks from a CSV or Excel file
  • Share a repeatable pattern across teams or environments

Task Variables vs Task Group Variables

  • Task variables — values that differ per task. When applying in bulk, each row in the import file provides values for one task.
  • Task group variables — values shared across an entire task group. Set once when applying the blueprint.

Applying a Blueprint

There are two ways to apply a blueprint:

Single Mode

Apply the blueprint to one production line at a time. You fill in variable values through a form which creates the tasks.

You can:

  • Create a new production line
  • Add tasks to an existing production line
  • Skip production line creation and apply directly

Bulk Mode

Apply the blueprint to multiple records at once:

  1. Download a CSV or Excel template from the blueprint
  2. Fill in variable values — one row per task
  3. Upload the file
  4. Set any task group variables
  5. Submit to create all tasks

Viewing a Blueprint's Template

The Template tab on a blueprint's detail page shows the full configuration: task templates, task group templates, variables, and graph node groups. Use this to understand what a blueprint will create before applying it.

Protected Blueprints

Some blueprints are marked as protected. Protected blueprints cannot be edited but can still be applied.