Migrating from Legacy Customer Accounts in Shopify

For Theme Developers

Remove Legacy Liquid Files

Delete these files from your theme:

templates/customers/login.liquid
templates/customers/register.liquid
templates/customers/account.liquid

Use the New Web Component

<!-- Replace legacy login forms with: -->
<shopify-account></shopify-account>

The shopify-account web component handles:

• Login/register flows
• Password reset
• Account management
• Multi-factor authentication

For App Developers

Use Customer Account UI Extensions

If your app interacts with customer accounts, migrate to UI extensions:

// extension.toml
[[extensions.targeting]]
target = "customer-account.profile.block-render"

// React extension
export default function ProfileBlock() {
  const { customer } = useApi()
  
  return (
    <BlockStack>
      <Text>Loyalty Points: {customer.metafields.loyalty.points}</Text>
    </BlockStack>
  )
}

Stats: 800+ apps already migrated. Don't get left behind.

For Custom Storefronts (Hydrogen)

Use Customer Account API

import { useCustomerAccount } from '@shopify/hydrogen'

export function AccountPage() {
  const { customer, accessToken, logout } = useCustomerAccount()
  
  if (!customer) {
    return <LoginButton />
  }
  
  return (
    <div>
      <h1>Welcome, {customer.firstName}</h1>
      <button onClick={logout}>Sign out</button>
    </div>
  )
}

Migration Steps

1. Update to Hydrogen 2026.x (includes Customer Account API)
2. Replace legacy auth flows with useCustomerAccount hook
3. Test OAuth flow with new customer accounts
4. Remove legacy session handling code

Why Migrate?

Checklist

• Audit themes for legacy customer templates
• Replace forms with shopify-account component
• Update apps to use UI extensions
• Migrate Hydrogen to Customer Account API
• Test all auth flows
• Remove legacy session code

Need help migrating? Weaverse can modernize your storefront in days, not months.