Skip to main content
Reference

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​

CommandWhat it does
sf upsells paths list, get, create, updateRead, create and change upsell paths
sf upsells paths move, duplicate, archive, unarchive, disableReorder, copy, file away or switch off a path
sf upsells offers list, get, create, update, duplicate, disableRead, create, change, copy or switch off offers
sf upsells paths enable, sf upsells offers enableSwitch a path or offer on, with your approval
sf containers pull, sf containers push with --owner-type upsellEdit an offer's page
sf preview stage --upsell, sf preview open --upsellPreview 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.

Was this page helpful?