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

> Learn how to configure Atom Commerce discounts for Point of Sale (POS) devices in Shopify

## TL;DR

Set up the Atom Commerce smart grid tile in Shopify Admin, then confirm POS mode on the device. When setup is complete, staff can apply Atom Commerce discounts directly from POS.

## Prerequisites

Before you start, make sure you have:

* An active Atom Commerce account
* Shopify POS installed and set up on your device (supports both POS PRO and POS LITE)
* You can log into your Shopify store as an admin
* Your POS device is available during setup

## Shopify Admin Configuration

First, enable the Atom Commerce Discounts app in Shopify POS settings.

### Step 1: Navigate to POS Settings

1. In your Shopify admin, go to **Sales channels** > **Point of Sale**
2. Click **Settings** in the left sidebar

### Step 2: Access POS Apps

1. In the **General** section, click **POS apps**
2. You'll see a list of installed POS applications

### Step 3: Configure Atom Commerce Discounts

1. Find **Atom Commerce Discounts** in the app list
2. Click on **Atom Commerce Discounts** to open its settings
3. In the **Customize this app** section, check that **Smart grid tile** shows **Added** with a green checkmark
4. If it shows **Remove** instead, click the **Add** button to turn on the smart grid tile

<Tip>
  The smart grid tile adds a button on your POS device. Your staff can tap this
  button to use Atom Commerce discounts.
</Tip>

## POS Device Configuration

After enabling the smart grid tile in Shopify Admin, validate and configure settings on the POS device.

### Step 1: Find the Atom Commerce Tile

1. On your POS device, open the smart grid (the main screen with buttons)
2. Look for the **Atom Commerce Ready** tile (it shows the Atom Commerce logo with circles)
3. You should see this tile on your smart grid screen with your other POS buttons
   <Frame caption="Atom Commerce Tile">
     <img
       src="https://mintcdn.com/atomcommerce/3ioDPppf5FEh80gh/images/atom-commerce-tile.png?fit=max&auto=format&n=3ioDPppf5FEh80gh&q=85&s=525c4c05b600b2506e4dc84a006f7fc0"
       alt="Atom Commerce Ready Tile"
       style={{
     maxWidth: "300px",
     borderRadius: "0.5rem",
     display: "block",
     margin: "0 auto",
     padding: "1rem",
   }}
       width="639"
       height="410"
       data-path="images/atom-commerce-tile.png"
     />
   </Frame>

### Step 2: Open Atom POS Configuration

1. Tap the **Atom Commerce Ready** tile
2. This opens the **Atom POS Configuration** screen
   {" "}
   <Frame caption="Atom POS Configuration">
     <img
       src="https://mintcdn.com/atomcommerce/aW2p-SDPnKrHGPy8/images/pos-admin-settings.png?fit=max&auto=format&n=aW2p-SDPnKrHGPy8&q=85&s=e2e3d4d238aa13160274e30ee9fd2869"
       alt="Atom POS Configuration"
       style={{
     padding: "1rem",
     maxWidth: "400px",
     borderRadius: "0.5rem",
     display: "block",
     margin: "0 auto",
   }}
       width="1284"
       height="2778"
       data-path="images/pos-admin-settings.png"
     />
   </Frame>

### Step 3: Verify POS Mode

1. In the **Atom Commerce Connector** section, find **POS Mode**
2. Confirm that the displayed mode matches your Shopify POS subscription:
   * If you have **POS PRO**, it should show **PRO**
   * If you have **POS LITE**, it should show **LITE**
3. If the wrong mode is displayed, switch to the correct mode:
   * Click the **Switch to PRO** button (if you need PRO mode)
   * Or click the **Switch to LITE** button (if you need LITE mode)
   * Once selected, the mode will be saved and you can close the POS configuration screen
   * Clear your POS cart and try again using the new mode

<Warning>
  If you're having trouble setting the correct mode, contact
  [support@atomcommerce.io](mailto:support@atomcommerce.io) for assistance.
</Warning>

### Step 4: Clear Atom Session (If Needed)

If you just switched modes, or discounts are not applying:

1. Scroll to the bottom of the **Atom POS Configuration** screen
2. Click **Clear Atom Session**
3. This refreshes the connection between your POS device and Atom Commerce

<img
  src="https://mintcdn.com/atomcommerce/mn7yctUUQ6GCV8Kf/images/pos-configuration-screen.png?fit=max&auto=format&n=mn7yctUUQ6GCV8Kf&q=85&s=d07c93df6c3ecf12c9d9eac13bf34272"
  alt="Atom POS Configuration"
  style={{
maxWidth: "300px",
borderRadius: "0.5rem",
display: "block",
margin: "0 auto",
}}
  width="1284"
  height="2778"
  data-path="images/pos-configuration-screen.png"
/>

## Verification

After you finish the setup, check that everything is working:

1. **Shopify Admin**: Make sure the Smart grid tile is set to "Added" for Atom Commerce Discounts
2. **POS Device**: Check that the "Atom Commerce Ready" tile shows up in your smart grid
3. **POS Mode**: Verify that POS Mode shows the correct mode (PRO or LITE) matching your Shopify POS subscription
4. **Test a Discount**: Try using an Atom Commerce discount on a test sale on your POS device

## Troubleshooting

### Smart Grid Tile Not Appearing

If the "Atom Commerce Ready" tile doesn't show up on your POS device:

* Check that the Smart grid tile is set to "Added" in Shopify admin POS settings
* Refresh your POS device or close and reopen the POS app
* Make sure you have the latest version of the Atom Commerce Connector installed

### POS Mode Not Correct

If POS Mode doesn't match your Shopify POS subscription:

* Click **Switch to PRO** or **Switch to LITE** in the POS configuration screen to match your subscription
* Click **Clear Atom Session** to refresh the connection
* If you're unable to set the correct mode, contact [support@atomcommerce.io](mailto:support@atomcommerce.io) for assistance

### Discounts Not Applying

If discounts aren't working on POS sales:

* Make sure POS Mode matches your Shopify POS subscription (PRO or LITE)
* Check that your offers are set up to work with POS channels
* Go to ATOM POS Configuration and click "Apply Order Discounts" to refresh the discounts in your POS cart
* Make sure your offers are active and the dates are correct
* Use the [AI Assistant](/ai-assistant/overview) to help you confirm your offers are working correctly
* See the [Managing Channels](/channels/managing) guide for help with channel settings

## Next Steps

Now that POS is configured, you can:

* [POS Upsells](/pos/upsells) — see how staff use the upsells modal at the register
* [POS Settings](/pos/settings) — configure PRO vs LITE mode and apply order discounts
* [Managing Channels](/channels/managing) — set up offers for POS
* [Creating Offers](/offers/creating-offers) — make discounts that work with POS