First-Time Setup

Install Atom Commerce, enable the Shopify app embed, complete onboarding, and finish the required setup for live offers and checkout behavior.

Use this setup guide when you are installing Atom Commerce for the first time and need Shopify offers working correctly before launching anything live.

Use This When

You are connecting a Shopify store, enabling the app embed, and preparing to launch your first offers

Next Steps

After setup, continue to Offer Types, Creating Offers, and Offer Priority and Stacking

Shopify Merchants

Overview

Complete these steps in order before testing or launching offers:

1. Install the Atom Commerce app for Shopify Go to Atom Commerce Connector on Shopify App Store and click Add app.
2. Complete the onboarding survey and getting started page After installation, you’ll be directed to a short survey and a getting started page. You can use the AI Assistant if you need help.
3. Enable the Shopify App Embed Turn on the Shopify App Embed. Atom Commerce needs it to apply discounts in your store. Follow the prompts on the getting started page, or ask the AI Assistant if you need help.
4. Open Atom Commerce from Shopify Admin
   Once installed, Atom Commerce will always be available under the Apps menu in your Shopify Admin.
   Click Atom Commerce Connector to open your Atom Commerce Dashboard.

Recommended Next Steps

After installation, most merchants should do these next:

1. Walk through the Quickstart Guide to launch your first offer
2. Review Types of Offers to choose the right offer structure
3. Read Offer Priority and Stacking before combining multiple offers
4. If you use fulfillment exclusions, complete Checkout Extension Setup
5. Start with Creating Offers

Expected Outcome

When setup is complete:

• Atom Commerce opens from the Apps menu in Shopify Admin
• The Shopify App Embed is enabled
• You can create and test offers without installation-related blockers

Common Setup Pitfalls

The app is installed but discounts do not apply

In most cases, the Shopify App Embed has not been enabled yet. Complete that step before troubleshooting offer logic.

Fulfillment exclusions are not taking effect

Fulfillment exclusions also require the Atom checkout extension. See Checkout Extension Setup.

I installed the app but do not know which offer to build first

Start with Product Discounts or Gift With Purchase, then review Offer Types for tradeoffs.

Custom Implementations

Overview

This docs site is focused on merchant workflows in the Atom Commerce dashboard. If you are planning a custom storefront or backend integration, contact Atom Commerce first so you can get the current implementation guidance for your environment.

Before You Start

Gather the following before requesting integration access:

• Your Shopify store URL
• A short description of the storefront or backend you are integrating
• The environments you need to support, such as staging or production
• Any timeline or launch constraints

How to Proceed

1. Email [e-mail] with your implementation details
2. Ask for the current API and authentication requirements for your integration
3. Confirm how offers will be tested before launch
4. Return to the merchant-facing docs for offer behavior, priority, and troubleshooting concepts

Recommended Reading

1. Review Types of Offers to choose the right offer structure
2. Read Offer Priority and Stacking before combining multiple offers
3. Start with Creating Offers
4. Validate behavior in a staging environment before launch and contact [e-mail] if implementation details are unclear