What is it and why is it important?
The Thank You Page (TYP) and Order Status Page (OSP) present key opportunities to re-engage customers right after they complete a purchase. Product Marketing has found that, on average, customers check their order status eight times, making these pages prime spots for further engagement.
Getting Started and Installation Instructions for a Thank You or Order Status Page Widget
Access Checkout Extensions
Log in to Rebuy Admin and go to Checkout Extensions tab.
Create a Widget and Choose Placement
Click New and Select 'recommendations' under the Thank You Page or Order Status Page options.
Name your widget
Give the widget a name and click create widget.
Configure the Widget
Set data source rules (e.g., which products to show).
Customize the text, product display, discounts, styling, and advanced settings.
Save Widget ID
Copy the widget ID and save it for later.
Access Checkout Editor
Go to the Checkout Editor in your Shopify Admin.
Add the Widget Block
Click Add Block and select the RebuySmart Component.
Enter Widget ID
Paste the saved widget ID.
Set Visibility
Set Hide Extension to No to make the widget visible.
Save and Refresh
Click Save to activate the widget (you must refresh the Shopify checkout editor previewer for the widget to display in the previewer).
Video Walkthrough Instructions
Widget Settings
Language
General Settings:
Customize the super title, title, and description for the widget.
The preview updates in real-time to show your changes.
Call to Action & Buttons:
Customize the Add to Cart button, Sold Out, and Redirect to Checkout buttons.
Redirect to Checkout: This is for the Thank You Page only. After clicking the Add to Cart button, shoppers will see this button text and need to click it before being sent to checkout in a new tab. An arrow icon will appear next to the text.
Variants:
Customize a single variant option or multiple variant options.
Subscription:
Upgrade to Subscription: Toggle on and customize the wording for the subscription option.
Product Display
Products
Choose the number of products to display, from 1 to 24.
Display one-time only, subscription, or both product types.
Carousel
Enable carousels with at least 4 products shown for the carousel to work.
Carousel style: Choose between horizontal or vertical.
Images
Image Source: Use the image from the variant or product.
Product Text:
Customize product title size (Extra Small, Small, Default, Medium, Large, Extra Large).
Product title emphasis: Set it to bold, default, or italic.
Toggle to display or hide the product description.
Variant Options:
Variant Text: Adjust the variant title size (Extra Small, Small, Default, Medium, Large, Extra Large), and set the variant title emphasis (Default, Bold, Italic).
Show variant options as always, default, or never.
Variant Selector Types: Use select or radio button.
Choose to hide out of stock variants, and/or match on variant
Quantity Settings:
Enable a minimum or maximum quantity value, and choose the quantity input type (dropdown, button, or manual input).
Discount Settings
Configure discounts as none, fixed, or percentage.
Enable Shopify functions for automatic discounts during checkout. If you prefer to apply discounts via Shopify Scripts, toggle off Shopify functions.
Note: Shopify functions do not support conditional discounts with data sources, except when using Shopify discounts or the script editor.
Choose between compare price or actual price for the discount.
Styling
Offer and Images
Choose the border width (default or medium).
Enable borders and adjust the border radius (none, small, default, large, fully rounded).
Image Fit Settings:
Shopify offers two options for image fit:
Contain: The image keeps its aspect ratio but is resized to fit within the given dimensions.
Cover: The image keeps its aspect ratio but fills the given dimensions, clipping the image to fit.
Button Style:
Choose between primary, secondary, or plain button styles.
Review Stars:
If you have a review provider, you can change the color and size of the stars (small, default, large).
Advanced Settings:
Integrate with your review platform by toggling on your review provider and configuring the integration.
Widget Tracking and Attribution Tracking are toggled on by default. These hidden product properties are used for performance tracking and dynamic discounting. Disabling them will result in the loss of performance and engagement metrics.
Important Notes & Limitations
The Thank You Page or Order Status Page widget can be placed on both the Thank You and Order Status pages, or you can create separate widgets for each page.
No modifications to the original order: Once an order reaches the Thank You Page or Order Status Page, it is considered finalized. Any changes must be processed as a new order, which requires a new checkout experience.
One specific product per checkout: You can only add one specific product via the Thank You Page or Order Status Page. If a customer wants to add multiple items, they will need separate checkouts for each product. However, they can still add multiple quantities of the same item.
Shopify limitations for the Thank You Page: Shoppers will need to click the "Add to Cart" (ATC) button twice to proceed to the checkout page with the upsell product added. The first click builds the checkout URL and changes the button text to "Checkout" with an arrow icon. Clicking the button again opens the checkout in a new tab.
Order Status Page behavior: On the Order Status Page, shoppers will only need to click the "Add to Cart" (ATC) button once to proceed to the checkout page with the upsell product added.
Saved shipping information: For a seamless checkout experience, saved shipping information will be automatically applied to upsell orders on the Thank You Page or Order Status Page.
NOTICE: Shopify is making updates that will affect the functionality of widgets on the Thank You Page and Order Status Page. If you are currently using legacy widgets that rely on ScriptTag functionality, these will no longer be supported by Shopify. To learn more about the deprecation, you can see Shopify's public announcement.
The use of additional scripts on the Thank you and Order status pages has already been deprecated and is no longer supported. Instead, you should use app blocks and web pixels to recreate customizations for these pages. If you haven't upgraded your pages yet, you need to do so by the following deadlines:
For Shopify Plus plan users, the deadline is August 28, 2025.
For non-Plus plan users, the deadline is August 26, 2026.
After these dates, the pages will be auto-upgraded to the new versions if not done manually before the deadline.
Compatibility Matrix
Feature Description | Shopify Plus | Non-Shopify Plus |
Product Recommendations - Checkout | Yes | No |
Content Blocks - Checkout | Yes | No |
Content Blocks - Thank You Page | Yes | Yes |
Content Blocks - Order Status | Yes | Yes |
Product Recommendations - Post-Purchase | Yes | Yes |
Product Recommendations - Thank You Page | Yes | Yes |
Product Recommendations - Order Status | Yes | Yes |
Shopify Plus Merchants
As a Shopify Plus merchant, you have the ability to add Checkout Extension blocks for product recommendations or images directly into your checkout, thank you page, and order status pages. You can also use the checkout extensions content blocks to add images to your checkout, order status page, or thank you page.
Non-Shopify Plus Merchants
If you are a non-Shopify Plus merchant, you do not have the option to add product recommendations to your checkout. However, you can still enhance your customer experience by adding recommendations or add images to your order status page or thank you page via content blocks.
FAQs
Can I add a widget to both the Thank You Page and the Order Status Page?
Yes, you can place the widget on both pages. You can either create a single widget that works across both pages or create separate widgets tailored for each page.
Can I customize the look and feel of the widget?
Absolutely! You can customize the text, product display, buttons, discounts, and styling. The widget settings allow you to change product titles, adjust button styles, and configure how products are displayed. You can also choose between carousel or grid views for products.
What happens if I disable the widget tracking and attribution tracking?
Widget tracking and attribution tracking are essential for performance tracking and dynamic discounting. If you disable these features, you will lose important performance and engagement metrics, which may impact your ability to optimize your customer engagement strategies.
How does the Add to Cart button work if a customer has already checked out?
Once the customer is on the Thank You Page or Order Status Page, they can still use the Add to Cart button to add additional products to their order. However, the additional item(s) will require a new checkout, and the original order will not be modified.
If you're looking to learn more about in-checkout recommendations or content blocks, you can review our help articles to get started.