Skip to main content

Layout

Layout design is the process of arranging visual elements such as text, images, and shapes on a page.

Apps have a variety of available layouts. These layouts adapt the app body content to every screen size and device type. Selecting the proper layout for the task at hand will benefit your app's merchant experience.

Anchor to Responsive grid layoutResponsive grid layout

The page web component provides built-in responsiveness for the aside slot. The grid web component allows more bespoke responsive handling. Take these into consideration when you build your app.


The page web component offers various layouts to match the complexity of your app.

Anchor to Single-column layoutSingle-column layout

The single-column layout enables merchants to scan content from top-to-bottom and focus on a single, obvious task.

Most often, an app's homepage uses the single-column layout in a default-width page. However, if your app feels more like a dashboard, then you can also use the two-column equal width or three-column layout.

Two-column layouts allow merchants to view more content at once. This is helpful for visual editors or content-dense pages.

The settings layout lets merchants quickly scan and find groups of settings that are related to each other.


Spacing helps your app maintain a pleasant experience by keeping interface components well-positioned with consistent visual rhythm. To simplify spacing, use the stack web component.


The density of elements in a layout can greatly impact your app's readability and usability.

Make your app efficient and easy to use by providing the right density at the right moment, for the right task.


Most of an app's content exists in containers. Containers compartmentalize content and create a natural hierarchy between parts of an interface.

Sections structure your app's content so that merchants can scan information easily. Sections act as containers and can be static or interactive.

The section web component provides an easy way to segment content, while still respecting Shopify's App Design Guidelines.

Tables are helpful for summarizing many object instances. Use the table web component for relatively simple summaries, and the Index table pattern when you have a lot of data to show.

Refer also to the Polaris pattern for Resource index layout, when you are summarizing resource objects.


Was this page helpful?