Start Here
Browser compatibility
Supported browsers depend on your boilerplate suite. Open package.json and find the @dropins/tools line, then match it to a row below before you spend time on layout testing. That way you do not report a storefront bug for a browser this suite never supported.
Which boilerplate suite do I have?
Section titled “Which boilerplate suite do I have?”Match @dropins/tools in package.json to the corresponding suite below.
- March 2026 suite:
@dropins/tools@~1.8.0 - February 2026 suite:
@dropins/tools@~1.7.0 - January 2026 suite:
@dropins/tools@~1.6.0 - October 2025 suite:
@dropins/tools@~1.5.0 - August 2025 suite:
@dropins/tools@~1.4.0 - June 2025 suite:
@dropins/tools@1.3.0 - April 2025 suite:
@dropins/tools@0.42.0 - December 2024 suite:
@dropins/tools@0.38.0
Browser support by suite
Section titled “Browser support by suite”Desktop browsers
Section titled “Desktop browsers”| Browser | @dropins/tools ~1.5.0 and later (October 2025-March 2026 suites) | @dropins/tools ~1.4.0 and earlier (August 2025 suite and older) |
|---|---|---|
| Chrome | 105 - 141 | 98 - 136 |
| Edge | 105 - 141 | 98 - 136 |
| Safari | 16 - 18.4 | 16 - 18.4 |
| Firefox | 110 - 143 | 108 - 138 |
| Opera | 92 - 122 | 85 - 118 |
Mobile browsers
Section titled “Mobile browsers”| Platform | Browser | @dropins/tools ~1.5.0+ (Oct 2025-Mar 2026) | @dropins/tools ~1.4.0 and earlier |
|---|---|---|---|
| Android | Chrome | 141 | 136 |
| Android | Edge | 141 | 136 |
| Android | Firefox | 143 | 138 |
| Android | Samsung Internet | 28 | 26 |
| Android | UC Browser | Not Supported | Not Supported |
| iOS 16+ | Safari | Default supported version | Default supported version |
| iOS 16+ | Chrome | Default supported version | Default supported version |
Known issues
Section titled “Known issues”For the following browsers, the product listing page loads in a single product column and does not support responsiveness:
- Chrome: 100 - 104
- Firefox: 108 and 109
- Opera: 91 or less
Test URL
Section titled “Test URL”You can test browser compatibility using the Commerce boilerplate test site: https://www.aemshop.net/
Browser testing recommendations
Section titled “Browser testing recommendations”When you test your storefront, try the following:
- Run checks on the oldest supported version of each major browser you care about.
- Run checks on the newest version of each major browser.
- Test on real phones and tablets as well as desktop.
- Resize the window and confirm layouts still make sense at common widths.
- On product listing pages, confirm multi-column grids render as you expect.