Free cheat sheet

Cross-Browser CSS Compatibility Cheat Sheet

The 25 CSS issues that come up most in ecommerce themes across Chromium, Firefox and Safari, each with the fix.

Where ThemeSync fits

Free. No email required. Use your browser’s print dialog and choose “Save as PDF”.

Sticky header with and without the webkit prefix on iPhone
Cheat Sheet

Cross-Browser CSS Compatibility

The 25 most common CSS issues in ecommerce themes across Chromium, Firefox, and Safari — with the fix for each. Pin this to your monitor.

Sticky header with and without the webkit prefix on iPhone

By ThemeSync · themesync.dev · 2026

Flexbox Issues

1. Flexbox gap not supportedHigh
Affected: Safari < 14.1, iOS Safari < 14.5

gap in flexbox wasn't supported until Safari 14.1. Older devices show elements crammed together.

Fix: Use margin fallback: .flex-container > * + * { margin-left: 16px; } with @supports (gap: 1px) { ... }
2. flex-basis percentage + paddingMed
Affected: Older Safari, some Firefox

flex-basis: 33.33% with padding causes overflow because box-sizing isn't consistently applied to flex-basis.

Fix: Use box-sizing: border-box globally. Or use width instead of flex-basis for percentage columns.
3. min-height + flex column alignmentMed
Affected: Safari (older WebKit)

min-height on a flex column container doesn't work with align-items: center for vertical centering in older Safari.

Fix: Use height instead of min-height, or add an inner wrapper with display: flex; align-items: center;
4. flex-wrap + align-content edge caseLow
Affected: Rare Firefox edge cases

align-content: space-between on a wrapping flex container distributes differently with only one row.

Fix: Default to align-content: flex-start and apply space-between only when multiple rows are expected.

CSS Grid Issues

5. Grid auto-placement differencesMed
Affected: Firefox vs Chrome vs Safari

Complex grids mixing explicit/implicit tracks with grid-auto-flow: dense place items differently across engines.

Fix: Avoid dense for critical layouts. Use explicit placement (grid-column, grid-row) for important elements.
6. subgrid supportMed
Affected: Chrome < 117, Safari < 16

grid-template-columns: subgrid only recently gained support across all engines.

Fix: Use @supports (grid-template-columns: subgrid) { ... } with a non-subgrid fallback.
7. Grid percentage heightsLow
Affected: Safari

Percentage heights inside grid items resolve differently in Safari when the container has no explicit height.

Fix: Give the grid container an explicit min-height or use fr units instead of percentages.

Visual Effects & Filters

8. backdrop-filter requires -webkit- prefixHigh
Affected: Safari (all versions)

backdrop-filter: blur() needs the prefix. Without it, frosted-glass headers/modals are fully transparent.

Fix: Always include both: -webkit-backdrop-filter: blur(12px); backdrop-filter: blur(12px);
9. Stacking context with mix-blend-modeMed
Affected: Safari

mix-blend-mode creates a new stacking context in Safari but not always in Chrome.

Fix: Add isolation: isolate on the parent container for consistent stacking.
10. Filter blur edge artifactsLow
Affected: Firefox

filter: blur() on images shows pixelated edges in Firefox.

Fix: Wrap in container with overflow: hidden and scale image to 102% to hide edge artifacts.
11. clip-path anti-aliasingLow
Affected: Safari

clip-path: polygon() shows jagged edges in Safari.

Fix: Use SVG clip paths for complex shapes (better cross-browser anti-aliasing).

Scroll & Position

12. position: sticky in overflow containersHigh
Affected: All browsers (spec behavior)

position: sticky breaks when any ancestor has overflow: hidden/auto/scroll. Extremely common in Shopify themes.

Fix: Remove overflow from all ancestors of the sticky element. Restructure DOM if overflow is needed for other purposes.
13. scroll-behavior: smooth timingLow
Affected: Safari (different easing)

Safari's smooth scrolling feels "stickier" and slower than Chrome's implementation.

Fix: Use JS-based smooth scrolling for consistent feel, or accept native browser behavior.
14. overscroll-behavior unsupportedMed
Affected: Safari < 16

overscroll-behavior: contain wasn't supported in older Safari. Scroll chaining in modals leaks to the body.

Fix: Use position: fixed on body when modal is open. Or use touch-action: none on the overlay backdrop.
15. 100vh on iOS SafariHigh
Affected: iOS Safari

100vh includes address bar height on iOS, cutting off hero sections.

Fix: Use height: 100vh; height: 100dvh; (dynamic viewport) or -webkit-fill-available.

Typography

16. Font weight rendering differencesMed
Affected: Safari vs Chrome

Same font-weight: 600 appears thicker in Safari due to different anti-aliasing.

Fix: -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale;
17. Variable font axis renderingLow
Affected: Firefox (custom axes)

Custom variable font axes may not render in Firefox if font-variation-settings syntax is wrong.

Fix: Use standard properties (font-weight, font-stretch) when possible. Reserve font-variation-settings for custom axes only.
18. text-decoration-thicknessLow
Affected: Older Safari

text-decoration-thickness and text-underline-offset aren't supported in older Safari.

Fix: Use border-bottom for critical decorative underlines as a cross-browser fallback.

Media & Images

19. Video autoplay restrictionsHigh
Affected: Safari, iOS Safari

Safari requires muted AND playsinline for autoplay. Without both, hero videos show blank.

Fix: <video autoplay muted playsinline loop> — always include all attributes. Add poster image as fallback.
20. object-fit in flex containersMed
Affected: Older Safari

object-fit: cover behaves unexpectedly when image has no explicit width/height attributes.

Fix: Set width/height attributes on <img> tags, then override with CSS.
21. aspect-ratio propertyMed
Affected: Safari < 15

aspect-ratio wasn't supported until Safari 15. Product cards relying on it collapse.

Fix: Padding-bottom hack as fallback: .box { position: relative; padding-bottom: 100%; } with @supports (aspect-ratio: 1) { ... }

Forms & Inputs

22. Native input styling overrideMed
Affected: Safari

Safari applies heavy native styling to selects, date inputs, and buttons that overrides CSS.

Fix: -webkit-appearance: none; appearance: none; then style from scratch.
23. :focus-visible behaviorLow
Affected: Safari (inconsistent)

:focus-visible triggers differently — Safari shows focus rings more conservatively.

Fix: Define both :focus and :focus-visible. Use :focus:not(:focus-visible) to suppress mouse-click rings.
24. Auto-zoom on mobile inputsHigh
Affected: iOS Safari

iOS auto-zooms when focusing inputs with font-size < 16px. Causes layout shift.

Fix: Set font-size: 16px minimum on all input, select, and textarea elements.
25. Scrollbar styling syntaxLow
Affected: Firefox (different API)

Chrome uses ::-webkit-scrollbar. Firefox uses scrollbar-width and scrollbar-color.

Fix: Include both: scrollbar-width: thin; scrollbar-color: #888 transparent; AND ::-webkit-scrollbar { width: 6px; }
In ThemeSync

Where ThemeSync fits

The cheat sheet gives you the fix. ThemeSync helps with the two steps around it: finding where an issue is in the theme, and checking the fix in each browser. Screens are from a demo store.

ThemeSync code scan with findings on a Dawn-based theme
Finding the issueThe code scan checks the theme source for cross-browser compatibility issues and lists each one with file, line, severity and a recommended fix.
QA screenshots of the SŌMA homepage and product page across devices
Checking the fixAfter the fix, rescan the page in Chromium, Firefox, WebKit and real iPhone Safari and compare the captures side by side.