Skip to main content
All CollectionsOneClickUpsell for Shopify - Tutorials & DocumentationThank You Page Offer
Migrating to Enhanced Thank You Page Offers: Embracing Shopify's Checkout Extensibility [OCU]
Migrating to Enhanced Thank You Page Offers: Embracing Shopify's Checkout Extensibility [OCU]

Discover how OCU is adapting the TY Page Offer to Shopify's new "Checkout Extensibility" version!

Jeff Maxfield avatar
Written by Jeff Maxfield
Updated over a week ago

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.

  • August 28, 2025: Deadline to upgrade your 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 Theme Editor

After enabling Extensibility, you should add the "TY/OS Upsell" app block in the Shopify Theme Editor to display offers on both the Thank You (TY) and Order Status (OS) pages.

Follow the simple steps outlined in our informative popup. Click the "Go to Theme Editor" button, then choose either "Thank You Page" or "Order Status Page" to add it. You can use the theme editor to drag & drop the TY/OS Upsell app block into the desired location on the pages as well. Once added and placed to your liking, click the "Save" button:

πŸ“We strongly advise adding 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:

  1. Accept Offer button position - Button below

  2. Accept Offer button alignment - Align right

  3. 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:

  1. Select specific Variant(s) to use for the offer

  2. Toggle on the "Hide Variant Selector" option

  3. Set a Discount for the offer:

    1. None - no discount, use full product price.

    2. Percentage - enter in the % off you'd like to offer the product at.

    3. Fixed amount - enter the $ amount off you'd like to offer the product at.

    4. 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.

  4. Toggle on the "Hide Quantity Selector" option

  5. Toggle on the "Offer Description" element

  6. 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:

  1. Side button - Shows the "Add" button on the right side of the offer

  2. 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. 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.

2. 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.

3. 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.

Did this answer your question?