Workflows

Automate content generation across your repository with AI-powered workflows.

Example of a workflow that narrates a changelog post.

You can trigger automated content updates with contextual prompts to let the AI agent know what to do when the workflow runs.

Trigger

Use the "A block changes" trigger to run a workflow whenever a selected block is updated.

Action

There are two types of actions your workflow can perform:

AI Autofill: Automatically generate or update a block’s content.
Apply Variant: Apply a predefined variant to a block.

Get started

To get started, go anywhere in your Editor and add a new Workflow Block typing: /workflow

How to configure

Prerequisites1

You’ll need:

At least one existing block to act as a trigger.
A target block where the generated content will go.

Set the Trigger Type2

In your workflow block, set the trigger to: A block changes

Select Trigger blocks3

Choose the blocks that will activate the workflow when they change.

You’ll configure two selectors:

One for the layout block.
Another for the child blocks that will act as triggers.

info:

Important: If you select a component, the trigger will also apply to all of its instances. This means you can set up a trigger in a list template and have the workflow generate content across all rows in that list.

Define the Action4

Choose the action type: AI Autofill / Apply Variant

Then select the target block where the generated content will be applied. The target block can only be a child of the selected layout block.

Leave instructions for START5

Prompt your AI agent with directives, and let them know if you want the content to be applied:

As draft changes.
In a content suggestion.
In a new commit.

Monitor Workflow Runs6

When a workflow is triggered, the target block will show a badge with the status in its label.

You can also track real-time workflow activity in the Runs section of the workflow block’s properties panel. Here, you can:

See the current status
Prevent, cancel, or retry workflow generations