Skip to main content
The What it may say section holds the few things about the sentence that you state on purpose. They are saved as metafields on your shop, so Shopify is the record. Press Save and your store’s facts is rebuilt with the new values within a minute.

How to speak on the page

Choices:
  • Our one-line card (default). The dark card in the bottom corner. See What shoppers see.
  • Your popup tool. The app tells a popup tool you already run to show a campaign you designed, at the moment the shopper is stuck. This choice appears only after the app has seen the tool on your storefront (it looks once a day), so you are never offered a tool you do not have. Supported: Klaviyo forms, Privy, OptiMonk, Justuno, Wisepops.
  • A browser event, for your developer. The page fires a nextintent:moment event with the sentence, the link label and the link path. Nothing is drawn. Your developer decides what to do with it. See The card and the event in the developer docs.
  • Nothing on the page. The sentence is composed and recorded but not delivered. Useful for a store that wants the moments record without any delivery at all, which is the same as watch mode except the left-alone comparison still runs.

Setting up your popup tool

When you pick Your popup tool, three fields appear:
  1. Which tool. Only the tools seen on your storefront are listed.
  2. Campaign id. The campaign in that tool that should show. Build it there first, in your own style, and set its trigger to “custom event” or “show only when triggered” so it waits for us. Under the field is a one-line note on where that tool keeps the id.
  3. Campaign id for a declined code (optional). A second campaign used only when the sentence is about a discount code that did not take. Leave it empty to use the first for everything.
The sentence itself travels with the moment as a browser event, so a campaign can display it, or the campaign can carry its own wording.

How “helped” is confirmed with each choice

The app counts a shopper as helped, and bills the order, only when it knows the shopper saw something.
  • Our card: the card was drawn. The app drew it, so it knows.
  • Your popup tool: the tool confirms it displayed the campaign. Klaviyo and Wisepops report this themselves; for the others the app watches the page for the popup to appear. If nothing is confirmed within 8 seconds, the moment is recorded as “handed to your popup tool, it did not show” and is never counted or billed. The app does not show its own card in that case; you chose your tool, and two popups would be worse than none. If the tool is simply missing from a page, our card steps in for that shopper and counts as usual.
  • The browser event: your developer’s code calls NextIntent.shown(id) after it renders. Until it does, nothing is counted or billed; after 8 seconds the moment is recorded as “not confirmed”.
  • Nothing on the page: no shopper is ever helped and nothing is billed.
If your tool keeps failing to show, Home and Money say so: “Your popup tool did not show 12 of the moments we handed it this month.” Those shoppers heard nothing. Check the campaign id, that the campaign is live, and that its trigger waits for a custom event. The moment page for any of them shows the trail: handed to the tool, then shown and how we know, or not shown.

If your tool stops confirming

A store could let the sentence show and never confirm it, and would then never be billed. The app watches for that: ten or more hand-offs with fewer than half confirmed, ten or more of our cards with fewer than half reported shown, or the browser event with no confirmation at all. When that happens, a note appears under this choice, on Home and on Money: “Your popup tool is not confirming what it shows. Since [date], we count the moments we hand to it as helped, and bill on that.” For the rest of the month, hand-offs count. Fix the campaign id, make sure the campaign is live and waits for our trigger, or switch to our card; from the next month, confirmation counts again. The full rule is in What “helped” means.

May a card mention an offer?

Choices: No. Facts only. (default) or Yes, from my active discount codes. No: no sentence contains a discount, code or percentage, ever. A shopper whose code was declined is told the code is not valid here, then a fact: the free shipping line, or nothing more. Yes: a shopper whose own code was declined can be told a real code from your Discounts: “That code isn’t valid here. WELCOME10 takes 10% off a first order.” Only in that situation. A shopper who did not try a code is never offered one. See Discount codes for how codes are chosen and why offers are off by default.

Delivery promise

A short line, for example: “Ships in 1 to 2 business days.” Used for: a shopper who stalls on a shipping or delivery question can be told when their order ships. The app cannot read this from Shopify, because Shopify has no single field for it, so you state it here. Leave it empty and no sentence mentions delivery time.

Size guide path

A path on your store, for example: /pages/size-guide. Used for: the link under a size sentence. A shopper flipping between sizes on a hoodie page sees the product’s note with “Size guide →” beneath it, pointing here. Rules: it must be a path on your own store, starting with /. Full URLs to other sites are not accepted, because a card never links off your store. Leave it empty and size sentences have no link.

Saving and clearing

Press Save. The values go to Shopify as metafields and the sheet is rebuilt. To clear a value, empty the field and save.

Sentences we will not say

Under the fields, two lists built from Don’t say this on What we said. The engine checks both before it composes anything. Muted sentences. Each is shown struck through, with Allow again. A muted sentence, or one that means the same thing, is never shown again on any page to any shopper, and nothing is said in its place unless another fact fits the moment. Press Allow again and it comes off the list; the app may say it again when it fits. Replacements. Each reads “Instead of X we say Y”, where Y is the sentence you typed in Say this instead. Two buttons: Edit opens the sentence in place so you can change the wording and Save; Allow the original again removes the pair, so the app goes back to its own sentence. If the engine refused your version in a moment this month, a line under the pair says why, in plain words: “We could not say your version because it says returns are free and the policy does not.” Edit the sentence, or fix the fact it rests on, and it runs from the next read. Each list holds fifty, newest kept. When both are empty the section says “None. Every sentence shown so far has stood.” Why it is here and not only on What we said: this page is where you decide what the app may say. The sentences you have ruled out, and the ones you wrote yourself, belong beside the facts they draw from, so you can see both at once. If the app keeps composing wrong sentences about returns, the return window above is the thing to fix, not the list below.

Send the moment to Klaviyo

A separate switch, shown only when Klaviyo has been seen on your storefront. When it is on, the page tells Klaviyo why a shopper it already knows got stuck and what we said, so your abandoned-cart email can swap its generic sentence for the real reason. Nothing about the shopper is sent; Klaviyo already knows them. Shoppers who were just looking get nothing extra; that is correct. The block to paste and the way to prove it are on Klaviyo: the reason in your email.