Skip to main content

​
tldr;

This guide shows you how to set up Atom Commerce discounts on your Shopify Point of Sale (POS) devices for the first time. After you finish, your staff can use Atom Commerce discounts right from the POS device.

​
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
  • You have your POS device with you, you’ll need this to complete the setup

​
Shopify Admin Configuration

First, you need to turn on the Atom Commerce Discounts app in your 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
The smart grid tile adds a button on your POS device. Your staff can tap this button to use Atom Commerce discounts.

​
POS Device Configuration

After you turn on the smart grid tile in Shopify admin, you need to check and set up the settings on your 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
    Atom Commerce Ready Tile

    Atom Commerce Tile

​
Step 2: Open Atom POS Configuration

  1. Tap the Atom Commerce Ready tile
  2. This opens the following screen: Atom POS Configuration
    Atom POS Configuration

    Atom POS Configuration

​
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
If you’re having trouble setting the correct mode, contact [email protected] for assistance.

​
Step 4: Clear Atom Session (If Needed)

If you just switched modes or something isn’t working:
  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
Atom POS Configuration

​
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 [email protected] 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 to help you confirm your offers are working correctly
  • See the Managing Channels guide for help with channel settings

​
Next Steps

Now that POS is set up, you can: