v8.0.0

Unleash v8.0.0

If you self-host Unleash, review the v7 to v8 migration guide before you upgrade. No API endpoints were removed, but several deprecated schema properties have been.

Announcement: Unleash open source moves to AGPLv3

Starting with Unleash v8, the source code in the primary Unleash GitHub repository and the unleash-server npm package move from the Apache 2.0 license to the GNU Affero General Public License v3 (AGPLv3).

Most users are unaffected:

• Official open-source Docker images remain under Apache 2.0. Running a pre-built Unleash container without modifying the source is unaffected.
• Unleash SDKs keep their current permissive licenses, so your application code is unaffected.
• Unleash Enterprise and Unleash Cloud are unaffected. Your deployment, terms, and obligations are unchanged.

The change applies if you modify the Unleash source and make it available to users over a network, for example as a public or commercial SaaS. In that case, AGPLv3 requires you to make your modified source available under the same license, or to contact us for a commercial license. For the full reasoning and a use-case breakdown, see Evolving our open source commitment.

Automated release management now generally available

Release templates, impact metrics, safeguards, and milestone progression are now generally available.

Impact metrics are application-level time series, such as counters, gauges, and histograms for error rates, latency, and adoption. They can be recorded by Unleash SDKs or queried from an existing Prometheus or VictoriaMetrics instance. Safeguards let you set thresholds on those metrics that automatically pause a rollout or disable an environment when a metric crosses the limit. Milestone progression advances a release template to its next milestone when the metrics stay healthy for a configured interval, removing the need to step rollouts forward manually.

Remote MCP server now generally available

The remote Unleash MCP server is now generally available. It lets you connect MCP clients to a server hosted by your Unleash instance, without installing anything locally. Use it when developers cannot run MCP servers on their machines, or when you want to manage MCP access centrally.

Streaming between Unleash and Edge in beta

Unleash Edge can now receive flag updates from Unleash as a real-time stream instead of polling. Flag changes propagate to your Edge nodes, and to your applications, in milliseconds. Streaming is available on both managed and self-hosted Enterprise Edge.

Improved project onboarding

We've further improved the project onboarding experience. The project page now shows a three-step Project setup checklist that tracks creating a feature flag, connecting one or more SDKs, and sending flag evaluation metrics back to Unleash. On the flag page, a contextual banner points you to the next step based on your current setup state. SDK setup now also works for any SDK you add to a project, not only the first one.

Redesigned access overview

The access overview page is redesigned to give admins and individual users a clearer view of a user's instance and project access in one place.

New sunset flag type

We introduced a new sunset flag type to help you coordinate the planned removal of an existing feature. Use it to wrap a feature you plan to retire, so you can gradually disable it for selected user segments while monitoring the impact, and pause or re-enable the rollout if downstream issues surface.

Changelog

All notable changes to this project will be documented in this file.

[8.0.0] - 2026-06-09

Bug Fixes

