The Popup Widget brings your reviews to shoppers wherever they are in your store. A small card slides into a corner with one review, stays a few seconds, then makes room for the next. A click opens the full review.
Shows on | Every page you choose: home, product, cart and the rest |
Add it from | Settings ▸ Widgets ▸ Popup Widget ▸ Add to theme |
Needs | The Quoli Core Script app embed |
Plans | Every plan |
Switch it on
The Popup Widget is an app embed: you switch it on once and it shows across your store, with no block to place.
In Quoli, open Settings ▸ Widgets and find Popup Widget.
Click Add to theme. Your theme editor opens at App embeds with the Popup Widget switched on.
Click Save.
To turn it off, switch it off in the same place and save.
What shoppers see
➀ Photo or video. The review's own photo, or its video playing muted. Text reviews show without one.
➁ Rating and date. The review's stars and when it was written.
➂ Who and what. The reviewer, with a check for verified buyers, and the product the review is about.
➃ Close. Hides the popup for the rest of the visit.
Pointing at a card holds it on screen. A click anywhere else on it opens the review in a popup with every photo and video.
Which reviews it shows
On a product page, the popup shows that product's reviews. Everywhere else, it shows your store's reviews.
Setting | What it does | Default |
Sort | Most recent, Highest rated or Most useful. | Most recent |
Show reviews with | Any review, photos, videos or text only. | Any review |
Minimum rating | All ratings, or 2, 3, 4 or 5 stars and up. | 3 stars and up |
Featured reviews only | Only the reviews you feature in Reviews with Add to carousel. | Off |
Timing
The first card arrives after the initial delay, stays for the display time, leaves, and the next arrives after the gap. After the most popups you allow, it stops on that page. Each new page starts the count again, and a shopper who closes it doesn't see it again during their visit.
Setting | What it does | Default |
Initial delay | Seconds before the first card, 0 to 30. | 5 s |
How long each shows | Seconds each card stays, 1 to 20. | 5 s |
Gap between popups | Seconds between cards, 1 to 30. | 8 s |
Max popups | How many cards each page shows, 1 to 50. | 12 |
Where it shows
Setting | What it does | Default |
Corner | Bottom left, bottom right, top left or top right. | Bottom left |
Distance from side, Distance from top / bottom | How far from the corner, 0 to 200 px. Raise it to clear a chat button. | 20 px each |
Show on mobile | Off hides it on phones. | On |
Home page, Product pages, Cart page | Show it on those pages. | On |
Other pages | Collections, search, blog and every other page. | On |
Card settings
Setting | What it does | Default |
Show media thumbnail | The review's photo or video. | On |
Show review date | When the review was written. | On |
Show product name | The product the review is about. | On |
Colors and fonts come from Settings ▸ Brand in Quoli.
Add it with code
On a theme where you'd rather place it yourself, paste the popup into your theme layout. The code is in Settings ▸ Widgets ▸ Popup Widget ▸ Instructions, with a Copy code button.
<quoli-popup
product-id="{{ product.id }}"
merchant-id="{{ shop.permanent_domain }}"
api-base="/apps/quoli"
data-product-name="{{ product.title | escape }}"
data-product-handle="{{ product.handle | escape }}"
></quoli-popup>Keep the Quoli Core Script app embed on. Pasted code uses the default settings above. On pages without a product, the popup shows your store's reviews.
💡 Tip: Set Show reviews with to Photos. A real customer photo in the corner catches the eye far more than text, and keeps each card short.