Skip to main content

When your published site or preview looks different from the Design Editor on mobile

Learn the main reasons why a layout that looks fine at the mobile breakpoint in the Design Editor can break when viewed on a phone in live preview or on your published site, plus how to fix common cases.

Tip: Responsive design in Studio.Design

In Studio.Design, you create responsive designs by using one page design as the baseline and adjusting styles for each screen width (breakpoint).​
You can change the layout, appearance, and position of boxes and text for each breakpoint, but the actual contents of images and text, as well as the grouping structure, are shared across all breakpoints.​

For more about the overall approach to responsive design and related features, check out these articles:

How breakpoints relate to actual screen widths

In Studio.Design, you can set up to five breakpoints: Default, Small, Tablet, Mobile, and Mini. For screen widths between these breakpoints, the design from the closest breakpoint is scaled down to fit.

  • Example: Mobile set to 540px and Mini set to 320px

    For a phone with a 390px screen width, the Mobile (540px) breakpoint design is applied.
    The Mobile design is automatically scaled down to fit within 390px.

If any boxes have their height or width set to a fixed value like "px", they can't scale down properly, which can cause elements to overflow or the layout to break.
Using size units like "%", "auto", or "flex" — not just "px" — helps prevent layout issues at screen widths between breakpoints.

For more on size units, see Box layout: Setting size (width and height).


Common issues and how to fix them

Here are some common patterns that tend to break on mobile, along with how to fix them.

Example 1: The parent box height is fixed in "px"

When the parent box height is set to a fixed "px" value, there may not be enough space to fit the contents when the screen width gets narrower. This can cause text or images to overflow outside the parent box. (See: When elements get cut off, overflow, or have extra space in responsive view)

▼ How to fix it

Unless you have a specific reason to set a fixed height, we recommend using "auto" for the parent box height.

When set to "auto", the box height automatically adjusts based on the size of its contents, so you're less likely to run into overflow issues.

The same applies to width — using "auto" or "%" generally makes your layout more resilient to changes in screen width.

Example 2: The image box uses "px" while the text box uses "auto" for width

This is when you place an image box with a fixed "px" width next to a text box set to "auto" width at the same level.

When the screen gets narrower, the text can't fit next to the fixed-width image, and elements may overflow outside the parent box.

▼ How to fix it

For this kind of layout, set the image box width to "px" or "%", and set the text box to "1flex".

When set to "flex", the text box automatically fills the remaining space based on the size of the other elements at the same level.

This way, even when the screen gets narrower, the text wraps inside the parent box and is less likely to overflow horizontally.

Example 3: Width isn't specified using "%"

If all widths are specified in "px", element sizes stay fixed even when the screen width changes, which makes layouts more likely to break at screen widths between breakpoints.

This is especially common in multi-column layouts, where the total width may exceed the screen width, causing columns to overflow or wrap unexpectedly.

▼ How to fix it

When you set widths in "%", sizes adjust automatically based on the parent box width, making the layout more resilient at screen widths between breakpoints.

Rather than overriding "px" values at each breakpoint, combining "%", "auto", and "flex" for a relative layout lets you handle a wider range of screen sizes with fewer settings.


Tips for checking mobile view

When checking that everything looks right on mobile, keep an eye on these things too:

  • Make sure the screen width you're checking in the editor isn't too different from the actual phone's screen width.

  • Check whether the layout changes suddenly near the boundary widths of your breakpoints.

  • Look for any elements still using fixed "px" values, and see if you can replace them with "%", "auto", or "flex".

After checking these points, fine-tune your design while reviewing both the design editor's preview and the Live Preview. This helps reduce gaps between what you see in the editor and how it actually looks on a real device.

Did this answer your question?