What are Thank You Page widgets?
Thank You Page widgets allow you to display additional content and product recommendations to customers immediately after checkout. They are highly customizable and do not face the same Shopify limitations as 1-click upsells. Thank You Page widgets enable you to:- Tailor offers to specific customer actions (funnel triggers)
- Showcase personalized product recommendations
- Engage customers in a non-intrusive way
- Add FAQs, text content, Images and custom code to your Thank You page
- Tailor offers to specific customer actions (funnel triggers).
- Showcase personalized product recommendations.
- Engage customers in a non-intrusive way.
Step-by-step setup guide
Step 1: Create or select a funnel
- Navigate to Post Purchase Funnels in your Aftersell admin
- Click Create New Funnel or select an existing manual funnel
- Name your funnel (e.g., “Thank You Page Upsells - All Orders”)

Step 2: Configure funnel triggers
Define when your funnel should run. The triggers you set here apply to the entire funnel, including both Post-Purchase offers and Thank You Page widgets. Thank You Page widgets do not have separate trigger settings. Whatever triggers are configured for the funnel will also determine when the corresponding Thank You Page widgets display.- Customers sometimes skip the Thank You page if they close the browser immediately after purchase. Reassure them to allow the page to load.
- Ensure that the Thank You page offers are correctly set up in the Shopify Editor.
- In the funnel settings, click Triggers
- Select trigger conditions based on:
- Customer tags
- Product purchased
- Cart value
- Order count
- Collection
- Discount codes used
- Click Save Triggers
Step 3: Add TYP widgets to your funnel
- Scroll to the Thank You Page section in your funnel
- Click Add Widget
- Choose from available widget types:
- Product Recommendation - Display up to 10 upsell products
- FAQs - Answer common customer questions
- Text - Share messages, discount codes, or brand stories
- Image - Display a custom image or banner
- Custom Code - Add custom React components (advanced)
Configure product recommendation widgets
If you selected a Product Recommendation widget:Product selection
- Choose your product selection method:
- Specific Products - Manually select products to display
- Automatic Upsells - Let Aftersell recommend products based on cart contents
- Collections - Display products from a specific collection
- Set the maximum number of products to display (up to 10)
- Enable Hide purchased products to avoid showing items already in the order
- Enable Hide out-of-stock variants to only show available products
Offer design
- Choose layout orientation (horizontal or vertical)
- Add banner text to introduce your offer (optional)
- Configure compare-at price display settings
- Select discount price color from:
- Checkout branding colors (Accent, Decorative, Info, Subdued)
- Preset colors (Success, Warning, Critical)
- Enable quantity selector if you want customers to choose quantities
- Set minimum and maximum quantity limits (optional)
Discounts & order handling
- Apply a discount (optional):
- Choose percentage or fixed amount
- Customize discount text and discount color
- Select order handling method:
- Modify original order - Adds upsell to existing order (free shipping automatically applied)
- Create new draft order - Creates separate order for upsell
- Enable free shipping on upsells (if using “Create new draft order”)
- Enable “Free Shipping” badge to highlight the benefit (optional)
Configure FAQ widgets
If you selected an FAQ widget:- Click Add FAQ Item
- Enter your question text
- Enter your answer text
- Repeat for additional FAQ items
- Reorder items by dragging and dropping
- Click Save
Configure text widgets
If you selected a Text widget:- Enter your heading (optional)
- Add your text content in the editor
- Format text using the toolbar (bold, italic, lists, links)
- Click Save
Configure image widgets
If you selected an Image widget:- Click the upload area to add your image
- Upload a JPG, PNG, or supported image file
- Adjust the Image width slider (50–500px) to control how large the image appears
- Click Save
Save your funnel configuration
- Review all widget settings
- Click Save Funnel at the top of the page
- Set funnel status to Active
Enabling widgets in Shopify
⚠️ Critical step: Widgets will NOT display to customers until you add them to both the Thank You page AND Order Status page in Shopify.Step 1: Open Shopify editor
- In your Aftersell admin, click Open Shopify Editor
- This opens the Shopify checkout customization editor

Step 2: Add widgets to Thank You page
- In the Shopify editor, navigate to Thank You page
- Click Add app block or Add section
- Select Aftersell TY Widgets from the list
- Position the widget block where you want it to appear
- Click Save

Step 4: Publish your changes
- Review both pages in the preview
- Click Publish in the top-right corner
- Confirm the publication
Testing your widgets
Shopify’s checkout preview may not always display widgets correctly. Follow these steps to test:- Set triggers to “Show for all customers” (temporarily) to see widgets in preview
- Place a test order using a real checkout flow:
- Use Shopify’s test payment gateway
- Create a free product for testing
- Use a discount code to make the order $0
- Verify widgets appear:
- Thank You page (immediately after checkout)
- Test widget functionality:
- Click product recommendations
- Verify checkout flow for upsells
- Confirm order handling works as configured
- Reset triggers to your desired targeting rules after testing
Advanced configuration
Combining with 1-click post-purchase upsells
For maximum conversion, combine TYP widgets with 1-click post-purchase offers:- Add Post-Purchase Offers to your funnel (before Thank You page)
- Configure TYP widgets as a second touchpoint
- Customers who decline post-purchase offers will still see TYP widgets
- This creates multiple conversion opportunities in the customer journey
Using custom code widgets
For advanced customization, you can create custom widgets using React:- Select Custom Code widget type
- Write your component using Shopify’s Checkout UI Extension library
- Ensure your code:
- Exports the component as
export default - Uses UI extension components (not DOM elements like
div,p) - Does not import external code
- Exports the component as
- Test thoroughly before publishing
Troubleshooting
Widget not displaying
- Ensure widgets are added to both Thank You page AND Order Status page in Shopify editor
- Verify funnel status is set to Active
- Check that funnel triggers match your test order conditions
- Confirm widgets are enabled in the funnel configuration
Thank You page not triggering
- Customers sometimes skip the Thank You page if they close the browser immediately after purchase
- Ensure Thank You page offers are correctly set up in the Shopify editor
- Verify the widget block is positioned correctly on the page
By following these steps, you can maximize the effectiveness of Thank You Page widgets in Aftersell, enhancing both customer experience and your business’s revenue potential.
- Individual vs. Standardized Setup: - Each funnel’s Thank You Page upsells must be customized individually, as there’s no option to standardize them across multiple funnels. This design ensures that all offers are specific to the triggers and customer behavior for a particular funnel.
By following these steps and recommendations, you can maximize the effectiveness of Thank You Page Upsells in Aftersell, enhancing both customer experience and your business’s revenue potential.