Themes / Theme Store requirement change

The shopify-account component is now
a "mandatory requirement" for the Theme Store

Starting July 30, 2026, new themes and updates to existing themes submitted to the Theme Store must include the shopify-account component in the header, visible on both desktop and mobile. Legacy customer accounts are also deprecated, so bundling their template files is no longer required.

On this page
  1. What changed (in 30 seconds)
  2. What the shopify-account component is
  3. Explainer: The flow from sign-in to the account menu
  4. The three conditions now required
  5. Before / After comparison
  6. Deprecation of legacy customer accounts
  7. Pre-submission checklist (3 steps)
  8. 5 points developers need to know
  9. 3 practical use cases
  10. A one-line summary for your pitch

1What changed

Introduced in February 2026, the shopify-account component has been promoted toa mandatory requirement for themes submitted to the Theme Store.
This applies to both new themes and updates to existing themes . It must be placed in the header andvisible on both desktop and mobile.

Place it in the "header"

Include shopify-account in the theme header. The placement is explicitly specified.

"Visible" on both devices

It must be visible on both desktop and mobile. Showing it on only one, or hiding it inside the hamburger menu, does not meet the requirement.

Legacy templates no longer required

Legacy customer accounts are deprecated, and the requirement to include their template files in a theme has been removed.

This change applies to themes submitted to the Theme Store's review requirements. For themes already published, grace periods, migration deadlines, and how non-compliance is handled arenot stated. That said, "updates to existing themes" are also in scope, so it effectively becomes mandatory the next time you ship an update.

2What is the shopify-account component?

Introduced in February 2026, astorefront sign-in and account managementcomponent. The article explicitly names the following three features, plus one.

Passwordless
Supports passwordless sign-in
Sign in with Shop
Automatic recognition
Social login
Supports social sign-in providers
Account menu
After sign-in, links to each account page
This announcement does not cover the component's attributes, how to write it in Liquid, or the scope of customization: not stated. Check the developer docs (see the footer link) for implementation details.

3Diagram: the flow from sign-in to the account menu

Customer On the storefront header shopify-account Always in the header Both desktop / mobile Click to sign in Sign-in methods Passwordless Sign in with Shop (automatic recognition) Social sign-in The three methods named in the article Account menu Navigate to each account page

* The diagram visualizes what the article describes (sign in on the storefront → after signing in, reach account pages from the account menu). The internal authentication sequence and token handling are not stated.

4The three conditions that make it required

#RequirementWhat decides it
1 shopify-account Includes the component Required A custom-built login link is not listed as an acceptable substitute
2 Placement is header Required Footer or account pages only is not acceptable
3 Both desktop and mobile— must be visible Required Watch out for responsive implementations where one of them disappears

Which theme submissions are affected

Affected

New theme submissions

Brand-new themes headed for the Theme Store. Build it into the header from the start.

Affected

Update submissions for existing themes

Even for themes already published,at the time you submit an updatethe requirement must be met. The key point is that this isn't "new themes only."

5Before / After comparison

