---
title: "Use Blueprints | Grafana Cloud documentation"
description: "Start a new Grafana Workflow from the Blueprints library and customize it for your team."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Use Blueprints

> Note
> 
> Grafana Workflows is currently in [private preview](/docs/release-life-cycle/). 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](/docs/grafana-cloud/alerting-and-irm/workflows/configure-triggers/#trigger-workflows-manually).
5. When you’re satisfied, click **Save**, then toggle the **Enable** switch.

For details on the editor, refer to [Create workflows](/docs/grafana-cloud/alerting-and-irm/workflows/create-workflows).

## Next steps

- [Get started with Grafana Workflows](/docs/grafana-cloud/alerting-and-irm/workflows/get-started)
- [Create workflows](/docs/grafana-cloud/alerting-and-irm/workflows/create-workflows)
- [Configure triggers](/docs/grafana-cloud/alerting-and-irm/workflows/configure-triggers)
- [Use CEL expressions](/docs/grafana-cloud/alerting-and-irm/workflows/use-expressions)
- [Step and trigger types reference](/docs/grafana-cloud/alerting-and-irm/workflows/reference)