Documentation

How the engine actually decides.

Setup, the full discount reference, and the resolution rules that determine which campaign wins a cart.

Theme
following your system · dark

Quickstart

Installing Sconta creates one automatic discount in your Shopify admin, named Sconta engine. Leave it enabled — every campaign you build runs through it. Deleting it stops all campaigns.

01
Install and approve the charge

The free plan needs no card. Shopify shows the app’s scopes before you approve.

02
Set your resolution rule

Settings → Resolution. Defaults to best value for the customer. This is the only store-wide setting that matters.

03
Build your first campaign

Pick a discount type, set the scope, save as draft. Drafts never affect your storefront.

04
Test it in the simulator

Build a cart, choose a customer, and read the trace: which campaigns qualified, which were blocked, and why.

05
Activate

Live within seconds. Carts already in progress pick up the new pricing on their next update.

Discount reference

Six types. Each has its own field set; all six share the condition, scope and stacking layers.

Type
Key fields
Percentage off
percent · cap · unit limit
Fixed amount off
amount · per order | per item
Buy X get Y
buy set · get set · reward · pick rule
Tiered / volume
thresholds[≤10] · basis · reward
Fixed price
price per market · scope · guard
Free shipping
rates · destinations · threshold

Discounts are calculated on pre-tax line prices and never reduce a line below zero.

Conditions

Conditions decide who qualifies. Scope decides what gets discounted. They're evaluated in that order, and all conditions on a campaign must pass — conditions are ANDed, never ORed. To express an OR, run two campaigns in the same stacking group.

qualify customer.tag = wholesale
qualify cart.subtotal >= 250.00
target collection:outerwear − tag:clearance
reward percentage 15% cap 120.00
stack stackable group:wholesale

The dashboard shows this summary under every campaign. It's a readout, not a language you have to write.

Stacking & resolution

For every cart, Sconta finds all campaigns whose conditions pass, enumerates the combinations that stacking rules permit, then picks one using your store-wide resolution rule.

A standalone campaign can only be alone.

Any combination containing it and anything else is discarded before scoring.

Stackable campaigns need a shared group.

Two stackable campaigns in different groups can’t appear in the same combination.

Always-combine campaigns join every combination.

Including combinations built around a standalone campaign — they are the one exception to the standalone rule.

Ties break toward more campaigns applied.

When two combinations produce an identical discount, the one with more campaigns wins, so the customer sees the fuller breakdown.

Percentages compound on the remaining amount.

Two stacked 10% discounts total 19%, not 20%. The order they apply in is your priority list.

Scheduling

Start and end times use your store's timezone as set in Shopify admin. A campaign with no end date runs until you pause it.

Expiry is evaluated at cart calculation time, not by a background job — a campaign that ends at 23:59 stops discounting at 23:59, including for carts that have been open for hours.

The assistant

You describe a promotion in plain English; the assistant returns a configured campaign as a draft. It can create and edit drafts. It cannot activate, pause, or edit a live campaign, and there is no setting that grants it those permissions.

One draft costs one credit, whether it takes one attempt or several revisions in the same conversation. Building by hand costs nothing.

Your prompts and store metadata go to our AI provider under terms that exclude training on our inputs. Conversations are retained for 12 months; you can delete any conversation immediately.

Troubleshooting

A campaign isn’t applying.

Check, in order: is it active; is today inside its schedule; do its conditions pass for that customer; is another campaign blocking it as standalone. The simulator prints all four.

A discount code and a campaign both apply.

Sconta only governs automatic discounts. Shopify’s own combination settings decide whether a manual code stacks on top.

The wrong campaign won.

Almost always the resolution rule. Best value for the customer will pick the largest discount even when you intended the smaller one.

Fixed prices didn’t revert.

They should — Sconta never writes to product records. If a product is genuinely priced wrong, it was edited outside Sconta.

Still stuck?

Send us the campaign name and a cart that reproduces it. We reply with the trace.

Contact support