Skip to content

[Drift] New optional sync_config.version_label field lets operators tag deployed sync config versions (powersync-service #756) #598

Description

@benitav

What's changing: PowerSync Service adds an optional version_label field to the sync_config section of the main config YAML. When set, the label is persisted alongside the deployed sync config and surfaced in log output and diagnostics, primarily to help automated deployment tooling (e.g. the PowerSync Cloud dashboard) distinguish between sync config versions when a single replication stream handles multiple configs. It can also be set manually, though nothing enforces that it stays updated or unique.

High priority — existing docs are now inaccurate or incomplete
None identified.

For reviewer consideration — worth documenting

  • New optional sync_config.version_label config field. Self-Hosted Instance Configuration (configuration/powersync-service/self-hosted-instances.mdxhttps://docs.powersync.com/configuration/powersync-service/self-hosted-instances), "Sync Streams" section, documents the sync_config: key's path and content options but does not mention version_label. Self-hosted operators using automated deployment tooling have no way to discover this option from docs.

Source PR: powersync-ja/powersync-service#756. Merged 2026-08-26.

Filed automatically by Claude Code (claude-sonnet-5). A human must verify the scope, prepare the docs PR, and publish it only once this update has been released.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions