Flow: Document workflows with notes

Published

This summary was written by ShopDigest AI from Shopify Changelog’s report. Read the full story ↗

Add a note to any workflow from the workflow editor's "More action" menu. Use it to describe what the workflow does, note any dependencies, list fields that need to be configured, and link to external documentation. A new person can open the workflow and immediately understand it, without digging through Slack threads or asking the person who built it. Notes are copied with the workflow when it's duplicated and persist when it's moved between stores. Anyone with edit access to a workflow can update the note. For more information, visit the documentation.

Overview

Flow workflows now support notes that can be added from the workflow editor's More action menu. Notes help document what a workflow does, its dependencies, required fields, and external documentation links. They are copied when a workflow is duplicated and persist when moved between stores, and anyone with edit access can update them.

Key Details

  • Add a note via the workflow editor's More action menu.
  • Use notes to describe purpose, dependencies, fields to configure, and link to docs.
  • Notes are copied with duplicated workflows and persist across store moves.
  • Anyone with edit access to a workflow can update its note.

About this story

Topics covered
Published
10 Mar 2026
Originally published at