2 min read

Layout Shift Tool

The layout shift tool gives you insight into any elements that may cause layout shifts on the page.
Table of Contents

Layout Shift Tool is available on all plans

The layout shift tool gives you insight into any elements that may cause layout shifts on the page. The cause for a layout shift could be many things:

  • Elements that change in height or width
  • Custom font loading
  • Media embeds (images, iframes, videos, etc.) that do not have set dimensions
  • Dynamic content that's injected at runtime
  • Animations that affect layout

Layout shifts play a part in Core Web Vitals and contribute to Speed Insights scores. With the layout shift tool, you can see which elements are contributing to a layout shift and by how much.

To access the layout shift tool:

  1. Open the Command Menu
  2. Select the Layout Shifts option. If there are layout shifts detected on the page, a badge will display next to the option. The number inside the badge details the number of shifts detected
  3. The Layout Shifts popover will open on the right side of the screen. Here you can filter, inspect, and replay any detected layout shifts

Each shift details its impact, the responsible element, and a description of the shift if available. For example, "became taller when its text changed and shifted another element". Hovering over a layout shift will highlight the affected element. You can also replay layout shifts to get a better understanding of what's happening.

You can replay a layout shift by either:

  • Double-clicking it
  • Selecting it and using the Replay selected shift button

You can also select more than one shift and play them at the same time. You may want to do this to see the combined effect of element shifts on the page.

When you replay layout shifts, the Vercel Toolbar will become your stop button. Press this to stop replaying layout shifts. Alternatively, press the  esc key.

You can also disable layout shift detection on a per element basis. You can do this by adding a data-allow-shifts attribute to an element. This will affect the element and its descendants.

To disable the layout shift tool completely:

  1. Open the Command Menu
  2. Select Preferences
  3. Toggle the setting for Layout Shift Detection
Last updated on June 15, 2024