Thank You Page (TYP) widgets in Aftersell are a powerful way to engage customers after a purchase and increase sales. This guide provides step-by-step instructions for configuring and enabling TYP widgets within your post-purchase funnels. TYP widgets work in conjunction with Post-Purchase offers, providing multiple opportunities to maximize customer conversions after checkout.Documentation Index
Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
Use this file to discover all available pages before exploring further.
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
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.- 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
Product selection
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
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 and order handling
Discounts and 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
- These options have different trade-offs. See Order Handling for guidance, especially if your upsell catalog overlaps with your top-sellers.
- Enable free shipping on upsells (if using “Create new draft order”).
- Enable “Free Shipping” badge to highlight the benefit (optional).
Configure FAQ widgets
- 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
- 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
- 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
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 3: Publish your changes
- Review the page 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 on the 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.
Custom code widgets are recommended for advanced users only. Consider hiring a Shopify Expert if you need assistance.
Troubleshooting
Widget not displaying
Widget not displaying
- Verify funnel status is set to Active.
- Check that funnel triggers match your test order conditions.
- Confirm widgets are enabled in the funnel configuration.
- Ensure the widget block is added to the Thank You page in the Shopify editor and positioned toward the top of the page.
Thank You page not triggering
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.
Limitations
Countdown timers are not available on the Thank You page. This is a Shopify platform restriction and cannot be changed within Aftersell.
Want to go further?
- Post-Purchase Best Practices - tips to improve conversion across all your offers
- How to Configure Post-Purchase Offers - set up your full post-purchase funnel