Public preview Grafana Cloud
Last reviewed: November 9, 2026

Start from a blueprint

Note

Grafana Workflows is currently in public preview. 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.

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.

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.

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.

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.

Next steps