What are Chrome flags?

Activate additional debugging tools, or try out new or experimental features.

Published on

Chrome flags are a way to activate browser features that are not available by default.

For example, Chrome wanted to allow users to try picture-in-picture video functionality, before rolling it out to everyone.

Chrome picture-in-picture allows users to keep watching a video from one tab, while working in another tab.

The feature was made available behind a flag, so any user to try it out and give feedback. The code and design were tested and polished based on the feedback, so now you can use picture-in-picture by default in Chrome—and it works really well.

Understand the risks

Most Chrome users will never need to use Chrome flags.

If you do set Chrome flags, you need to be careful. By activating or deactivating features, you could lose data or compromise your security or privacy—and features you toggle with a flag may stop working or be removed without notice.

If you're an enterprise IT admin, you should not use Chrome flags in production. You might want to take a look at enterprise policies instead.

...and proceed with caution

Having said all that, if you're a web developer who needs to try out new technology—or just a curious geek—then getting to know Chrome flags can be really worthwhile.

There are a large number of flags for many different types of features. Some flags affect the way Chrome looks or works, and some activate new functionality such as CSS features or JavaScript APIs. The availability of flags depends on which version of Chrome you're running.

Important

Make sure to test your site in Chrome Stable without any flags set: as the majority of your users will experience it.

There are two ways to set Chrome flags:

  • From the chrome://flags page.
  • By opening Chrome from the command line in a terminal.

chrome://flags

To set a flag from the chrome://flags page in Chrome, you need to find the flag, toggle the setting for the flag, then relaunch the browser. For example, to activate Chrome's heads-up display for performance metrics:

  1. Search for the feature.
    chrome://flags page with HUD flag set to default.

  2. Set the value to Enabled. chrome://flags page with HUD flag enabled.

  3. Relaunch Chrome. Once you've updated a flag, Chrome will prompt you to relaunch the browser..

Now you can use the heads-up display that shows technical information about web page performance.

Chrome page with heads-up display activated.

If you make changes to chrome://flags, all the flags you've changed are listed first on the page.

Command-line flags

If you're a web developer, you may want to set flags by opening Chrome from the command line in a terminal. You run the command to open Chrome, and add the flags you want to set. There are a lot more Chrome settings you can configure from the command line than what's available on the chrome://flags page.

For example, to run Chrome Canary from a terminal on a Mac, with the Topics API activated and epoch length set to 15 seconds, use the following command:

/Applications/Google\ Chrome\ Canary.app/Contents/MacOS/Google\ Chrome\ Canary
--enable-features=BrowsingTopics:time_period_per_epoch/15s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

That's just one example! There are hundreds of other flags for activating, deactivating and configuring less well-known features.

Beware of flag conflicts

It's possible that the flags you set could conflict with each other. In particular, the defaults for a chrome://flags setting might, in some cases, override your command line configurations. So—if the flags you set running Chrome from the command line don't work as expected, you should check your chrome://flags page.

Also be aware that chrome://flags might not show the flag settings you've used from the command line. Instead, take a look at chrome://version. From the Command Line section, you can check what flags are enabled in your browser.

chrome://version page in Chrome Canary, Command Line section highlighted.

This example matches the example above, that runs Chrome from the command line with flags.

Two other ways to try out experimental features

You can enable a range of experimental features that don't have their own flag, by toggling the chrome://flags#enable-experimental-web-platform-features flag. Documentation for new features will explain when this is an option.

In Chrome Beta you can try out featured experiments and give feedback, by toggling Experiment settings and relaunching the browser. Test experimental features in Chrome provides more detail.

Screenshot of Experiments UI in Chrome Beta, showing Tab scrolling options.

Which features get a flag?

Not all experimental features get their own Chrome flag:

  • Some features only become available when they ship in Chrome Canary, and can't be activated by a flag before that. This is quite rare.
  • For 'smaller' features that require no more than 1–2 quarters of work, experimental availability is provided by enabling the following flag:
    chrome://flags#enable-experimental-web-platform-features
    This activates multiple minor features.
  • Major features are made available for experimentation with flags specific to the feature, via chrome://flags or command line switches.

What about Chrome settings?

Chrome settings and Chrome flags serve different purposes.

Chrome flags enable the user to activate or deactivate experimental features, whereas the controls available from the chrome://settings page allow the user to customize their experience for features that are available by default.

What about origin trials?

Origin trials are a way for developers to test a new or experimental web platform feature at scale, and give feedback to the web standards community before the feature is made available to all users.

Features undergoing an origin trial are activated on all pages that provide a valid token for that trial. This allow website owners to activate an experimental feature for all their users, without requiring users to change browser settings or set flags. By comparison, Chrome flags allow individual users to activate or deactivate an experimental feature, on all websites they visit. Getting started with Chrome's origin trials provides more detail.

Find out more

Updated on Improve article

We serve cookies on this site to analyze traffic, remember your preferences, and optimize your experience.