Overview
Shopify has announced the deprecation of Script Tags functionality, which affects our current approach for supporting Thank You Page offers. Therefore, all existing and new merchants are encouraged to migrate to the "Checkout Extensibility" versions of Thank You & Order Status pages as soon as possible, for enhanced customization and continued support for upsell offers on those pages.
February 1, 2025: Deadline to upgrade for all non-Plus Shopify merchants.
August 28, 2025: Deadline to upgrade for Shopify Plus merchants.
πApplies to Thank you and Order status pages, including your apps using script tags and additional scripts.
OCU has implemented a check to determine if TY Page extensibility is available for your store. If extensibility is available, we'll inform you via an in-app notification in the "Thank You Page Upsell" section within an upsell funnel. We recommend enabling it, by clicking the link in the banner and following the Shopify instructions:
After enabling Extensibility and publishing the new versions of your Thank You and Order Status Pages, it is recommended to re-enable the OCU app in the Settings > General section by clicking the "Application Status" switcher off and then on again.
This will expedite the start of the offer migration process and trigger immediate migration. Although OCU will initiate migration automatically, there may be a delay of up to 24 hours before it begins.
π Beginning April 2024, new Shopify merchant shops on Basic, Shopify and Advanced plans will default to extensibility for Thank You and Order Status pages.
Adding the Offer using the Checkout Editor
After enabling Extensibility, you should add the "TY/OS Upsell" app block in the Shopify Checkout Editor to display offers on both the Thank You (TY) and Order Status (OS) pages. Follow the simple steps outlined in our informative popup or refer to the steps below:
π If there are no active published funnels with a TY page offer within OCU, the TY offer widget app block won't render in the Shopify Checkout Editor.
1. Click the "Go to Shopify editor" button in the top-right of the builder and select either "Thank You Page" or "Order Status Page", depending on which one you want to add the app block to:
β
2. In the Checkout Editor, click the "+ Add app block" button depending on where you want the offer widget shown:
β
β
3. Select the "TY/OS Upsell" app block by clicking on it:
β
4. Adjust the app block location via drag & drop if desired, then click the "Save" button:
5. Repeat these steps on the Order status page if desired (recommended):
π To remove the app block from your TY or OS pages, click on it in the editor (1) then click the "π Remove app block" button (2) at the bottom or on the ellipse (...) then on the "π Remove" button. Then click Save:
πIt's strongly advised to add the "TY/OS Upsell" app block on both the Thank You and Order Status pages in the Shopify Editor. This ensures that the offer will be displayed correctly on both pages. Otherwise, it will only appear on the page where the app block was added.
Customizing the Offer
For existing users who are using the previous TY Page Offer version, after extensibility is enabled, the Offer Builder layout will be changed.
Existing offers templates will be automatically migrated to the new format. The default offer layout after migration will be:
Accept Offer button position - Button below
Accept Offer button alignment - Align right
Offer setting (such as timer, discount, applied styles etc.) will also be automatically migrated
π It's recommended to check all existing Thank You (TY) offers after enabling extensibility, to ensure that all style settings applied to the TY offers before migration are clearly represented in the new offer format.
Hover over and click on a text element to edit the text content and styles using the inline text editor:
The sidebar of the builder contains Incentive, Buy Box and Button tabs where additional customization can be applied:
Incentive
In the Incentive tab, you can enable the Timer element and select a Time Limit of 3, 5, or 10 minutes:
Buy Box
In the Buy Box tab, you can:
Select specific Variant(s) to use for the offer
Toggle on the "Hide Variant Selector" option
Set a Discount for the offer:
None - no discount, use full product price.
Percentage - enter in the % off you'd like to offer the product at.
Fixed amount - enter the $ amount off you'd like to offer the product at.
Compare at price - uses the "Compare at price" you've set for your product in Shopify admin. *πThis discount option does not actually discount your product price like percentage and fixed amount do.
Toggle on the "Hide Quantity Selector" option
Toggle on the "Offer Description" element
Toggle on the "Hide offer if..." setting to not show the offer if the same product was already purchased at checkout. If you enable this setting, there will also be 2 different Quantity conditions available to choose from:
In any quantity - Hides the upsell from showing if any quantity of the same product is purchased at checkout.
In quantity of more than - Hides the upsell from showing if the quantity purchased is greater than the number you set.
Button
In the Button tab, you can choose the button position:
Side button - Shows the "Add" button on the right side of the offer
Button below - Shows the "Add" button below the offer
If the "Button below" position is selected, then Button Size (S/M/Auto/Full) and Button Alignment (Left/Center/Right) settings also become available:
π The font color for the button will use the "Accent" color set in your Shopify Checkout Editor:
Previewing the Offer
The interactive preview (1) and preview modes (2) in the Offer Builder will not display the actual offer placement on Thank You (TY) or Order Status (OS) pages. As noted, the default offer placement will be shown in preview. Actual appearance may differ depending on the location set in the Shopify Editor:
You can only preview the actual offer placement directly on your store pages or in the Shopify Theme Editor. The offer placement can be adjusted in the Shopify Editor by simply dragging & dropping the OCU extension into the desired page sections.
Important Notes
1. The updated extensibility version of the Thank You Page offer now supports multi-currency checkouts! This ensures that customers placing orders in a currency other than your Shopify store's default currency will still see the offer.
π The offer will initially be presented to your customers in your default store currency, but when accepted and paid for, it will automatically convert to match the customer's checkout currency.
2. Due to certain limitations in Shopify, we are unable to display errors directly during the buyer flow in checkout. Therefore, in the event of issues with a product (such as it becoming out of stock) when a customer clicks the 'Accept Offer' button, we will show a proxy page with an error description. While this is an edge case and typically not encountered, it currently serves as our only means to communicate problems to the end user.
3. Another limitation from Shopify concerns Draft Orders during pre-purchase, resulting in our Thank You and Order Status offers not being displayed if the customer completes their order on a Draft Order Checkout. When using either the "percent" or "fixed amount" discount for pre-purchase, or one of the multi-product incentives, OCU creates a draft order to auto-apply the discount amount to the checkout. While Shopify has committed to resolving this issue late 2024, we currently lack a solution for such cases.
4. When Shopify fully deprecates Script Tags functionality, merchants will no longer have the ability to migrate from extensibility back to script tags. If a merchant turns off extensibility, their offer templates will revert back to the 'old' format, and offers will be displayed accordingly. While we do not recommend this action, in the event that a merchant does proceed, we strongly advise checking all offers in the builder and making any necessary style adjustments.