September 26, 2026 · Muhammad Umar · More by Muhammad Umar
Shopify's New Single-Column Customer Account Layout
Shopify redesigned customer accounts around a single-column layout. Here's what changes by API version — and what doesn't break.
A New Default Layout, Not a Breaking Change
Shopify has redesigned the customer account interface around a single-column layout by default. Native page layouts — order status, order index, and profile pages among them — now render in a single column, and full-page extensions default to full width, with an option to apply a narrower width instead. Existing extension targets aren't replaced; they're remapped into the new layout.
Shopify is explicit that this isn't a breaking change: these changes don't break your existing work, and all current extension targets remain supported — though the docs also recommend testing extensions now to confirm they still look right, particularly full-page ones.
What Changes by API Version
How much manual work this creates depends entirely on which API version an extension targets. For 2025-07 or earlier, Shopify recommends updating to 2025-10 or later specifically to adopt Polaris web components. Applying the optional narrower full-page width takes different code depending on version: extensions on 2026-07 or later get the narrow width automatically through the Page component's inlineSize behavior, with inlineSize="large" available if more desktop space is needed. Extensions on 2025-10 through 2026-04 need to be wrapped in an s-grid element with gridTemplateColumns set to minmax(auto, 64rem) and centered justification. Extensions on 2025-07 or earlier require a manual Grid/View wrapper using viewport-based Style rules to hide or show side padding at different screen widths.
In practice, that means a storefront team's first move is checking which API version each deployed extension targets, since that single fact determines whether the narrow layout arrives automatically or needs to be hand-wired in.
The Three Parts Every Extension Is Built From
Underneath the layout change, customer account UI extensions are still built from the same three parts: targets that decide where the extension appears (block, full page, or static), target APIs — accessed through the shopify global object — that expose data like shopify.order or shopify.authenticatedAccount, and web components built with remote-dom that render the actual interface. Merchants can place up to three extensions in the same block target location, so a block extension's design still needs to hold up alongside others sharing that spot.
One thing the layout redesign doesn't change: extensions that touch customer data still need the app's protected customer data access approved before they can go live. That approval requirement is independent of how the page around the extension is laid out.