How-to
3 min read

Using Feature Flags in the Vercel Toolbar

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

Feature flags are available in Beta on all plans

Using the Vercel Toolbar, you can view, override, and share feature flags for your application without leaving your browser tab. The feature flags available are all the flags that your team has set up through supporting feature flags.

Any team member can access the feature flags dialog once they have authenticated with the toolbar. Feature flags are available in all environments that your team has enabled the toolbar for.

Feature flags modal.
Feature flags modal.

Before you can use with feature flags in the Vercel Toolbar, 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 Feature Flags option () from the Vercel Toolbar.
  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 purple

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.

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 June 21, 2024