Made in Builder

Made in

How to Build: Localization webinar on March 23rd @ 10am PST. Register Now




Use Cases





Log in












Visual CMS

Drag-and-drop visual editor and headless CMS for any tech stack

Theme Studio for Shopify

Build and optimize your Shopify-hosted storefront, no coding required



Get StartedLogin

While Builder offers default breakpoints that work for most designs and apply automatically, sometimes a design necessitates custom breakpoints specific to your layout.

To get the most out of using customizable breakpoints, you should already be familiar with:

To use custom breakpoints, you must:

Note: Builder's Shopify app does not support custom breakpoints.

Changes you make to your breakpoint settings affect all content in a whole Space. However, in order for the breakpoints to apply to a particular content entry, you must publish or re-publish that content entry.

The following table lists the SDKs you can use custom breakpoints with as well as supported versions and NPM packages.

SDKVersionNPM Package


≥ 2.0.9


≥ 0.0.31

React Native

≥ 0.0.13


≥ 0.0.21


≥ 0.0.7


≥ 0.0.5

  1. Go to Account Settings.
  2. Click on the pencil icon next to Customize Breakpoints.
  3. Edit the breakpoints using pixels.
  4. Click Update Breakpoints to save your changes.
  5. Publish or re-publish content entries to which you'd like to apply the new custom breakpoints.

The image below shows the Customize Breakpoints dialogue in Account Settings.

Screenshot of the Customize Breakpoints dialogue in Account Settings.

If you are using a supported SDK, you can also access the Custom Breakpoints dialogue directly from within the Visual Editor:

  1. Hover to the right of the device icons and click on the dropdown arrow.
  2. Click on Customize Breakpoint Settings to edit the breakpoints as above.

In the Visual Editor, hover over the Desktop, Tablet, or Phone icon to display the breakpoints that currently apply to that view.

When there are custom breakpoints applied to a view, Builder displays a small blue dot to the upper right of the view's icon.

The image below shows the hover state of the tablet icon with a custom breakpoint of 600px to 909px:

Screenshot fo small blue dot to the upper right of one of the breakpoints icons, which indicates a custom breakpoint applies to that range of viewport sizes.

If you're using a supported SDK, Builder displays a dropdown arrow that you can click to open the Customize Breakpoints panel. Here, you can view the current breakpoints and click the Customize Breakpoints Settings button to access and edit the settings.

Screenshot of Customize Breakpoints panel in the Visual Editor.
  1. Go to Account Settings.
  2. Click on the pencil icon next to Customize Breakpoints.
  3. Click Restore Default Breakpoints.
  4. Click Update Breakpoints.

Any changes you make to the breakpoints affects all content entries in a Space. However, you must publish any content entries in which you'd like to use the updated breakpoints.

Refine your use of breakpoints with a solid foundation in responsive techniques. For more information, see:

Looking to hire a 3rd party to help with your project?

Submit a project request and our partnerships team will reach out to connect you with an Expert from our partner ecosystem.

Connect with us

Was this article helpful?