Decide on customer account UI extension placement
Customer accounts are getting layout and design updates. Enable the Customer account improvements feature preview to get early access. Review the feature preview overview and where extension targets will render in the new layout.
Customer accounts are getting layout and design updates. Enable the Customer account improvements feature preview to get early access. Review the feature preview overview and where extension targets will render in the new layout.
When you're deciding where to place a customer account UI extension, consider how it relates to the surrounding information on the page, and where it might fit within the existing page structure. You can place UI extensions on the Order status, Profile, and Order index (order action menu) pages. Explore all targets.
If an extension doesn’t fit into one of these pages, then consider building a full-page extension instead.
If an extension doesn’t fit into one of these pages, then consider building a full-page extension instead.
Anchor to Order statusOrder status
The Order status page is where customers can view, track, and manage their order. Extensions such as an order action menu extension that pertain to a specific order belong on this page.
To decide the most appropriate placement for extensions on the Order status page, consider the following page areas and their primary function:
-
Order status timelines: Provides updates on item delivery, pickup, or return, and information for tracking order statuses.
-
Order actions: Enables a customer to manage an order.
-
Order summary: Contains the items in an order and the cost.
NoteOn mobile, the order summary is collapsed at the top of the page. This prioritizes the visibility of order actions and the order status timeline, while maintaining easy access to the order summary.
Note:On mobile, the order summary is collapsed at the top of the page. This prioritizes the visibility of order actions and the order status timeline, while maintaining easy access to the order summary.
-
Order details: Contains the customer, shipping, and billing information for the order.
NoteOrder action menu extensions are shared between the Order index and Order status pages, which enables customers to manage their order from either page.
Note:Order action menu extensions are shared between the Order index and Order status pages, which enables customers to manage their order from either page.
The following image displays targets in the context of the Order status page's layout.
Anchor to Profile pageProfile page
The Profile page is where customers can view and edit their personal information. For B2B customers, this page also includes the company name, and the company location(s) that they have access to.
To decide the most appropriate placement for UI extensions on this page, consider whether your UI extension pertains to customer information, company information, or company location information, and choose a target accordingly.
For example, if your extension pertains to customer information, then the customer-account.profile.block.render block target is a good fit. This target renders in both the default and B2B experiences, and merchants can customize the placement of this extension in the checkout editor.
All static targets available on this page render either on the default experience or the B2B experience.
Anchor to Order indexOrder index
The Order index page is where customers can view and manage all their past and current orders. The primary purpose of this page is to help customers find orders. To keep the page focused on this goal, only one block target, with two available placements, is available on this page. Order action menu extensions also render on this page, in both the grid view and list view.
Order action menu extensions are shared between the Order index and Order status pages, which enables customers to manage their order from either page.
Order action menu extensions are shared between the Order index and Order status pages, which enables customers to manage their order from either page.
The following image displays targets in the context of the Order index page:
Anchor to Define default placementDefine default placement
When you’re using a extension block target, merchants can place the UI extension in any of the supported placements on the page. To recommend a specific placement to merchants, define the default placement by using the [[extensions.targeting.default_placement]] property in the TOML file. Learn how to configure default placement.
Use the following placement references to indicate the default placement:
Anchor to Placement referencesPlacement references
Here are all the placement references for each page in customer accounts.
Anchor to Order indexOrder index
Block target: customer-account.order-index.block.render
Placement references: PAGE_TITLE, ORDER_INDEX
Anchor to Order statusOrder status
Block target: customer-account.order-status.block.render
Placement references: PAGE_TITLE, ORDER_STATUS1, ORDER_STATUS2, ORDER_STATUS3, ORDER_SUMMARY1, ORDER_SUMMARY2, ORDER_SUMMARY3
Anchor to ProfileProfile
Block target: customer-account.profile.block.render
Placement references: PAGE_TITLE, PROFILE1, PROFILE2
Use these placement references as URL parameters to test your block extensions in all supported placements. Learn more about testing customer account extensions.
Use these placement references as URL parameters to test your block extensions in all supported placements. Learn more about testing customer account extensions.
