---
title: "Start from a blueprint | 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).

# Start from a blueprint

> Note
> 
> Grafana Workflows is currently in [public preview](https://grafana.com/docs/release-life-cycle/). Grafana Labs offers limited support, 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 the blueprint’s steps use

Some blueprints rely on integrations, such as Slack, Microsoft Teams, or Grafana Assistant. Others need extra inputs from you, such as an API token that you store as a workflow secret. Check what a blueprint needs before you set it up. For details, refer to [What blueprints need from you](https://grafana.com/docs/grafana-cloud/platform/workflows/reference/blueprints/#what-blueprints-need-from-you).

## Open the Blueprints library

The Blueprints library opens in the **Create workflow** dialog box.

To open the library:

1. In Grafana Cloud, open the **Workflows** app.
2. Click **Create workflow**.

The **Create workflow** dialog box opens with the available blueprints. To build a workflow without a blueprint, click **Start from scratch** instead.

## Find the right blueprint

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

- **Category**: Select a category, for example, **Incidents** or **Alerts**.
- **Search**: Enter text in **Search by title** 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.

To browse the available blueprints, including what each one needs and its full YAML definition, refer to [Blueprints](https://grafana.com/docs/grafana-cloud/platform/workflows/reference/blueprints).

## Create a workflow from a blueprint

Select a card in the **Create workflow** dialog box.

The editor opens with the blueprint’s steps already filled in, in an unsaved workflow named “Blueprint: *BLUEPRINT\_TITLE*”. To rename it, click the workflow title. Workflows gives the workflow a random unique ID the first time you save it. 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, a Slack-based blueprint expects you to pick the channel, and an on-call blueprint expects you to set the IRM schedule name.

Blueprints that call an external API, such as Jira, GitHub, or the Grafana HTTP API, reference a workflow secret by name, for example, `grafana-api-token`. Create a secret with that name before you run the workflow. For details, refer to [Manage secrets](https://grafana.com/docs/grafana-cloud/platform/workflows/manage/secrets).

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 **Save**. If the workflow has no folder yet, choose one in the **Folder** drawer and click **Save**.
5. Turn on **Enable**, then click **Save** again.
6. Click **Run** in the editor header to test the workflow with a sample event. For details, refer to [Configure triggers](https://grafana.com/docs/grafana-cloud/platform/workflows/build/triggers/#trigger-workflows-manually).

After it’s saved and enabled, the workflow also runs automatically when its trigger conditions are met.

For details on the editor, refer to [Create workflows](https://grafana.com/docs/grafana-cloud/platform/workflows/build/editor).

## Next steps

- [Get started with Grafana Workflows](https://grafana.com/docs/grafana-cloud/platform/workflows/get-started)
- [Create workflows](https://grafana.com/docs/grafana-cloud/platform/workflows/build/editor)
- [Configure triggers](https://grafana.com/docs/grafana-cloud/platform/workflows/build/triggers)
- [Use CEL expressions](https://grafana.com/docs/grafana-cloud/platform/workflows/build/expressions)
- [Step and trigger types reference](https://grafana.com/docs/grafana-cloud/platform/workflows/reference/step-trigger-types)
- [Blueprints](https://grafana.com/docs/grafana-cloud/platform/workflows/reference/blueprints)
