How to get started
defaults if you're building a web application for
the global audience.
node 18 if you're building a Node.js application,
e.g., for server-side rendering.
Autoprefixer, Babel and many other tools will find target browsers automatically if you add the following to package.json:
"defaults and fully supports es6-module",
"maintained node versions"
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.
defaults query was thoroughly designed by the
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.
> 5%all versions with > 5% of the audience worldwide.
>= 5% in USsame as above but in the US.
>= 5% in alt-ASsame as above but in Asia.
- You may exclude the most recent versions of all browsers that have been just
released. Please always add
last … versionsto 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
deadversions. Please consider adding
> 5% in my statsversions with > 5% of usage within your own audience.
> 5% in circle-ci statsversions with > 5% of usage within the audience data from shareable configuration, available as custom stats.
cover 99.5%the smallest set of popular versions with collective usage over 99.5% of the audience worldwide.
cover 99.5% in CNsame as above but in China.
cover 99.5% in alt-EUsame as above but in Europe.
Select recent browser versions
You can pick a few recent browser versions.
last 2 versionslast 2 versions of each browser.
last 2 Chrome versionssame as above but just Chrome.
- You might exclude older versions still used by a substantial audience.
Please always add
> …to include them back.
- You may pick
deadbrowsers like Internet Explorer. Always use
last … versionswith
last 2 major versionsall minor and patch releases of the last 2 major versions.
last 2 Safari major versionssame as above but just Safari.
unreleased versionsalpha and beta versions.
unreleased Chrome versionssame as above but just Chrome.
since 2020-01-15versions released since Jan 15, 2020.
since 2020-01versions released since January 2020, inclusive.
since 2020versions released since 2020, inclusive.
last 3 yearssame as above if you run this query in 2022.
Select specific browser versions
You can pick browser versions or a version range of your choice.
ChromeAndroid 103mobile Chrome version 103.
Firefox > 20desktop Firefox versions newer than 20.
iOS >= 13.2mobile Safari version 13.2 and newer.
not Firefox ESRremoves specific version.
- 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 … versionsor
> …to include more versions.
- Note, that Opera Mini has special version
not op_mini allis 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.
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.
partially supports css-gridversions that fully or partially supports CSS Grid Layout.
Combine multiple queries into one
You can combine versions matched by multiple queries with
,; you can
intersect them with
and. You can also negate any query with
not if it's
not the first one in your list.
> 0.5%, last 2 versionscombines
last 2 versions.
> 0.5% or last 2 versionssame as above.
> 0.5% and last 2 versionsintersects
last 2 versions.
> 0.5% and not last 2 versionsremoves
last 2 versionsfrom
Exclude unmaintained browser versions
You can combine your queries with
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.
Browserslist helps you keep the right balance between browser compatibility and bundle size. With Browserslist, you will cover wider audience and have smaller bundle size.