Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.atomcommerce.io/llms.txt

Use this file to discover all available pages before exploring further.

Atom Commerce adds a tile to your Shopify POS smart grid. When there are active offers that apply to the current cart, staff tap the tile to see what’s available and add items directly from there.

​
Where it appears in Shopify

The Atom Commerce tile sits on the POS smart grid — the main screen with your other action buttons. Tapping it opens a modal with two tabs: Upsells and Settings.

​
What staff see

​
The tile

The tile shows the current state of the cart session at a glance. Four tile states: session active with no upsells, active upsells with a badge showing the count, slow network warning, and offline
Tile stateWhat it means
Session ActiveCart is connected to Atom Commerce. No qualifying offers in the current cart.
N upsells with badgeThere are N offers the shopper could unlock. Tap to see them.
Slow Network with warning badgeThe connection is slow. Upsells may be stale.
Offline with grey badgeNo connection. Atom Commerce can’t evaluate the cart.

​
The Upsells tab — product offers

When the shopper’s cart qualifies for Buy X Get Y, bundles, or volume discounts, staff see a card for each qualifying product. Upsells tab showing two offer sections: a Buy 3 Get 1 Free offer with a product card and Add button, and a spend threshold offer Each card shows:
  • The product name and variant
  • The price (or “Free” for qualifying complimentary items)
  • A progress message — how many more items or how much more spend is needed
  • A + Add button to add the item to the cart
Tapping + Add adds the item immediately. A toast notification confirms the addition. Modal with an Adding button in disabled state, and a toast notification confirming the item was added to the cart

​
The Upsells tab — shipping discounts

When the cart is working toward a free shipping threshold, staff see the progress without any product to add. Upsells tab showing a Free Shipping Over $150 offer with a spend amount, progress bar, and completion percentage

​
How offers appear

Atom Commerce evaluates the cart and shows offers based on what’s in it. Offers appear when:
Offer typeAppears when
Buy X Get YCart has qualifying items and a free or discounted item could be added
BundlesCart contains items that are part of a bundle deal
Volume / tiered discountsCart quantity is below the next tier threshold
Spend thresholdCart total is below the discount threshold
Free shippingCart total is below the free shipping threshold
The tile badge count reflects the total number of qualifying offers across all active offers. Once a shopper has achieved an offer — for example, they’ve added enough items to trigger Buy 3 Get 1 Free — that offer is removed from the modal automatically.

​
Staff workflow

1

Check the tile before checkout

Staff should glance at the Atom Commerce tile before tapping Charge. If there’s a badge, there are offers available.
2

Open the upsells modal

Tap the tile to open the modal. The Upsells tab opens by default.
3

Add qualifying items

Tap + Add on any offer to add the item to the cart. The cart updates immediately. Close the modal and proceed to checkout.

​
Next steps

  • POS Settings — configure PRO vs LITE mode and apply order discounts
  • POS Setup — add the Atom Commerce tile to your smart grid
  • Managing Channels — control which offers are active on POS