Building apps for customer accounts

Merchants use customer accounts to enable their customers to view their order history, check order statuses, edit their profile, and take actions related to their order. You build customer account extensions with Polaris, Shopify's unified system for building app interfaces. Polaris provides targets that define where your extension appears, target APIs that give your extension access to customer account data and functionality, and web components that render the UI.

Customer account UI extensions are only supported on the new version of customer accounts. Legacy customer accounts don't support customer account UI extensions. Learn more about customer accounts.

Anchor to How it worksHow it works

Customers can navigate to their account from the online store, from order notification emails, or any custom entrypoint placed by the merchant.

If the customer isn't already logged in, clicking a link from an order notification email to view their order will bring them to the pre-authenticated Order status page. From there, if the customer tries to navigate to another page in their account, or tries to take an action, they'll be prompted to log in. After the customer logs in, they're fully authenticated and able to access all customer account pages. Learn more about Order status page authentication states.

Using customer account UI extensions, apps can extend the functionality of existing customer account pages, as well as create new pages (full-page extensions).

You can extend the following pages in customer accounts at defined targets:

Anchor to Order indexOrder index

Anchor to Order statusOrder status

Anchor to ProfileProfile

Anchor to Build for customer accountsBuild for customer accounts

The following guides walk through common use cases for customer account UI extensions. For the full reference, see customer account UI extensions.

Anchor to Extension typesExtension types

Build an order status extension

Add custom content to the Order status page where customers view, track, and manage a specific order.

Build an order action extension

Add actions like requesting a return or leaving a review to order action menus.

Build a profile extension

Extend the Profile page with custom content, such as membership level or loyalty balance.

Build a full-page extension

Create new pages for use cases that aren't suited to native pages, like wishlists, subscriptions, and rewards.

Anchor to Purchase optionsPurchase options

Let customers manage subscriptions and deferred purchase options from their account. See all purchase options guides.

Build a customer portal

Let customers view and manage their active subscriptions and deferred purchase agreements.

Anchor to Orders and fulfillmentOrders and fulfillment

Let customers take self-serve actions on their orders. See all orders and fulfillment guides.

Build self-serve returns

Let customers request returns directly from their account.

Anchor to Next stepsNext steps

• Start building for customer accounts to set up your development environment and scaffold your first extension.
• Explore the customer account UI extensions reference for available targets, target APIs, and web components.

Anchor to Product roadmapProduct roadmap

As of February 26, 2026, legacy customer accounts are deprecated. They're no longer available to new stores, and existing stores that weren't using them no longer have access. All merchants must upgrade to the latest version of customer accounts. The following customer account features are on our roadmap with estimated launch dates: