Shopify guideGuide·9 min read
How to Set Up Customer Accounts in Shopify (New vs Legacy)
Shopify's customer accounts replace passwords with a one-time code and add returns and store credit. Here is how to set them up, upgrade from legacy accounts and choose the right options.

Key takeaways
- Shopify's customer accounts let shoppers sign in with their email and a one-time 6-digit code, so there are no passwords to create, forget or reset.
- Shopify now describes legacy customer accounts as deprecated. It hasn't published an end date, but new features such as self-serve returns and store credit only come with the new accounts.
- You set everything up in
Settings > Customer accounts, and you can undo an upgrade from legacy accounts within 30 days. - Most stores should show sign-in links but keep checkout open to guests. Forcing an account before checkout only makes sense for wholesale or members-only stores.
- Who it is for
- Store owners on new or legacy accounts
- Time needed
- 15 to 30 minutes to set up
- What you need
- Admin access and your sender email
A shopper who has to reset a password just to see where their parcel is will often give up and email you instead. That is the problem Shopify's customer accounts solve. The shopper types their email, gets a code, and lands on a page with their orders, addresses and returns. No password, no theme template to maintain.
I set these up on almost every store I build or rebuild now, and I move older stores off legacy accounts when they come to me for other work. This guide covers the setup step by step, the upgrade from legacy accounts, the decisions you need to make, and the mistakes I see most. I checked every setting name against Shopify's Help Center on 7 November 2026.
Customer accounts vs legacy accounts
Shopify runs two systems side by side. The new system is simply called "customer accounts" in the admin. The old one is "legacy customer accounts". Shopify's upgrade guide states plainly that legacy customer accounts are deprecated, so any store still on them is working on borrowed time, even though no switch-off date has been announced.
| Feature | Customer accounts | Legacy accounts |
|---|---|---|
| Sign-in | Email and a 6-digit code | Email and password |
| Password resets | None needed | Common support request |
| Self-serve returns | Built in | – |
| Store credit | Built in | – |
| Google and Facebook sign-in | Built in | – |
| Where pages live | Hosted by Shopify, outside the theme | Theme templates |
| Status | Current | Deprecated |
The last two rows matter more than they look. Because the new account pages are managed separately from your theme, a theme update or a theme switch no longer breaks your login page. On legacy accounts, the account pages are part of the theme, so every redesign means checking them again.
Signed-in sessions also last up to 365 days, so a returning customer stays signed in for a long time on the same device. Saved details fill in at checkout automatically.
What to check before you switch
On a new store, there is nothing to check: turn customer accounts on and move to the next section. On an existing store with legacy accounts, spend 20 minutes on these first, because they are where upgrades go wrong:
- Theme customizations. Look at your legacy customer templates in the theme code. Shopify redirects old account URLs automatically, including links hard-coded in the theme, but a custom registration page or extra sign-up fields need a plan.
- Apps that add things to the account page. Loyalty, wishlist and subscription apps often inject content into legacy account templates. Check whether each app offers a block for the new accounts, or find a replacement.
- Shopify Flow and customer segments. Shopify warns that some triggers and
customer_account_statusvalues change. Any workflow or segment built on account status should be reviewed. - Your sender email. Sign-in codes are sent from your store's sender address, so it should be a real, authenticated address on your own domain. My guide on connecting your domain and business email covers this.
- Multipass on Shopify Plus. An existing Multipass integration keeps working with no action needed, according to Shopify.
How to turn on customer accounts
For a store that has never used accounts, setup takes a few minutes:
- Open the settings. In your Shopify admin, go to
Settings > Customer accounts. - Show the sign-in link. In the Sign-in links section, turn on Show sign-in links, then click Save. Your theme decides how the link looks: usually a person icon in the header, the customer's initial, or a "Sign in" label.
- Choose your extras. On the same page, decide whether to turn on Self-serve returns and cancellations, Store credit, Social sign-in and Sign in with Shop. Each is covered below.
- Set the checkout rule. Go to
Settings > Checkout. Under the customer contact options, leave Require customers to sign in to their account before checkout off unless you have a clear reason (see the decision flow further down). - Test it as a customer. Open your store in a private browser window, click the sign-in link, enter an email you control and check that the code arrives from your own address, not a generic one.
Customers don't need to "register". If someone signs in with an email that already has a customer profile, they get that account and its order history. If the email is new, Shopify creates a customer profile automatically.
How to upgrade from legacy accounts
Shopify's own upgrade path has five steps, and it builds in a safe test before you switch:
- Duplicate your checkout configuration. Go to
Settings > Checkout, click Duplicate on your current configuration and give the copy a clear name. - Customize the copy. Click Customize next to the copy, add your brand settings and any app blocks, and click Save.
- Publish it. Click Publish next to the copy.
- Test sign-in first. Go to
Settings > Customer accounts, copy the account URL and open it in a new tab. Sign in with every method you plan to offer. - Upgrade. Back in
Settings > Customer accounts, click Upgrade in the banner.
Shopify doesn't say what happens to old customer passwords, and you don't need them: customers sign in with a code from then on. I add a short line to the next newsletter, something like "You can now sign in with just your email", so regulars aren't surprised by the new screen.
The features worth turning on
Every option below is a toggle in Settings > Customer accounts. Here is how I decide on each one:
- Self-serve returns and cancellations. Customers request a return or cancellation from their order page, and you approve it in the admin. Turn it on if your return policy is simple. If returns need photos or manual checks, test the flow before relying on it.
- Store credit. Customers can see their store credit balance and spend it at checkout. Useful if you refund to credit or reward customers with credit.
- Social sign-in. Adds Google and Facebook buttons. Fewer typed emails means fewer typos, so I usually turn on Google at least.
- Sign in with Shop. Lets customers sign in with their Shop account and saved passkeys. It needs Shop Pay to be active on your store.
- URL. Serve account pages from a subdomain such as
account.yourstore.com, so shoppers stay on your own domain the whole way. Worth the five minutes of DNS work. - Identity provider. Shopify Plus stores can connect their own sign-in provider, which replaces Shopify's sign-in page. Only relevant if customers already have logins in another system.
Branding the account pages
Account pages share their styling with checkout. You edit both in the checkout and accounts editor, which opens when you click Customize on a configuration in Settings > Checkout. Set your logo, colors and fonts once and they apply to both. You can draft changes before publishing and customize by market.
Two other options are worth knowing about. Apps can add content to the account pages, such as a loyalty balance or subscription controls. And themes that support Shopify's account component show sign-in in a small window on the storefront instead of sending shoppers to a separate page, which feels quicker on a phone.
Should customers have to sign in to buy?
This is the one decision that can cost you sales if you get it wrong. A forced account adds a step between "I want this" and "paid", and every extra step loses some shoppers. Use this flow:
Require an account before checkout?
- 1
Do you sell only to approved trade or wholesale buyers?
Yes: require sign-inNo: next question
- 2
Is the store for members only, such as a club or staff shop?
Yes: require sign-inNo: next question
- 3
Do prices or products depend on who the customer is?
Yes: consider requiring sign-inNo: keep guest checkout
For a normal retail store, show sign-in links, keep guest checkout, and let saved details and Shop Pay do the convincing.
If you sell wholesale through Shopify B2B, note that Shopify's test order guide says B2B test orders need customer accounts to be active. B2B is available on the Basic, Grow, Advanced and Plus plans, and the features you get depend on your plan.
The Customer Account API, for headless stores
If your storefront is built with Hydrogen or another headless setup, the theme isn't involved, so you connect accounts through the Customer Account API. It is a GraphQL API that acts for a signed-in buyer, covering order history, profile and addresses.
- Sign-in uses the OAuth 2.0 authorization code flow. Public clients, such as a browser or mobile app, use PKCE instead of a client secret.
- Setup needs a client ID and registered redirect URIs from the Customer Account API settings, plus your JavaScript origins for web clients.
- Endpoints should be discovered from
/.well-known/openid-configurationon your storefront domain rather than hard-coded. - Checkout handover works by setting the customer's access token on the cart, so the buyer stays signed in at checkout.
This is developer work. If you're on a normal Shopify theme, you never touch the API: the settings above are all you need. When a store needs a custom account feature that no app covers, that is the kind of job I take on through custom app development, which starts from $800.
Common mistakes
- Codes arriving from a generic address. If your sender email isn't authenticated, codes can look like spam. Authenticate your domain before you upgrade.
- Hiding the sign-in link to "simplify" the header. Turning off Show sign-in links stops customers signing in at all, and removes the account menu from your store.
- Upgrading without checking apps. A loyalty or subscription app that relied on legacy templates can vanish from the account page overnight.
- Forgetting Flow and segments. Workflows keyed to account status can quietly stop firing after the switch.
- Forcing sign-in on a retail store. It feels tidy, but it adds a step at the worst possible moment.
- Telling customers to change their email to merge accounts. Customers can't merge profiles that way. You merge duplicate profiles in the admin from the customer profile.
Setup checklist
- Sender email set to an address on your domain, with the domain authenticated.
Settings > Customer accounts: Show sign-in links turned on.- Self-serve returns, store credit and social sign-in decided and set.
- Account subdomain such as
account.yourstore.comconnected. - Checkout and account branding set in the checkout and accounts editor.
- Guest checkout kept on, unless you're B2B or members-only.
- Apps, Flow workflows and segments checked (existing stores).
- Sign-in tested in a private window with every method you offer.
Next steps
If you're launching, set up accounts alongside the rest of your settings, and work through my guide to the Shopify settings every store owner should check. If you're upgrading an established store, do the checks above, upgrade on a quiet day, and watch your support inbox for a week. Password questions should drop away.
Account pages are also part of how customers judge a store after the first order. When I run a CRO review, I check the post-purchase experience as well as the product page, because repeat orders come from there. If you'd like a second pair of eyes on your setup, I'll look at it for free.
Free tools
Check your own store
Free, no sign-up. Each one runs a part of this guide for you.
Frequently asked questions
What is the difference between Shopify customer accounts and legacy accounts?
Customer accounts let shoppers sign in with their email and a one-time 6-digit code, and include self-serve returns, store credit and social sign-in. Legacy accounts use a password and live in your theme's templates. Shopify describes legacy accounts as deprecated.
Are Shopify legacy customer accounts being removed?
Shopify's upgrade guide says legacy customer accounts are deprecated, but it hadn't published an end date when I checked on 7 November 2026. New account features are only being added to the new system, so it makes sense to plan the upgrade now.
Where do I turn on customer accounts in Shopify?
Go to Settings > Customer accounts in your Shopify admin. In the Sign-in links section, turn on Show sign-in links and click Save. The same page holds the options for returns, store credit, social sign-in and the account subdomain.
Can I go back to legacy accounts after upgrading?
Yes, within 30 days of upgrading. After that, treat the change as permanent. Test sign-in with the account URL before you click Upgrade so you don't need to roll back.
Do customers need a password for Shopify customer accounts?
No. Customers enter their email address and receive a 6-digit code to sign in. They can also use Google, Facebook or Sign in with Shop if you turn those on. Sessions can last up to 365 days on the same device.
Should I make customers create an account before checkout?
For most retail stores, no. Keep guest checkout and show sign-in links instead. Requiring sign-in suits wholesale-only or members-only stores, and you set it in Settings > Checkout.
What is the Shopify Customer Account API?
It is a GraphQL API that lets headless or Hydrogen storefronts show a signed-in customer's orders, profile and addresses. It uses OAuth 2.0, with PKCE for browser and mobile clients. Stores on a normal theme don't need it.
Sources
- Customer accounts, Shopify Help Center
- Setting up and managing customer accounts, Shopify Help Center
- Upgrading to customer accounts from legacy customer accounts, Shopify Help Center
- Checkout form options, Shopify Help Center
- Customer Account API, Shopify.dev
- B2B requirements, Shopify Help Center
Related services and work

