> ## 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.

# POS Upsells

> Show your staff which Atom Commerce offers are available in the current cart, and let them add qualifying products with a single tap.

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.

<img src="https://mintcdn.com/atomcommerce/gFb8RjMEeZ7dpMR-/images/pos-tile-states.png?fit=max&auto=format&n=gFb8RjMEeZ7dpMR-&q=85&s=17ea82e4b53e74dc6d69a319cd34a568" alt="Four tile states: session active with no upsells, active upsells with a badge showing the count, slow network warning, and offline" width="320" height="210" data-path="images/pos-tile-states.png" />

| Tile state                          | What it means                                                                 |
| ----------------------------------- | ----------------------------------------------------------------------------- |
| **Session Active**                  | Cart is connected to Atom Commerce. No qualifying offers in the current cart. |
| **N upsells** with badge            | There are N offers the shopper could unlock. Tap to see them.                 |
| **Slow Network** with warning badge | The connection is slow. Upsells may be stale.                                 |
| **Offline** with grey badge         | No 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.

<img src="https://mintcdn.com/atomcommerce/gFb8RjMEeZ7dpMR-/images/pos-modal-upsells.png?fit=max&auto=format&n=gFb8RjMEeZ7dpMR-&q=85&s=3fa381006476449aa521f45b4aa48929" alt="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" width="358" height="423" data-path="images/pos-modal-upsells.png" />

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.

<img src="https://mintcdn.com/atomcommerce/gFb8RjMEeZ7dpMR-/images/pos-modal-toast.png?fit=max&auto=format&n=gFb8RjMEeZ7dpMR-&q=85&s=2ce5076f4850f3b0656c869256d68e6b" alt="Modal with an Adding button in disabled state, and a toast notification confirming the item was added to the cart" width="358" height="346" data-path="images/pos-modal-toast.png" />

### The Upsells tab — shipping discounts

When the cart is working toward a free shipping threshold, staff see the progress without any product to add.

<img src="https://mintcdn.com/atomcommerce/gFb8RjMEeZ7dpMR-/images/pos-modal-shipping.png?fit=max&auto=format&n=gFb8RjMEeZ7dpMR-&q=85&s=4f06adac9ff6a0025e0467fee1913487" alt="Upsells tab showing a Free Shipping Over $150 offer with a spend amount, progress bar, and completion percentage" width="358" height="247" data-path="images/pos-modal-shipping.png" />

***

## How offers appear

Atom Commerce evaluates the cart and shows offers based on what's in it. Offers appear when:

| Offer type                | Appears when                                                           |
| ------------------------- | ---------------------------------------------------------------------- |
| Buy X Get Y               | Cart has qualifying items and a free or discounted item could be added |
| Bundles                   | Cart contains items that are part of a bundle deal                     |
| Volume / tiered discounts | Cart quantity is below the next tier threshold                         |
| Spend threshold           | Cart total is below the discount threshold                             |
| Free shipping             | Cart 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

<Steps>
  <Step title="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.
  </Step>

  <Step title="Open the upsells modal">
    Tap the tile to open the modal. The **Upsells** tab opens by default.
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

## Next steps

* [POS Settings](/pos/settings) — configure PRO vs LITE mode and apply order discounts
* [POS Setup](/pos/setup) — add the Atom Commerce tile to your smart grid
* [Managing Channels](/channels/managing) — control which offers are active on POS