ItemUntil nowFrom July 30, 2026
shopify-account Optional Introduced February 2026; up to you whether to use it Required Must be included in the header
Display devices No constraints Both desktop + mobile — must be visible
Legacy customer accounts Bundling the template file was a requirement Deprecated The bundling requirement is dropped
Sign-in experience Varied from theme to theme A consistent experience across every theme (the article's aim)
Grace period / migration deadline Not stated

6Deprecation of legacy customer accounts

The obligation to bundle the template is gone

You no longer need to include the legacy customer accounts template file in your theme. That much can be trimmed from the theme's file structure.

Whether to delete it is your own call

"No longer required to include" is not stated as "safe to delete right away." As for the impact on existing stores still operating with legacy accounts: not stated. Check how it is actually used on live stores before deleting it.

The direction is simple: Customer accounts are consolidated onto the "new" stack (customer accounts + shopify-account). Themes no longer ship their own login UI and instead lean on the Shopify-provided component.

7Pre-submission checklist for themes (3 steps)

1

Embed it in the header

Place the shopify-account component in your theme's header.

2

Verify at both breakpoints

Visually confirm that it actually shows up at both desktop and mobile widths.

3

Take inventory of legacy templates

Decide whether you still need the legacy customer account templates before you submit.

The exact review procedure, whether there is an automated lint, and the wording of the rejection message are not stated. Be sure to re-read the Theme Store requirements page (linked in the footer) before submitting.

85 points developers should keep in mind

1. The requirement is not just "include it" but "make it visible"

The wording of the requirement is include ... in their header, visible on both desktop and mobile. Even if it exists in the DOM, hiding one of them with CSS goes against the intent.Designs that drop header icons at responsive widths need to be revisited.

UPDATE

2. Existing themes get caught too, on "update submissions"

This is not just about new themes.updates to existing themes are also in scope, so even if you only intend to ship an update with a single bug fix, you will need shopify-account support first. That affects the order of your development plan.

3. Do not build your own authentication

Passwordless login, automatic Sign in with Shop detection, and social sign-in are all features provided by the component.Building your own login form into the theme costs you twice: on meeting the requirement and on duplicated maintenance.

4. When to clean up legacy templates

Since bundling them is no longer mandatory, you can reduce your theme's file count and maintenance surface. That said, deleting them is not a requirement.not "you may delete them" but "you no longer have to carry them"is the safe reading.

5. The boundary has moved from "theme differentiation" to "a shared experience"

The article's purpose is customers get a consistent experience on any device. In other words, Shopify istaking account-related UI out of each theme's discretion and moving it into shared platform components. Going forward, custom theme design assumes you check the Theme Store requirements each time to see "how far you are free to change things." Note that how freely the component can be styled and how far it can be customized are not stated.

93 use cases you can apply at work

USE CASE 1

A "pre-update inventory" for themes listed on the Theme Store

Problem
You try to submit a small fix to a live theme and get rejected because it does not support shopify-account. The lead time for the change becomes impossible to predict.
Action
Before your next theme update submission, bundle these into a single release: ① embed shopify-account in the header, ② verify it renders on both desktop and mobile, ③ decide whether the legacy customer account templates are still needed.
Impact
You can ship every later update without being blocked by the requirement, and avoid getting stopped in review every time you submit a minor fix.
Technical notes
"Updates to existing themes" are in scope too. Pay special attention to implementations that thin out the header icon set on mobile.
USE CASE 2

A case for dropping custom login UI on custom theme projects

Problem
A client project has a hand-built login and account menu, and implementation costs pile up every time a request comes in for passwordless or social login.
Action
Propose replacing it with the shopify-account component. Use the fact that passwordless, automatic Sign in with Shop recognition, and social sign-in ship as standard to get agreement on retiring the custom implementation.
Impact
Less authentication code to maintain, and you automatically get whatever Shopify adds next. The fact that it is now a Theme Store requirement — i.e. the platform's standard path — is also a useful argument.
Technical notes
That said, this post says nothing about how freely the design can be customized. On projects with strict brand requirements, check the docs for the customization scope before agreeing to it.
legacy new Fewer files to maintain
USE CASE 3

Migration assessment for stores still on legacy customer accounts

Problem
Several stores you operate still carry legacy customer account templates. The deprecation has been announced, but it is unclear where to start.
Action
① Inventory each store's theme for legacy account templates and whether they are actually in use → ② check whether shopify-account is already in place → ③ prioritize the stores that are not yet migrated and put them on a migration plan.
Impact
You make your dependence on deprecated features visible and can prepare for sudden rejections or eventual removal. It also cuts the number of files you maintain in the theme.
Technical notes
This post does not cover when legacy customer accounts will be fully shut off or the detailed migration steps. Go to the official "Legacy customer accounts are deprecated" documentation as the primary source.

10A one-line summary you can use in a proposal

"For themes submitted to the Theme Store,putting the shopify-account component in the header and making it visible on both desktop and mobileis now mandatory.
Not just new themes —updates submitted for existing themes are in scope too.
. At the same time, legacy customer accounts are deprecated, and the requirement to bundle their templates has been removed."