• Invalid button nesting in segment accordion headers (#12167)

• Profile tab navigation with React Router v7_startTransition (#12205)

• Remove deprecated Google auth integration - EG-4389 (#12208)

• Remove json viewer (#12217)

• Only show impact metrics tip once flag setup is complete (#12240)

• Impact views minor visual improvements (#12238)

• Remove SDK registration and metrics environment field (#12224)

Documentation

• Update CHANGELOG.md

Features

• Add Sunset feature flag type (#12157)

• Goal-view types + goal summary (PR 2) (#12177)

• Goal summary panel (PR 3) (#12197)

• Add a new useMinimumUnleashVersion hook (#12172)

• Followed-features list + dummy goal view (#12200)

• Impact metrics for all setup options (#12201)

• Remove instance level impact metrics (#12203)

• Impact views data fetching (#12204)

• Add view switcher (#12214)

• Add roll out strategy banner + refactor flag setup banners (#12218)

• Setup form (#12229)

• Add support for logout event (#12226)

Miscellaneous Tasks

• Remove v5 deprecated admin strategies and variants fields (#12156)

• Clean up scim error handling, add a flag to disabling scim guard (#12198)

• Move flag details sidebar from the left to the right (#12165)

• Remove unused attributes and props in constraint accordion view. (#12168)

• Project onboarding steps shown simplification (#12202)

• Svelte snippet update (#12206)

• Replace feature page impace metrics empty state (#12209)

• Remove back button from signup screen (#12212)

• Remove old feature flag and introduce new inverted flag (#12185)

• Add a build check to see if unleash meets parity with edge api (#12183)

• Remove deltaDiff parity logic (#12216)

• Include CLA (#12213)

• Update PR template (#12219)

• Remove safeguards flag (#12207)

• Onboarding android snippet (#12189)

• Simper Vue code snippets (#12227)

• Add timing metric for old project list path (#12228)

• Redesign Connect SDK and Implement flag setup banners (#12225)

• Bump biome to 2.4.16 (#12233)

• Bump dependencies (#12234)

• Onboarding flutter snippet (#12236)

• Make environment_revision_id gauge register idempotent (#12239)

• Onboarding small fix in Java snippet (#12242)

• Gate flag-page impact metrics on useImpactMetricsEnabled (#12248)

• Set minimum postgres version to 15.0.0 (#12249)

• Onboarding .NET snippet style (#12250)

• Remove completed flightRecorder experimental flag wiring (#12252)

• Add new archiveInFlagsView flag to Unleash (#12257)

• Add new lifecycle options so that we can show archived (#12259)

Refactor

• Reuse ConnectionPulse component in connect SDK dialog (#12243)

v7.6.5-beta.2

7.6.5-beta.2

v7.6.5-beta.1

7.6.5-beta.1

v7.6.4

Changelog

All notable changes to this project will be documented in this file.

[7.6.4] - 2026-05-14

Bug Fixes

• Compact impact metrics chart formatting (#11830)

• Update copilot assigner

• Move to copolot for flag cleanup PRs

• Ai-cleanup trgger on issue created

• Consolidated release plan changes don't leave empty boxes (plus border fixing) (#11857)

• Internal imports (#11887)

• Address long usernames on Flag details view (#11885)

• Set the width of the 'Name' column to max on the Flags overview (#11884)

• Revision id calculation for segments (#11861)

• Address React warnings surfaced by frontend test run (#11897)

• Restore vite-tsconfig-paths for baseUrl resolution (#11917)

• Update dependency normalize-url to v9 (#11876)

• Set userWithId to deprecated strategies (#11896)

• Demo auth center alignment (#11931)

Documentation

• Update CHANGELOG.md

Features

• Sidebar content (#11828)

• Add implement flag banner on feature flag overview (#11833)

• Automatically infer multi chart setup (#11839)

• Check newly created metric is available in SuccessView (#11856)

• Wire implement flag dialog to live metrics (#11865)

• Add remote MCP menu in the admin section (#11869)

• Track flag setup banner clicks with plausible (#11871)

• Gate implement flag banner on lifecycle stage (#11886)

• Add remote MCP server settings updated event (#11889)

• Add external impact metrics source schemas and remote mcp setting schemas (#11929)

• Implement Remote MCP settings toggle calling actual backend api (#11909)

• Gate project onboarding behind onboardingProjectSetupNewSteps flag (#11932)

• Impact metrics admin ui stub (#11934)

Miscellaneous Tasks

• Update success screen and tracking for impact metric registration (#11829)

• Small success view fixes (#11835)

• Remove the success sidebar (#11836)

• Show toast on submit error (#11840)

• Let radio focus-visible indicator bloom (#11842)

• Make impossible states impossible ~ RegisterMetricDialog edition ~ (#11843)

• Don't highlight the radio label on use (#11841)

• Add action to assign copilot issues

• Add tracking to register impact metric flow (#11834)

• Add new success screen (#11845)

• Remove pendingUserAccessRequest flag (#11844)

• Add entry point to registerImpactMetric form_opened counter (#11858)

• Add register impact metric dialog tests (#11859)

• Clean up completed filterFavorites feature flag (#11852)

• Enforce naming conventions for metrics (#11864)

• Remove signupDialog feature flag (#11866)

• Add elasticEventSync feature flag (#11870)

• Add setting service composition root to exports (#11895)

• Update front end to vite 8 and related upgrades (#11766)

• Fix typo (#11915)

• Self service external impact metrics flag (#11918)

• New feature flag onboardingProjectSetupNewSteps (#11919)

• GetOnboardingStatusForProject add new onboarding status (#11921)

• Bump MUI to v6 + migrate to Grid v2 (#11899)

• Lint new files by default with useExhaustiveDependencies (#11933)

• Update vite-node and vitest to bump vite version (#11930)

Refactor

• Extract shared Card and ExternalLink styles for register metric dialog (#11837)

• Move settings to feature oriented structure (#11893)

• Setting service composition root (#11894)

Testing

• Cover implement flag banner happy-path render (#11888)

v7.6.3

Changelog

All notable changes to this project will be documented in this file.

[7.6.3] - 2026-04-15

Documentation

• Update CHANGELOG.md

Features

• Setup ff for multimetric (#11825)

Miscellaneous Tasks

• Make helper text and label red if your input is invalid (#11823)

• Update text to point out we're using node 22, not 20 (#11824)

• Run apk upgrade (#11826)

v7.6.2

Changelog

All notable changes to this project will be documented in this file.

[7.6.2] - 2026-04-15

Bug Fixes

• Move clicked docs funnel event from sidebar to MetricSelector (#11773)

• Stringify on null in crs (#11786)

• Stringify on null in crs (#11790)

• Duplicate handling impact metric options (#11796)

• Update dependency tldts to v7.0.28 (#11802)

Documentation

• Update CHANGELOG.md

Features

• Reinitialize delta on malformed/unexpected events (#11767)

• Wire access request rejection to backend (#11783)

• Group internal and external impact metrics (#11785)

• Smarter orphan metrics (#11794)

• Use the newer json diff instead of the old, manual diff table for overwrite warnings. (#11797)

• Add connect SDK banner on feature flag overview (#11806)

• Avoid fetching labels for display mode (#11812)

Miscellaneous Tasks

• Update orval (#11779)

• Upgrade axios (#11793)

• Don't diff sort order for strategies (#11798)

• Add registerImpactMetrics feature flag (#11809)

• Remove newLogin flag and keep new login UI (#11810)

• Remove newSignOut flag (#11807)

• Remove read-only-users-ui flag (#11814)

• ExternalPrometheusImpactMetrics flag cleanup (#11819)

• Add useRegisterImpactMetricApi hook (#11817)

• FeatureEnvSafeguards flag cleanup (#11821)

• Initial version of impact metric registration form (#11813)

• Upgrade zlib in Dockerfile (#11822)

Refactor

• Extract safeguards outside release plans (#11780)

• Impact metrics metadata returns list of options (#11795)

• Use orval impact metrics schema (#11808)

• Use metric name instead of series (#11811)

Testing

• Impact metrics modal (#11784)

v7.6.1

Changelog

All notable changes to this project will be documented in this file.

[7.6.1] - 2026-04-09

Documentation

• Update CHANGELOG.md

Miscellaneous Tasks

• Stable npm version (#11772)

v7.6.0

Changelog

Project-level context fields

Context fields can now be defined at a per-project level. To create one, open a project and go to Settings > Context fields. Once you define project-level context fields, they are available in strategy configuration and the playground for users with access to that project, but are not included in the global context fields overview.

Edit strategies in applied release plans

You can now edit activation strategies in a release plan after the release template is applied to a feature flag. You can edit the configuration, constraints, variants, rollout percentage, or set the status to Inactive, just as you would with any standalone strategy.

[7.6.0] - 2026-04-09

Bug Fixes

• Add missing createdAt field to store insert (#11533)

• Ensure failOnStatusCode is set to false for delete feature and project API requests

• Validate flag name on blur if not empty (#11545)

• Use API-provided totals for estimate invoice amounts (#11561)

• Don't delete release plans when env is disabled (#11589)

• OSS 404 Go home and remove unused cypress login tests (#11500)

• Update dependency tldts to v7.0.25 (#11609)

• Memory_usage for edge must be a long (#11616)

• Clone ssl db config to avoid mutation (#11619)

• Date-fns v4 compatibility — adapter, peer deps, and minimal test fixes (#11592)

• Delta when empty state should return 200 OK (#11634)

• Limit frontend token html-rewrite plugin to dev mode only (#11661)

• Make streaming/delta API produce stable segment ids (#11669)

• Stable segment ids on polling api (#11670)

• Use formatAssetPath for auth screen images (#11671)

• Support dark mode logo on login screen (#11672)

• Exclude chartjs-adapter-date-fns from Vite dep optimization (#11687)

• Do not propagate unrelated changes to other envs (#11660)

• Use dynamic trialExpiry date in Billing test (#11722)

• Bring back tooltips for group ids in release template and project default strategy forms (#11754)

• Handle missing data (#11756)

• Put skip link on top and before banners (#11751)

Chore

• Use consolidated strategy form for default strategy (#11576)

Documentation

• Synchronize Node.js and PostgreSQL version requirements across … (#11689)

• Update CHANGELOG.md

Features

• Adding feature env safeguards to schema (#11529)

• Add visible revision per token (#11488)

• Display feature env safeguards (#11562)

• UI part (#11560)

• Inline Favorites in Feature Lists (#11526)

• Feature env safeguards change request (#11582)

• Add new login form behind feature flag (#11598)

• Human display name fo safeguard impact metric (#11617)

• Display multiple safeguards (#11618)

• New login screen (#11608)

• Keep safeguards on env disconnect (#11626)

• Flag-gated PasswordAuth and SecondaryLoginActions (#11629)

• Support UNLEASH_FRONTEND_TOKEN env var for local dev (#11631)

• Support impact metrics in frontend API (#11633)

• Feature env safeguard diffing (#11647)

• Plausible safegaurds tracking (#11650)

• Add new forgotten password page with updated styling (#11636)

• Add new reset password page with updated styling (#11663)

• Add password reset success page (#11666)

• Update forgotten password confirmation screen (#11667)

• Add signed out screen with snake game (#11668)

• Add defaultExpanded and renderStrategy props to ReleasePlanMilestone (#11639)

• Consolidate updateMilestoneStrategy into release plan change view (#11640)

• Align SSO button styling with new sign-in design (#11683)

• Double metric translation (#11684)

• Unprefixed impact metrics UI (#11702)

• Store either plain or prefixed metrics (#11709)

• Hide metric type labels (#11710)

• Make safeguard form lazy (#11714)

• Expose impact metrics query time metrics (#11721)

• Add impact metrics funnel tracking via SDK histogram (#11717)

• Improve metric type detection (#11725)

• New http error type for gateway timeouts (#11726)

• New http error type for bad gateway (#11727)

• Safeguards when no environment available in metrics (#11731)

• Improved safegaurd impact metrics filtering (#11733)

• Display impact metric name even when it is gone (#11744)

• Add access requests table to admin users page (#11745)

• Connect access requests table to backend API (#11748)

• External prometheus support (#11747)

• Finish delta by env leftovers (#11746)

• Connect approve access request UI to backend (#11758)

Miscellaneous Tasks

• Don't start signup dialog pre-filled (#11521)

• Fix bug where we track signup-dialog even if dialog is not shown (#11525)

• Fix deprecation notices (#11527)

• Add plural release plan template schema (#11532)

• Update e2e scripts to use electron browser

• Making cypress tests a little faster and documenting speed tradeoffs (#11502)

• Make enterprise edge tokens invisible for users. (#11520)

• Improve tracking in signup dialog (#11542)

• Include segments in milestone strategy store get() (#11528)

• Clean up datePickerRangeConstraints flag (#11346)

• Update workflow to use native runners and dockerbake (#11535)

• Provide an alternative to conditional middleware (#11523)

• Add trial upsell component and tests for billing page (#11531)

• Deprecate strategyName outside of stores. (#11559)

• Enable video recording for failed Cypress tests ([#11538](https://gi...

v7.5.1

Changelog

All notable changes to this project will be documented in this file.

[7.5.1] - 2026-03-10

Bug Fixes

• Add project validation for getEnvironmentInfo method (#11472)

• Regex operator UX feedback (#11478)

• Decouple project environment strategy draggable item from required featureid in path (#11481)

• Search user shema should point to the right schema (#11494)

• Make key concepts dialog background blurry (#11508)

• Refresh SWR cache for feature-specific pending CR (#11501)

Chore

• Return ReleasePlanMilestoneStrategy instead of MilestoneStrategyConfig from update methods (#11517)

Documentation

• Update CHANGELOG.md

Features

• Introduce revision id per project for delta/streaming (#11434)

• Redesign impact metrics chart config modal (#11462)

• Gate impact metrics to enterprise and link charts to feature metrics (#11474)

• Feature exists in project method in read model (#11479)

• Persist impact metrics accordion state in localStorage (#11477)

• Enable "edit change" item in cr item for milestone strategies (#11485)

• Create/delete feature env safeguards UI (#11510)

Miscellaneous Tasks

• ReadOnlyUsers flag cleanup (#11459)

• Fix 'cannot read content from undefined' in signup flow (#11463)

• Make milestone strats editable (#11431)

• Regex feature SDK warning (#11461)

• Unleash-client 6.10.0 (#11466)

• Add disabled field to milestone strategy stores and types (#11454)

• Fix e2e tests after latest changes related to welcome dialog (#11470)

• Include disabled when getting active feature strategies (#11471)

• Default-disable userTokenWithClientApiLogging (#11464)

• Welcome dialog not showing on 'view key concepts' (#11480)

• Enable the exact same change components as normal update strategies (#11486)

• Handle invalid regex from DB (#11483)

• Regex should never not be inverted (#11484)

• Allow project env strategy draggable item to be marked as read-only (#11482)

• Show Modified in draft badge for updateMilestoneStrategy CR (#11487)

• Remove duplicated updateMilestoneStrategy from CR types (#11465)

• Remove NODE_OPTIONS (#11489)

• Running e2e:oss (#11493)

• Update dependencies. (#11490)

• Exclude signup dialog from special scenarios (#11496)

• Signup dialog redesign (#11504)

• Add plausible tracking to signup dialog (#11512)

• Deprecate strategy name on ifeaturestrategy (#11475)

• Don't crop template form name (#11516)

• Remove table row hover on Instance Stats (#11518)

• Regenerate yarn lock and fix compilation issues (#11519)

Refactor

• Fix lint useExhaustiveDependencies for FeatureStrategyConstraints (#11450)

• Move safeguard to feature env level (#11491)

• Extract hooks in release plan safeguard (#11498)

• Stable callbacks in ConstraintsList (#11469)

Testing

• Release plan safeguard (#11497)

• Replace cypress feature name test with frontend test (#11503)

v7.5.0

Changelog

User groups with root roles can now be assigned to projects

Previously, groups with a root role could not be added to projects in the Admin UI. This restriction has been removed. You can now add any group to a project regardless of whether it has a root role. This is especially useful for teams that sync groups from SSO providers, as it removes the need to maintain separate groups for root-level and project-level access.

API access URLs for Edge

You can now copy the Edge URLs directly from Admin settings > Access control > API access. For hosted customers, this works automatically. If you are self-hosting, you can configure the EDGE_URL environment variable on startup to ensure the right endpoints are visible in the UI.

Fixed scoping for private project data

We fixed how private projects scope visibility within your organization. Previously, users who weren't added to a private project could still see some of its metadata, like segments, in global views. Affected views and endpoints now correctly return 404.

Announcement: Automated release management and Unleash MCP in beta

Two new capabilities are now available in beta.

Impact Metrics are lightweight, application-level time-series metrics you can track and visualize right inside Unleash. Counters, gauges, and histograms for things like error rates, latency, and adoption feed directly into release templates, so Unleash can automatically progress a rollout when signals are healthy or pause it when something spikes.

Impact Metrics are currently enabled for select customers. If you’d like to enable it for your organization, reach out at beta@getunleash.io.

We’ve also launched the Unleash MCP server in beta. This gives your AI coding assistants a structured contract for managing feature flags safely. It plugs into tools like Claude Code, Cursor, Windsurf, and Codex, and guides them through evaluating risk, creating flags, wrapping code, and cleaning up after rollout.

[7.5.0] - 2026-03-04

Bug Fixes

• Show longer legal values (#11384)

• Welcome dialog behavior (#11432)

• New regex test fields should be validated (#11449)

• Open regex editing when value resets (#11453)

Documentation

• Update CHANGELOG.md

Features

• Block inverted regex on backend (#11426)

• Register impactMetricsFlagPage internal feature flag (#11437)

• RE2 Regex tester (#11399)

• Add impact metrics UI on flag page

• Add updateMilestoneStrategy support in CR flow (#11425)

• Wire up impact metrics flag page actions (#11445)

Miscellaneous Tasks

• Add link to new demo walkthrough (#11422)

• Fix dialog order and other zindex problems (#11424)

• Allow project access assignment to groups with root roles (#11423)

• Add ui-flag for edge instance token-statuses (#11420)

• Add milestone strategy not found guard (#11415)

• Fix OpenAPI diff workflow (#11430)

• Move legacy components into own files (#11421)

• Remove privateProjectMiddlewareMove flag (#11429)

• Check useExhaustiveDependencies in files that pass it (#11436)

• Remove obsolete CI strictNullChecks (#11435)

• Update list of company roles (#11441)

• Feature env safeguards flag (#11444)

• Disable inverted on REGEX operator on frontend (#11443)

• Add migration for new disabled column in milestone_strategies (#11446)

• Add disabled to releasePlanMilestoneStrategySchema (#11447)

• Use fromUpdateRow in milestone strategy store updateStrategy (#11451)

• Log when usertoken used with client api (#11442)

Refactor

• Introduce shared strategy form for milestones and strategies (#11410)

• Widget -> chip in FeatureStratetyContraints (#11440)

• UseExhaustiveDependencies lint in EditableConstraint (#11448)