Browserslist

Start with the default configuration

You can pick a sound set of versions with the defaults query which is a shortcut for > 0.5%, last 2 versions, Firefox ESR, not dead. It matches recent versions of popular and supported browsers worldwide and includes Firefox Extended Support Release which is updated roughly annually.

The defaults query was thoroughly designed by the Browserslist community. It helps promote best practices and avoid common pitfalls.

Select browser versions with certain usage

You can pick versions that have more than or less than a certain size of the audience worldwide, in a region, or in a country. You can also use the visitor data of your own website.

Examples

• > 5% all versions with > 5% of the audience worldwide.
• >= 5% in US same as above but in the US.
• >= 5% in alt-AS same as above but in Asia.

Beware

• You may exclude the most recent versions of all browsers that have been just released. Please always add last … versions to include them back.
• You can exclude your global audience. Please be careful when narrowing the audience to a region or a country.
• You may include dead versions. Please consider adding not dead.

Select browser by Baseline

By Baseline.

Examples

• baseline widely available versions of Chrome, Edge, Firefox, and Safari supports the current Baseline Widely available set of features, which have been interoperable in those browsers for at least 30 months.
• baseline newly available recent versions of Chrome, Edge, Firefox, and Safari, which supports the current Baseline Newly available set of features, which are interoperable in those browsers today.
• baseline 2024 browser versions that are compatible with all features that were Baseline Newly available at the end of the specified year.
• baseline widely available with downstream includes browsers outside the core browser set that support the requested Baseline feature set based on their Chromium or Gecko version.

Beware

• Use Baseline Newly available with caution since it targets very recent browser versions.

Select recent browser versions

You can pick a few recent browser versions.

Examples

• last 2 versions last 2 versions of each browser.
• last 2 Chrome versions same as above but just Chrome.

Beware

• You might exclude older versions still used by a substantial audience. Please always add > … to include them back.
• You may pick dead browsers like Internet Explorer. Always use last … versions with not dead.

Select specific browser versions

You can pick browser versions or a version range of your choice.

Examples

• ChromeAndroid 103 mobile Chrome version 103.
• Firefox > 20 desktop Firefox versions newer than 20.
• iOS >= 13.2 mobile Safari version 13.2 and newer.
• not Firefox ESR removes specific version.

Beware

• Make sure that your audience uses specific versions (e.g., in a corporate setting) or that your application is not built to work with specific versions (e.g., it’s a bleeding-edge demo project). Please consider using last … versions or > … to include more versions.
• Note, that Opera Mini has special version all. not op_mini all is not a special query.

Select specific Node.js versions

You can pick Node.js versions or a version range of your choice. Useful if you know for sure the runtime configuration of your server-side code.

Examples

• node 10 latest 10.x.x Node.js version.
• node 10.4 latest 10.4.x Node.js version.
• node > 16 all Node.js versions newer than 16.0.0.
• last 2 node versions two latest Node.js releases.
• last 2 node major versions two last major-version Node.js releases.

Select browser versions that support a certain feature

You can pick browser versions that support features from the Can I Use database. See the  caniuse-lite repository for the full list of features.

Examples

• fully supports es6-module versions that fully support JavaScript modules via script tag.
• partially supports css-grid versions that fully or partially supports CSS Grid Layout.

Beware

• supports … is an alias for partially supports …, however as its naming is ambigious, prefer using partially supports to make your intent of including partially supported browsers clear.
• These queries rarely work well on their own. Please consider combining them with other queries.

Combine multiple queries into one

You can combine versions matched by multiple queries with or or ,; you can intersect them with and. You can also negate any query with not if it’s not the first one in your list.

Examples

• > 0.5%, last 2 versions combines > 0.5% with last 2 versions.
• > 0.5% or last 2 versions same as above.
• > 0.5% and last 2 versions intersects > 0.5% with last 2 versions.
• > 0.5% and not last 2 versions removes last 2 versions from > 0.5%.

Beware

• A query with not can't be the left-hand one in the list.
• A query with not is always joined to the left-hand one with and, even if or or , are used.

Exclude unmaintained browser versions

You can combine your queries with not dead to exclude dead browsers, i.e., browsers without official support or updates for more than 24 months. Right now these include IE 11, IE Mobile 11, BlackBerry 10, BlackBerry 7, Samsung 4, Opera Mobile 12.1, and all versions of Baidu.

Examples

• > 0.2% and not dead excludes dead versions from versions matched by > 0.2%.