Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Alerts and IRMbreadcrumb arrow Workflowsbreadcrumb arrow Use Blueprints
Grafana Cloud
Last reviewed: May 21, 2026

Use Blueprints

Note

Grafana Workflows is currently in private preview. Grafana Labs offers support on a best-effort basis, and breaking changes might occur prior to the feature being made generally available.

Blueprints are prebuilt workflow templates that cover common automation scenarios. Use a blueprint when you want a working starting point instead of building a workflow from scratch.

Each blueprint is a ready-to-edit workflow definition. After you choose one, you customize the name, fill in any team-specific values such as Slack channel IDs, and save it like any other workflow.

Before you begin

To use Blueprints, you need:

  • A Grafana Cloud account with Workflows enabled for your stack
  • The integrations referenced by the blueprint, for example, a Slack workspace connected to your Grafana Cloud instance for blueprints that post to Slack

Open the Blueprints library

The Workflows app shows blueprints in two places on the Home page:

  • The Choose from Blueprint action card opens the full Blueprints library.
  • The Blueprints library section on the same page surfaces a curated grid of cards.

To open the full library:

  1. In Grafana, navigate to More apps and open the Workflows app.
  2. On the Home page, click Choose from Blueprint.

The Select scenario to create workflow dialog opens with the available blueprints.

Find the right blueprint

Use the controls at the top of the dialog to narrow down the list:

  • Category filter: Use the radio buttons to filter by category, for example, Incidents or Alerts. The category is derived from the blueprint’s trigger.
  • Search: Use the Search by title input to filter cards by title or description.

Each card shows the blueprint title, a short description of what it does, the trigger type, and the icons of the steps it includes.

Create a workflow from a blueprint

  1. Select a card to open the Create from Blueprint dialog.
  2. Enter a workflow name. The dialog generates a unique metadata name from the title.
  3. Click Create.

The editor opens with the blueprint’s steps prefilled. The workflow is disabled by default so you can finish customizing it before it runs.

Customize the blueprint

Most blueprints leave one or more inputs empty for you to fill in. For example, an IRM paging blueprint expects you to set the on-call user’s email, and a Slack-based blueprint expects you to set the channel ID.

To customize a blueprint:

  1. Select each step in the workflow tree to open its configuration panel.
  2. Update the inputs that are empty or contain placeholder values.
  3. Adjust any condition strings, message templates, or wait durations to match your team’s process.
  4. Click Run in the editor header to test the workflow with a sample event. For details, refer to Configure triggers.
  5. When you’re satisfied, click Save, then toggle the Enable switch.

For details on the editor, refer to Create workflows.

Next steps