Upsells
Overview
Your agent can build and manage your StoreFront upsell funnel. A path decides who is offered what, and where in checkout (before or after). An offer is one thing offered: its price, schedule, items and rules. Each offer also has a page, its container, which the agent builds like any other page.
The agent builds paths and offers switched off. You preview the offer page, and the path or offer goes live only when it is switched on with your approval.
Example requests
- "Create a post-checkout upsell offer for the wool scarf at 20% off, on a new path for customers who bought the field jacket. Leave both switched off."
- "Build the offer page with the scarf's photo, the price and Yes and No buttons, and show me a preview as it would appear after checkout."
- "Duplicate this offer and try a different headline on the copy."
- "Move the holiday path to the top of the order."
Commands
| Command | What it does |
|---|---|
sf upsells paths list, get, create, update | Read, create and change upsell paths |
sf upsells paths move, duplicate, archive, unarchive, disable | Reorder, copy, file away or switch off a path |
sf upsells offers list, get, create, update, duplicate, disable | Read, create, change, copy or switch off offers |
sf upsells paths enable, sf upsells offers enable | Switch a path or offer on, with your approval |
sf containers pull, sf containers push with --owner-type upsell | Edit an offer's page |
sf preview stage --upsell, sf preview open --upsell | Preview an offer page as checkout shows it, even while it is switched off |
Live and shared changes
Every upsell write needs --live and write permission. Changing a path or offer that is switched on also needs publish permission. Updates replace the whole path or offer, so the agent reads it into a file, edits the file and writes it back, checked against the version it read.
What it cannot do
- Delete a path or offer. Switch it off, and archive a path; deleting is done in the admin.
- Create the items an offer sells. The items must already exist; create them in the Item Editor first.
- Switch anything on without
enable. Creating, updating or unarchiving never switches a path or offer on.
What needs approval
sf upsells paths enable and sf upsells offers enable: switching a path or offer on is the only way one goes live, and it always needs approval. See Changes that need approval.
Related documentation
- Upsells: how upsell paths and offers work in the admin
- Checkout and My Account: the checkout the upsells appear in