Checkout widgets (Shopify)
Checkout widgets are blocks you design in Personizely and show inside Shopify checkout and on the thank you page: one-click upsells, trust badges, shipping messages, countdowns and post-purchase offers. You build them in the same widget builder, target them, A/B test them and measure their views, clicks, conversions and revenue like your other widgets.
Available on: Shopify Plan: checkout steps (information, shipping, payment) need Shopify Plus. The thank you page works on every Shopify plan except Starter.
How it works
- You create a checkout widget from a template or a blank block, and choose its page and its position on that page.
- In Shopify's checkout editor, you add the Personizely checkout widgets block at that position. This is a one-time step for each position you use.
- When a shopper opens checkout, the block asks Personizely which widgets to show there. Widgets whose rules and targeting match appear in the block, using Shopify's checkout components, so they look like the rest of your checkout and follow its branding.
- If the targeting depends on the order (cart value, cart items, market), the block checks again when the shopper changes the order, and shows or hides widgets to match.
Checkout widgets don't have triggers: a widget shows as soon as the checkout loads, when its rules and targeting match.
Create a checkout widget
- Go to Widgets → Create widget and choose Checkout widget.
- Pick a template. Each card shows a preview, the page and the position the template starts at:
Template | What it is | Starts at |
|---|---|---|
One-click upsell | A product shoppers add to their order with one click | Order summary, after the items |
Trust badges | Free shipping, returns and secure payment badges | Before the pay button |
Money-back guarantee | A short guarantee message | After payment methods |
Shipping message | A banner for free shipping, delivery dates or holiday cut-offs | After shipping methods |
Thank you offer | A discount code for the next order | Below the confirmation (thank you page) |
Blank | An empty block | Order summary, after the items |
- Name the widget and click Create. The builder opens.
Without Shopify Plus, the templates for the checkout steps are locked, and Blank starts on the thank you page.
Placement
In the builder, the widget's Settings tab sets where it shows:
Option | What it does | Values |
|---|---|---|
Page | The page the widget is on | Checkout (Shopify Plus) or Thank you page |
Position | Where on the page it shows | Checkout: Below the header, After contact, After the delivery address, After shipping methods, After payment methods, Before the pay button, Order summary, after the items, Order summary, after the discount field. Thank you page: Below the confirmation, After the customer information, Order summary, after the items |
You can also drag the widget on the checkout preview: hover a line between sections and click Move here.
Under the position, the builder shows whether your checkout has the Personizely block there: The block is in your checkout (with the date it was last seen), or Add the block to your checkout with a link to Shopify's checkout editor. When you start a widget whose block wasn't seen at its position yet, the builder shows the steps to add it. After adding the block, open your checkout or the checkout editor's preview, then click Check again.
Shopify only shows the widget where your checkout has the Personizely block. Several checkout widgets can share one block position.
Elements
Checkout widgets have their own elements, built from Shopify's checkout components. Add them from the Add tab, or add a ready-made group from Presets: Trust badges, Customer review and Sale countdown.
Element | What it does | Main options |
|---|---|---|
Heading | A heading | Text |
Text | A paragraph, with bold, italic and links | Size (Base, Small), alignment, tone, color |
Banner | A highlighted message with an icon | Title, text, status (Info, Success, Warning, Critical) |
Image | An image | Image, alt text, width, aspect ratio, corner radius |
Button | A button or link | Label, optional icon, style (Primary (filled), Secondary (outlined), Link), width, action and automations |
Product offer | Products the shopper adds to the order in one click | Products (Manual or Rules), Show up to, Skip in order, automations, parts (image, title, rating, price, variant picker, button) |
Cart progress | How far the order is from a spending goal, with a progress bar | Threshold per currency, text for each state |
Timer | A countdown | Deadline (Interval or Date), units, separator, what happens when it ends |
Icon | An icon from Shopify's checkout icon set | Icon, size, tone |
Divider | A horizontal line | None |
Container | Groups elements in a column or a row | Direction, alignment, spacing, padding, background, border, corner radius |
Styling uses Shopify's checkout design options (sizes, tones, spacing, backgrounds, borders), not custom CSS, so widgets follow your checkout's branding.
Button action and automations
Like the button of other widgets, a checkout button has an Action (what the click does) and Automation (what runs with the click), in its Interaction tab.
Action | What it does |
|---|---|
No action | Nothing (the automations still run) |
Open URL | Opens the URL in a new tab, so the shopper stays in checkout |
Close widget | Hides the widget for the rest of the page, once the automations are done |
Checkout widgets offer these automations:
Automation | What it does | Where |
|---|---|---|
Track widget conversion | Counts the click as a conversion. Added to new buttons | Checkout and thank you page |
Add a product to the cart | Adds the product and variant you pick to the order | Checkout only |
Apply discount | Applies the discount code you set to the order | Checkout only |
A button can have several, for example adding a product and applying a code with one click. If one fails (a refused code), the ones before it stay done, the click still counts and the button shows the error. Apply discount applies a code you set: checkout widgets don't generate unique codes.
Product offers
- Manual offers the products you pick. Rules offers the products of a rule set, matched against the items in the order, up to the number in Show up to (1 to 3).
- Prices are the shopper's market prices. Products that are unavailable, or not sold in the shopper's market, are left out.
- With Skip in order on, products already in the order aren't offered.
- Like the Products element of other widgets, an offer's automations are Track widget conversion (added to new offers) and Apply discount, which applies its code together with the product.
- Rating shows the rating your review app (Judge.me, Loox, Okendo, Yotpo and others) gives the product.
Cart progress
Set the order subtotal to reach in your store currency and, for other markets, in their currencies. A checkout in a currency without a threshold doesn't show the cart progress. The texts can use {amount}, what's left to spend in the shopper's currency.
Timer
Interval starts when the shopper first sees the timer and keeps counting when they come back. Date counts down to a fixed date. When it ends, the timer can do nothing, hide itself or hide the widget.
Targeting and rules
Checkout widgets support three display rules: Target, Days of week and Timeframe.
In targets, these targeting filters work in checkout:
- From the checkout: cart value, cart items, cart size, market, locale, location, weather, device, browser, OS and time.
- About the visitor: visitor fields, visit and page view history, first visit, first and last page view, entry page, widget, goal and event history, referrer, UTM parameters, order history, and email list and tag membership.
The builder only offers these filters for checkout widgets.
A/B testing
Checkout widgets support experiments like other widgets: variations with their own content, an optional control group that sees nothing, and an even or custom split.
- All variations of an experiment are on the same page (checkout or thank you page). Each variation can have its own position.
- A shopper who visited your store keeps their group on later checkouts. A shopper without a store visit keeps it for the whole checkout.
- The control group is counted at the first variation's position.
Analytics
Metric | What's counted |
|---|---|
Views | Once per checkout page, when the widget actually shows |
Clicks | Button clicks and products added from an offer |
Conversions | Clicks on buttons and products added from offers that have the Track widget conversion automation |
Goals and revenue | Purchases and other goals, credited to the widget like for other widgets |
Track widget conversion is added to new buttons and product offers, in their Automation section, like for other widgets. For a button, the click counts once its other automations are done (a product added, a code applied).
Shoppers who reach checkout without visiting your store first (Buy it now, checkout links in emails) are tracked from checkout, so their views, clicks and purchases are counted too.
Behavior details and limitations
- Shopify Starter has no checkout widgets. Shopify doesn't allow checkout blocks on that plan.
- The checkout steps need Shopify Plus. On other plans, only the thank you page can show widgets.
- Nothing on the thank you page can change the order. Product offers, cart progress and buttons with the Add a product to the cart or Apply discount automation only work in checkout, so a widget that has them can't be moved to the thank you page.
- A widget with an empty offer doesn't show. If a product offer has no products to offer (none match, all unavailable or already in the order), the widget isn't shown and gets no view. Once a widget has shown, it stays when its offer runs out during the checkout.
- A widget appears once its offers are loaded, a moment after the checkout itself.
- Targets that can't be checked hide the widget. A target with a filter that doesn't work in checkout (for example a cookie or page URL filter), or with widget history limited to the current session, hides the widget in checkout.
- Visitor filters use the shopper's store visits. History filters limited to the current session count the session the shopper was in on your store, so you can show a banner to shoppers who viewed a page in this session. A shopper who reaches checkout without visiting your store first (a checkout link in an email, another device) counts as a new visitor.
- No triggers, frequency rules or close button. A checkout widget shows as soon as checkout loads and stays until the page changes.
- No custom CSS, HTML or JavaScript. Shopify's checkout only allows its own components.
- Without consent, no IP address is stored for the events, like on your store.
Troubleshooting
- The widget doesn't show in checkout → the Personizely block isn't at the widget's position → add it in Shopify's checkout editor at that position, then click Check again in the builder.
- The widget shows on the thank you page but not in checkout → your store isn't on Shopify Plus → move it to the thank you page, or upgrade to Shopify Plus.
- A product offer widget doesn't show → the offer has nothing to offer → check that its products are available in the shopper's market, not already in the order with Skip in order on, or that the rule set matches the order.
- The cart progress doesn't show → the checkout's currency has no threshold → add a threshold for that currency.