Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Testing at zoom levels

Why a design must work at 200% browser zoom, what zoom does to the viewport, how to simulate it at 960 px with device scale 2, what usually breaks, and how the media design fixed its zoom problems.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/designers/theme-design/testing-at-zoom-levels.md

On this page

Testing at zoom levels

This page is for designers who test a design. Many visitors read with browser zoom; some at 200% all the time. The page answers: what zoom does, how to test it quickly, and what usually breaks.

Contents

  1. What zoom does
  2. How to test
  3. What usually breaks
  4. A worked example: the media design
  5. Checklist

What zoom does

Browser zoom makes every CSS pixel bigger, so the viewport shrinks in CSS pixels: a 1920 px wide window at 200% zoom is a 960 px viewport, at 150% a 1280 px one. Media queries see the smaller width. A zoomed desktop visitor therefore gets your tablet or phone layout, with a mouse and a keyboard.

The Web Content Accessibility Guidelines ask that content can be zoomed to 200% without loss of content or function, and reflow without horizontal scrolling at 320 CSS pixels wide.

How to test

  • Real zoom: press Ctrl and + (Cmd and + on a Mac) to 200% in a 1920 px wide window.
  • Device emulation: in the browser's developer tools, a responsive viewport of 960 x 1080 with device pixel ratio 2 looks like a 1920 px screen at 200%.
  • Automated: the project's browser checks use 1440 px at scale 1, 960 px at scale 2 and 375 px at scale 2.
An item's page at 960 pixels wide, as at 200 percent zoom on a laptop: the columns fold away and nothing overflows
An item's page at 960 pixels wide, as at 200 percent zoom on a laptop: the columns fold away and nothing overflows

What usually breaks

  • Controls hidden "for phones". A rule that hides a search preview or slider arrows below a breakpoint also hides them from zoomed desktop users, who have a mouse and expect them.
  • Fixed heights. Text grows, boxes do not: text overflows or is clipped.
  • Sticky headers. A header that takes 100 px at 100% takes a large share of a zoomed viewport; make it shorter or not sticky below a height (@media (max-height: ...)).
  • Horizontal scroll from fixed widths, wide tables or long words; use max-width: 100%, scroll containers for tables, and overflow-wrap: anywhere for long strings.

A worked example: the media design

The media design's stylesheets/zoom-support.css starts with this explanation: browser zoom shrinks the viewport in CSS pixels, the original theme treated every narrow viewport as a touch phone and hid the search previews and the slider controls, and the file gives them back. Its exp-mobile-layout.css adds tap-target, input-size and image fixes for phones, tablets and 200% zoom. Both are loaded after the theme's build output, so they win without editing it.

Checklist

  • To do: 960 px at scale 2: every function of the 1440 px page is there and usable with a mouse.
  • To do: No horizontal scroll of the page at 960 px and 375 px.
  • To do: Text not clipped in buttons, cards, tabs.
  • To do: Sticky elements leave enough room for content.
  • To do: Light and dark mode both checked at 200%.

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x