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

# Web Store Connection 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.

<CardGroup cols={2}>
  <Card title="Use This When" icon="star">
    You are connecting a Shopify store, enabling the app embed, and preparing to launch your first offers
  </Card>

  <Card title="Next Steps" icon="arrow-right">
    After setup, continue to [Offer Types](/offers/offer-types), [Creating Offers](/offers/creating-offers), and [Offer Priority and Stacking](/offers/priority-and-stacking)
  </Card>
</CardGroup>

<Tabs>
  <Tab title="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](https://apps.shopify.com/atom-commerce-connector) 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**
       <Tip>Once installed, Atom Commerce will always be available under the **Apps** menu in your Shopify Admin.</Tip> 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](/quickstart) to launch your first offer
    2. Review [Types of Offers](/offers/offer-types) to choose the right offer structure
    3. Read [Offer Priority and Stacking](/offers/priority-and-stacking) before combining multiple offers
    4. If you use fulfillment exclusions, complete [Checkout Extension Setup](/fulfillment/checkout-extension)
    5. Start with [Creating Offers](/offers/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

    <AccordionGroup>
      <Accordion title="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.
      </Accordion>

      <Accordion title="Fulfillment exclusions are not taking effect">
        Fulfillment exclusions also require the Atom checkout extension. See [Checkout Extension Setup](/fulfillment/checkout-extension).
      </Accordion>

      <Accordion title="I installed the app but do not know which offer to build first">
        Start with [Product Discounts](/guides/product-discounts) or [Gift With Purchase](/guides/gift-with-purchase), then review [Offer Types](/offers/offer-types) for tradeoffs.
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="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 [support@atomcommerce.io](mailto:support@atomcommerce.io) 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](/offers/offer-types) to choose the right offer structure
    2. Read [Offer Priority and Stacking](/offers/priority-and-stacking) before combining multiple offers
    3. Start with [Creating Offers](/offers/creating-offers)
    4. Validate behavior in a staging environment before launch and contact [support@atomcommerce.io](mailto:support@atomcommerce.io) if implementation details are unclear
  </Tab>
</Tabs>