How-to

Flags Explorer

View and override your application's feature flags from the Vercel Toolbar
Table of Contents

Feature flags are available in Beta on all plans

The Flags Explorer is a feature of the Vercel Toolbar that allows you to view and override your application's feature flags without leaving your browser tab. You can also share and recommend overrides to team members. Follow the Quickstart to make the Flags Explorer aware of your application's feature flags.

Quickly override feature flags for your current session without signing into your feature flag provider, and without affecting team members or automated tests using the Flags Explorer.

Team members can access the Flags Explorer once they have activated the toolbar. The Flags Explorer is available in all environments your team has enabled the toolbar for.

Flags Explorer
Flags Explorer

Before you can use with the Flags Explorer, ensure that your team has set up both feature flags and the Vercel Toolbar in the environment you are using,

To see and override feature flags for your application:

  1. You must log into the Vercel Toolbar to interact with your application's feature flag overrides.
  2. Select the Flags Explorer option () from the Vercel Toolbar menu.
  3. Find the desired feature flag in the modal by scrolling or using the search and filter controls.
  4. Select an override value for the desired feature flag. Note that by default, overrides are not persisted and only affect the user applying them, in the environment in which they were set. To share overrides, see Sharing flag overrides.
  5. Apply the changes. This will trigger a soft reload. If you have applied changes, the Vercel Toolbar will turn blue.

Any overrides you apply from Vercel Toolbar usually apply to your browser session only. However, you can recommend overrides to team members by either:

This workflow is great when you start working on a new feature in a branch, as the recommended overrides will travel with the branch from local development through to the preview deployment.

  1. First configure the overrides you would like to share as usual
  2. Then, instead of selecting Apply, select the chevron next to the Apply button to reveal further options
  3. Choose Apply and save overrides as recommendation to recommend these overrides to any team member visiting your branch locally or on a preview deployment

When a team member visits that branch they will get a notification suggesting to apply the overrides you recommended. Notifications are displayed on all preview deployments, but not on your production deployment.

This workflow is great when you want to share once-off overrides with team members to reproduce a bug under certain conditions or to share a new feature.

  1. First configure the overrides you would like to share as usual
  2. Then, instead of selecting Apply, select the chevron next to the Apply button to reveal further options
  3. Choose Apply and copy link with overrides to copy a link to the page you are on, along with a query parameter containing your overrides.

You can send this link to team members. When they visit the link they will get a notification suggesting to apply the overrides you shared.

Last updated on September 27, 2024