With Postscript Onsite Opt-In (OOI), shoppers sign up for SMS inside your Alia popup. Instead of replying "Y" to a text, they enter a 4-digit code that appears in the popup and they're opted in. This article covers setup, the Postscript flow changes you need to make, consent requirements, and publishing. OOI removes keyword replies and off-site steps from signup, which can bring in more SMS subscribers.
Set up onsite opt-in
Connect Postscript to Alia
OOI needs an active Postscript integration. If you haven't connected it yet, see Integrating Alia with Postscript. You'll still pick a keyword when you connect, but OOI doesn't use it.
Turn on onsite opt-in for your phone step
In the popup editor, open the popup and go to the Phone Submission step.
Select the SMS submit button.
Go to Integration Settings → Postscript Settings and turn on On-site opt in.
OOI is set per phone step, not for the whole popup. If your popup has more than one phone step, turn it on in each one.
Set your welcome message
With OOI, you write the first welcome text in Alia instead of in Postscript.
In the popup editor, select the SMS submit button.
Enter your message in the Welcome Text field.
You can insert the discount amount, discount code, and discount link with Alia's expression variables. For example:
Thanks for subscribing! Here's your coupon for discount_amount off: discount_code Shop here: link_to_apply_discount
💡 Note: Postscript merge tags like {shop_name} won't fill in here, because Postscript resolves them, not Alia. If you're moving from a keyword flow, use your store's homepage URL, not the preview link shown in Postscript.
Add the verification step
Shoppers enter their 4-digit code in a verification step.
In the popup editor, select + Add Step.
Under Collection, select Verification.
Place the new step between the Phone step and the View Code step.
Your flow should read: Phone → Verification → View Code.
Skip verification for existing subscribers
Shoppers who are already subscribed to SMS don't need to verify again.
On the Phone step, select the SMS submit button.
Under When form is submitted, add a branch: if Postscript user SMS already subscribed, go to the View Code step.
Update your Postscript flows
With OOI on, Postscript attributes new subscribers to Third-Party Onsite Opt-In instead of a keyword. There are no Reply-Y opt-ins, keyword-triggered opt-ins, or keyword segments for Alia popup subscribers.
Remove keyword and Reply-Y filters
If any of your Postscript automations or welcome series filter on the following, remove those filters:
Keyword most recently triggered
Reply-Y conditions
Keyword-based popup segments
If your flows don't use keyword or Reply-Y filters, you don't need to change anything.
💡 Note: If you don't update these filters, some flows may stop triggering or send subscribers down the wrong welcome path.
Filter on Alia's properties instead
To segment Alia popup subscribers, filter on a custom property you add on email or SMS submission.
You can also filter on these properties, which Alia sends to Postscript automatically:
alia_ooi: set the value totrueto match every OOI popup, whatever its name.alia_opt_in_popup_id: find the value on the Campaigns page in Alia.alia_opt_in_popup_name: find the value on the Campaigns page in Alia.
Meet the consent requirements
Postscript checks your popup’s SMS consent text before it can publish. To pass the check, your consent text must:
Use the
sms_consentvariable. While Postscript is connected, Alia fills it with the SMS disclaimer from your Postscript account and keeps it up to date, so the wording matches what Postscript has on file. For a popup in Spanish or French, usesms_consent_esorsms_consent_frinstead. These show Postscript's approved translation. See Edit/translate SMS compliance text for the steps.Sit on the phone step, above the submit button.
Be real, visible text, not part of an image. Postscript reads it from screenshots of your popup.
To change the wording, update your SMS disclaimer in Postscript. While Postscript is connected, the legal fields in Alia’s popup editor only change your email consent text.
You can still change the consent text’s font size, color, and link styling in the popup editor. Keep it easy to read against the background.
Do I need a separate marketing agreement checkbox?
Not for US brands. You don't need a checkbox such as "I agree to receive marketing emails and text messages" on the SMS step with OOI. The consent text rules above still apply in full. If you sell outside the US, confirm the requirements for your region.
Test and publish your popup
Test the full flow
Before you publish, open the popup preview and check:
The verification code works.
Already-subscribed shoppers skip verification.
The welcome message arrives.
The consent text is visible.
Publish or mark as ready
When you publish an OOI popup or mark it as ready, Postscript checks it before it goes live, including whether your SMS consent text is visible and matches your store's consent wording. This can take up to 2 minutes. If there are no issues, the popup publishes.
If Postscript finds a problem, you'll see a message explaining what to fix. If you can't fix it, for example because your popup is in a language other than English, Spanish, or French, choose Ignore and publish anyway. The popup goes live without Postscript's approval, and the Alia team is told so they can follow up. This option isn't available if your Postscript integration isn't connected. See Troubleshooting your Postscript integration.
Your Postscript integration must be connected to publish. If it's missing or needs reconnecting, publishing fails with this message:
Postscript didn't accept the connection to your store. Check that the API key is still valid in Postscript, then disable and reconnect the integration.
To fix it:
In Postscript, go to API Keys, select Create Security Key Pair, and copy the Private Key.
In Alia, go to Integrations and disable the Postscript integration.
Reconnect Postscript using the new Private Key.
Publish the popup again.
Track opt-ins and results
Show opt-ins in Alia
To track net SMS opt-ins, go to Settings in Alia and turn on Show opt-ins.
View welcome message analytics
Analytics for the OOI welcome message live in Postscript, under Data & Insights → Messages → Message Analytics. There you can see sends, deliverability, engagement, and revenue attribution.
If the Postscript SDK is missing
OOI needs the Postscript SDK installed on your storefront. Without it, you may see an error and OOI won't work. To install it, see Postscript's developer documentation.
Still have questions?
Start a chat from inside the Alia app, or use the chat in our Help Center.









