This article is for non-Shopify merchants only.
How the post-purchase popup fits in the customer flow
A customer completes a purchase on your store → on the purchase-completed (Thank You) page, the post-purchase popup appears with a signup form to join your referral program. If they sign up, they become an enrolled advocate (if they meet your campaign's Target audience), or get waitlisted if they don't qualify yet.
This widget captures customers at the highest-intent moment: they just chose to spend with you, so they're most likely to share with friends. It's installed by pasting a code snippet on your store's purchase-completed (Thank You) page.
Note: The post-purchase popup is a one-shot, trigger-based widget — it only appears immediately after a purchase. Unlike the Embedded signup widget or Floating Referral Widget, it isn't a login surface that already-enrolled advocates can come back to.
For how this widget compares to the other Other Platforms referral surfaces (Embedded signup, Floating Referral Widget, Cookie consent) and which to use when, see Widgets for your referral program.
Note: Your campaign must be live for the post-purchase popup to appear.
Enable the post-purchase popup
Email and API integrations
If your store is integrated with ReferralCandy via Email or API Integration, add a code snippet to your store's purchase completed page:
On the ReferralCandy dashboard, go to Campaigns > Select your campaign.
Go to Widgets.
Toggle the Post-Purchase Popup widget on.
Check Allow signup/waitlist for unqualified customers. Learn more
Click Save Changes.
Go to the code snippet and click Copy.
Paste the code snippet into your store site's purchase completed page before the
</body>tag. For some platforms, there may be a box for you to insert scripts that you want to run on the "Thank You" or purchase completed page.Edit the
data-attributesin the code to include dynamic variables relevant to your store. The snippet is pre-filled with dummy values that you need to replace to reflect your the store site's dynamic checkout variables.Save the changes.
JavaScript integration
If you're using JavaScript integration, refer to this article: [Other Platforms] JavaScript integration.
Cratejoy
If you're using ReferralCandy with your Cratejoy store, refer to this article.
Customize the popup widget
Allow signup/waitlist for unqualified customers
When this is checked, the widget shows the signup form for customers who aren't qualified to enroll. If the customer fills out the form, they are added to your contacts, but won't get their referral link just yet.
Note: Other forms and widgets, such as the Join Page, Embedded signup, and Floating Referral Widget, allow unqualified customers to be waitlisted upon signup. You can only disable the signup form for the post-purchase popup.
Waitlisted contacts become advocates once they meet the segment conditions you set for the campaign. Once qualified, they are notified via email that they're now enrolled in your campaign, and can start referring their friends.
Popup behavior based on enrollment state
Popup behavior based on enrollment state
If Allow signup/waitlist for unqualified customers is unchecked, the popup doesn't show up for unqualified customers. If checked, and the customer was never enrolled in the campaign before, here's how the widget would look like:
Enrolled contacts receive their referral link. They can start sharing the referral link with friends to earn rewards.
Never enrolled (new customer) contacts that aren't qualified to enroll see the signup form. If they fill out and submit the form, they are Waitlisted for the campaign. They remain on the waitlist until they meet the segment criteria.
Unenrolled contacts do not see the post-purchase popup widget at all. These are contacts who were previously enrolled but stopped meeting the segment criteria targeted by the campaign.
Read more about targeted segments and campaign enrollment.
Edit the content of the popup widget
The post-purchase popup widget's content (banner, headers, button labels, etc.) is customized in your campaign's Themes editor (Customize campaign > Themes). This is where you edit the branding and content of all your campaign's emails and pages, including the post-purchase popup. To learn more, see: Widgets for your referral program and Customizing your referral emails, pages, and widgets.
Obtain consent to receive marketing emails
Obtain consent to receive marketing emails
You should always obtain consent from your customers before enrolling them in your referral or affiliate program. We recommend including a form input, unchecked by default, that says "I consent to receive notifications about your referral program."
If your customer consents to receiving emails, they will receive a campaign email after purchase regardless of how they interact with the post-purchase popup.
If your customer does not consent to receiving emails, your customer only receives a campaign email if they click the "Share Invite Link" button in the post-purchase popup.
If you'd like to prevent customers who don't consent from receiving any marketing emails about your campaign, let us know — this requires a developer to set the data-accepts-marketing field in the post-purchase popup HTML snippet, and we can help you wire it up correctly.