Written by Ashraf Siddik
I'm a Shopify developer and CRO specialist. I have built and improved Shopify stores since 2018, completed more than 1,000 projects, and hold a 4.96 average rating across 719 client reviews.
More guides
-
CRO8 min readUpdated
Why Shopify Stores Lose Sales on Mobile: A Practical CRO Checklist
Mobile visitors decide fast, with one thumb and plenty of distractions. Here is how to find the leaks on a Shopify store and fix them in the right order.
Read the guide -
CRO6 min readUpdated
Shopify CRO Audit Checklist for DTC Brands
The checklist I use to audit DTC Shopify stores, from checking that the data can be trusted to deciding which fixes to ship first.
Read the guide -
Apps6 min readUpdated
When to Build a Custom Shopify App Instead of Adding Another Subscription
Another subscription is the quickest fix, until you are paying for five apps that still don't match how your business works. Here is how to decide.
Read the guide -
Themes6 min readUpdated
How to Find Out What Theme a Shopify Store Uses
Every Shopify store names its theme in the page code. Here is where to look, how to read what you find, and what it means for your own theme choice.
Read the guide -
Apps5 min readUpdated
How to See What Apps a Shopify Store Uses
Apps leave traces in a store's page code: scripts from their own servers, app embed folders and pixel settings. Here is how to read them, and what to do with the list.
Read the guide -
Branding7 min readUpdated
How to Name a Shopify Store (and Check the Name Is Free)
A store name has to be easy to say, free as a domain and a handle, and clear of other brands. Here is the process I use with clients, and what Shopify lets you change later.
Read the guide