Why it matters
- Content that moves while the page loads makes visitors lose their place in the text, or tap the wrong button.
- Cumulative Layout Shift (CLS) is one of the three Core Web Vitals, which Google's search ranking systems use.
- These are real visits, on real phones: what visitors actually saw move.
How to fix
- Give images and videos their
widthandheight, or anaspect-ratio, so the browser keeps their space before they load. - Keep room for what arrives later: banners, ads, embedded content and cookie notices.
- Do not insert content above what is already shown, unless the visitor asked for it.
- Web fonts that change the size of text move it:
font-display: optional, or a fallback font adjusted withsize-adjust, keeps it still.
How we detect
- With an API key, we ask the Chrome UX Report (CrUX) about the page's URL on phones: the last 28 days of visits in Chrome by users who share usage statistics and sync their browsing history. Chrome on iPhone, apps' web views and other browsers are not counted. When CrUX has no data for the URL, we ask about the whole site (its origin), and the finding says so.
- The rule fails when the 75th percentile of Cumulative Layout Shift is over 0.25: Google's limit for poor.
- Without a key, or when CrUX has no data for the page or its site, as for many sites with fewer visits, the rule does not apply. A page on a local or private address is never sent to Google.
- CrUX covers the last 28 days, so a fix shows in it gradually, over about four weeks.