Skip to content

Restore a previous workflow version from its history #7266

Description

@nastasha-solomon

Summary

Workflows now support one-click restore from version history: opening a workflow's History view and selecting a prior snapshot creates a new committed version based on that snapshot (history itself stays append-only; no prior version is overwritten). Managed workflows cannot be restored (rejected with a 403), and the feature is gated behind the workflows:versioning:enabled setting, which is off by default and set via uiSettings.globalOverrides in kibana.yml.

Why this needs docs: Workflow version/change history and restore are entirely undocumented today — the 'Manage and organize workflows' page lists only create/search/run/edit/enable actions with no history or versioning action, and the workflows:versioning:enabled setting does not appear in the Kibana advanced settings reference at all, so this is a genuine gap rather than an update to existing restore documentation; confidence is moderated because the feature's exact maturity label (preview vs. GA) isn't established in any prior doc and should be confirmed with the Workflows team before publishing.

Resources

  • PR #275175 — [One Workflow] Restore versions

Availability

Channel Details
Stack v9.5.0
Serverless Jul 6–Jul 10
Feature status preview
Feature flag None — active by default

Created with Docs Quest Scanner by @nastasha-solomon

Suggested edits

Manage and organize workflows > Available actions

  • What the docs say: From the Workflows page, you can create, edit, duplicate, delete, and more with your workflows. ... ### Edit a workflow ... ### Turn a workflow on or off
  • What to add: Add a new subsection (parallel to 'Edit a workflow' and 'Turn a workflow on or off') describing how to open a workflow's History from the workflow detail view — a paginated timeline of changes — select a prior version, and restore it, which creates a new committed version referencing the source snapshot rather than overwriting history. Note that managed workflows cannot be restored. Applies from 9.5.0 (technical preview, requires enabling workflows:versioning:enabled via uiSettings.globalOverrides in kibana.yml) and in serverless.

Kibana advanced settings > Settings definitions (alongside workflows:ui:enabled)

  • What the docs say: Lists workflows:ui:enabled ('Enables Elastic Workflows and related experiences,' preview since 9.3) but has no entry for workflows:versioning:enabled.
  • What to add: Add a definition entry for workflows:versioning:enabled describing that it gates version history and restore for workflows, is off by default, and is set as a global override rather than through the Advanced Settings UI. Applies from 9.5.0 (technical preview) and in serverless.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Team:SKIIssues owned by the SKI Docs Team

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions