Skip to main content

Account Page Widgets: Install a Rebuy Widget on Shopify Customer Accounts

How to put a Rebuy Recommendations or Content Block widget on your Shopify customer account pages using Checkout Extensions and the checkout and accounts editor.

Written by Tom

A Rebuy account page widget puts personalized product recommendations or a custom content block on the customer account pages your shoppers see after they sign in. Because these are pages a returning customer visits on purpose, they reach people who have already bought from you.

Account page widgets are built under Checkout & Post-Purchase and then Checkout Extensions in the Rebuy admin, and installed from Shopify's checkout and accounts editor. They are not installed through your theme.

This article covers creating and installing the widget. For the widget's own settings, see Checkout Extensions Installation and Settings. For content blocks specifically, see Content Blocks Installation Guide.

Account page widgets require new customer accounts, not classic

An account page widget installed through Checkout Extensions renders only on Shopify's new customer accounts. To check which version your store uses, go to Settings in your Shopify admin, then Customer accounts, then the Configurations section, and click Customize. If that routes you to the Shopify checkout configuration page, your store is on the new customer accounts and the steps in this article apply.

Rebuy previously offered an account page widget that was installed into the templates/customers/account.liquid file in your theme. That method works only on classic customer accounts. When a store upgrades to new customer accounts, Shopify redirects legacy customer account URLs such as /account/login to its own account pages, including any hard-coded links in your theme, so the theme template that held the widget is no longer served and the widget stops appearing.

Shopify has deprecated legacy customer accounts but has not published a shutdown date. Upgrading is reversible for 30 days, after which the classic account pages and any Rebuy widget inside them are gone for good.

If you have a Rebuy widget on a classic customer account page today and you are planning to upgrade, rebuild it as a Checkout Extensions widget using the steps below. Your original widget and its data source are not reused, so create a new one.

Which Rebuy widgets can go on a customer account page

Not every Checkout Extensions widget offers the account pages as a placement. In the Widget Types picker, every card carries a row of location tags, and the tag that covers customer account pages is ORDERS. A card without an ORDERS tag cannot be placed on an account page. The table below lists each placement, the widget options you can put there, and whether that placement requires a Shopify Plus plan.

Placement

Widget options available

Shopify Plus required

Checkout

Recommendations, Content Block, Progress Bar, Line Item Editor

Yes

Thank you page

Recommendations, Content Block

No

Order status page

Recommendations, Content Block

No

Customer account pages (Orders, Order status, Profile)

Recommendations, Content Block

No

Step 1: Create the widget in Rebuy

Create the widget in the Rebuy admin before touching your Shopify admin, because the install step needs the widget's ID. No Shopify Plus plan is required for the widget options that support account pages.

  1. In the Rebuy admin, open Checkout & Post-Purchase in the left sidebar and select Checkout Extensions.

  2. Click New Widget.

  3. In the Widget Types picker, find a card tagged ORDERS, which will be Recommendations or Content Block, and click Select on it. Clicking the card itself shows a preview instead of selecting it.

  4. Give the widget a name and create it.

Account Page Widgets install guide, step 1: the Rebuy Widget Types picker, where the Recommendations and Content Block cards carry an ORDERS location tag and the Line Item Editor and Progress Bar cards are tagged CHECKOUT only

Step 2: Configure the widget and copy its Widget ID

Configure the widget in Rebuy while you are still in the Rebuy admin, then copy the ID that the Shopify install step needs.

  1. Set the Data Source that decides which products the widget returns. A Content Block has no data source, so skip this for that option.

  2. Work through the Configure Settings panels: Language, Product Display, Discount, Styling, and Advanced Settings.

  3. Turn Live Mode on. A widget with Live Mode off will not render for shoppers even after the block is installed.

  4. Click WIDGET ID in the editor header to copy the ID, and keep it somewhere you can paste from.

Account Page Widgets install guide, step 2: the Rebuy Checkout Extensions widget editor with Live Mode on and the WIDGET ID control in the header, which copies the ID needed for the Shopify install step

Step 3: Add the Rebuy Smart Component block in Shopify

Install the widget from Shopify's checkout and accounts editor, which is the same editor that governs your checkout, thank you, and order status pages.

  1. Open the editor. The fastest route is the Visit Shopify's Checkout Editor link at the bottom of the Rebuy widget editor. You can also go to Settings and then Checkout in your Shopify admin, and in the Configurations section click Customize.

  2. The editor opens on the checkout, so switch pages. Click the page selector in the top bar and pick the page you want under the Customer accounts heading: Orders, Order status, or Profile.

  3. In the sections sidebar on the left, click Add block under the section you want the widget to sit in, such as Main.

  4. In the block search, find Rebuy Smart Component under the Rebuy Personalization Engine heading and select it.

  5. Paste your Widget ID into the Widget ID field.

  6. Set Hide widget? to No.

  7. Click Save.

Account Page Widgets install guide, step 3: the page selector in Shopify's checkout and accounts editor, showing the Customer accounts group with Orders, Order status and Profile as the pages a Rebuy widget can be placed on
Account Page Widgets install guide, step 3: adding the Rebuy Smart Component block to the Main section of a Shopify customer account Profile page, selected from the Rebuy Personalization Engine group in the add block search


Where an account page widget can appear

The Rebuy Smart Component is available on the pages listed below, all of which appear under the Customer accounts heading in the editor's page selector. Each is available without a Shopify Plus plan.

  • Orders, the list of a customer's past orders

  • Order status, an individual order reached from that list

  • Profile, the customer's own details page

  • The footer shared across customer account pages

The page selector also offers Sign-in under the same heading, and each account page has an Announcement bar section. Rebuy does not offer either placement, so Rebuy Smart Component will not appear in the block search when you try to add it there. If it is missing from the list, check which page and section you are on before assuming an install problem.

What an account page widget cannot do

These constraints apply to every account page widget regardless of plan, so check them before you promise a merchant a behavior.

  • Rebuy Monetize does not render on customer account pages. It renders on the thank you page and the order status page only.

  • Cross-sell and upsell popups are not available on customer account pages. Rebuy's popup and modal experiences run on the product page, the cart, and as a pre-checkout popup from the Smart Cart. Recommendations and Content Block are the widget options that reach account pages, and both are embedded blocks rather than popups.

  • Adding to cart starts a new checkout with one product. When a shopper clicks the add-to-cart button on an account page widget, Rebuy creates a fresh checkout and sends them to it. Each click carries a single product, so a shopper who wants a second product needs a second checkout. Multiple quantities of the same product are fine.

  • The original order is never modified. An account page widget cannot add a product to an order the customer already placed.


Frequently Asked Questions

Does Rebuy support cross-sell modals on Shopify's new customer account pages?

No, Rebuy does not offer a cross-sell modal or popup on Shopify's new customer account pages. The widget options that support customer account pages are Recommendations and Content Block, and each renders as an embedded block inside the page rather than as an overlay. Rebuy's popup experiences run earlier in the journey, on the product page, in the cart, and as a pre-checkout popup from the Smart Cart.

How do I move my old account page widget to the new customer account pages?

Rebuild it as a Checkout Extensions widget. A Rebuy widget installed into templates/customers/account.liquid lives in your theme and renders only on classic customer accounts, so it cannot be pointed at the new customer account pages. Create a new Recommendations or Content Block widget under the ORDERS location using the steps in this article, then install it from Shopify's checkout and accounts editor. Build and test the new widget before you upgrade your store, so the account page is never left empty.

Does Rebuy Monetize render on customer account pages?

No, Rebuy Monetize does not render on customer account pages. It renders on the thank you page and the order status page. Placing a Monetize widget will not surface it on a customer account page.

Do I need a Shopify Plus plan for an account page widget?

No, you do not need a Shopify Plus plan to put a Recommendations or Content Block widget on your customer account pages. Each is available on the Orders location on every Shopify plan. Shopify Plus is required for product recommendations inside the checkout itself, which is a different placement.

Did this answer your question?