Staged Preview Mode

Preview mode lets analysts and approvers view staged release data without impacting the production audience. Access is role-gated and governed by a short-lived cookie.

At a glance

Who can use it?

Users with the runner_analyst or runner_admin role on the active account.

Developing locally? Runuv run python scripts/python/grant_runner_preview_role.py --email you@example.comto grant yourself preview access (details in the README).

Current environment

You're viewing the app in Development. Preview mode is most impactful in production; staging mirrors staged data by default.

How it works
  1. Use the “Staged preview” switch in the Loomrunner header to toggle staged data.
  2. The server sets X-DLR-Staged-Preview: 1 on responses when preview is active.
  3. Resolver logic points to staged release artifacts; when preview is Off, it returns the active production release.

Environment behaviour

  • Production: Toggle + preview role shows staged releases. Great for stakeholder review.
  • Staging: Data is already staged; the banner simply indicates your cookie status.
  • Development: Acts as an indicator; data resolves to local resources.
Limitations & tips
  • Preview mode is per-user and cookie-based; clear cookies to reset.
  • Resolver results are cached briefly (~60s). Wait a moment or refresh the page after toggling or publishing a release.
  • The toggle only changes what you read—it never publishes or activates a release.

Troubleshooting

  • Toggle greyed out? Confirm your account membership includes a preview-capable role or ask an admin to grant access.
  • Still seeing production data? Refresh after a minute to allow the resolver cache to invalidate.

Need a deeper dive? Visit the Loomrunner docs or reach out in #loomrunner-support.

Back to Loomrunner