Skip to main content

Documentation Index

Fetch the complete documentation index at: https://slatehq.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Workflow versioning lets you publish snapshots of your workflow configuration. Each time you publish, Slate saves an immutable copy of your workflow as a numbered version. Edit your draft freely — the live version keeps running until you publish again.

Key Concepts

ConceptDescription
DraftYour current editable workspace. Changes here do not affect live runs.
VersionAn immutable snapshot created when you publish. Versions are numbered sequentially (Version 1, Version 2, etc.).
Live versionThe version that runs when users execute the workflow. Marked with a green “Live” badge.
Version noteAn optional message you attach when publishing to describe what changed.

Publishing a Version

  1. Make your changes in the workflow builder.
  2. Click Publish in the top toolbar.
  3. Add an optional version note describing the changes.
  4. Confirm to publish.
Slate creates a new version, assigns the next version number, and sets the new version as live. The workflow status changes from “Draft” to “Published.”
Add version notes when publishing. They help teammates understand what changed when reviewing version history.

Viewing Version History

Click the version dropdown (clock icon) in the top toolbar to open the Version History panel. The panel shows:
  • Draft at the top, labeled “Editable”
  • All published versions listed newest-first
  • The live version marked with a green Live badge
  • Relative timestamps for each version (e.g., “5 minutes ago”)
  • A message icon next to versions that have a version note — hover to read the note
Click Load more at the bottom to see older versions.

Viewing a Past Version

Click any version in the Version History dropdown. The workflow builder switches to read-only mode and an amber banner appears at the top:
You are viewing Version X
If the selected version is the live version, the banner also shows “(Live)” in green. Click the X button in the banner or select Draft in the dropdown to return to editing.

Redrafting a Version

Redrafting copies a past version’s configuration into your current draft without changing the live version.
  1. Select a version from the Version History dropdown.
  2. Click Redraft this version in the amber banner.
Slate copies that version’s configuration into your draft. The builder unlocks and you can edit normally. The live version is unaffected.
Redrafting overwrites your current draft with the selected version’s configuration. Make sure you have published any draft changes you want to keep before redrafting.

Rolling Back and Rolling Forward

You can make any past version live without creating a new version.
  1. Select a version from the Version History dropdown.
  2. The amber banner shows one of two actions:
    • Rollback — if the selected version is older than the current live version
    • Roll forward — if the selected version is newer than the current live version
  3. Click the action button.
The selected version becomes the new live version immediately.

Typical Workflow

  1. Edit your workflow in the draft.
  2. Test with Test All to verify changes.
  3. Click Publish to save a version and make it live.
  4. If something goes wrong, open Version History and Rollback to a previous version.
  5. Use Redraft to bring an older configuration back into your draft for further editing.

What’s Next