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

# Enable the Shopify Checkout Extension

> Enable the Atom Commerce Shopify checkout extension so fulfillment exclusions and shipping-related discount rules can be enforced correctly at checkout.

The **Atom Checkout Extension** allows you to exclude some **fulfillment methods** from being eligible for discounts.\
For example, you can configure an offer to apply for **standard shipping**, but exclude **local pickup**.

<Info>
  Note: This extension adds no visible UI components to checkout — it only enables Atom Commerce to control when discounts apply based on the customer’s chosen fulfillment method.
</Info>

## Steps to Enable

<Steps>
  <Step title="Go to Shopify Checkout Settings">
    1. From your Shopify admin, navigate to **Settings → Checkout**.

           <img src="https://mintcdn.com/atomcommerce/Qdf55X3VaKcwOMVo/images/checkout-extension-step1.png?fit=max&auto=format&n=Qdf55X3VaKcwOMVo&q=85&s=f63ae7d95c4ecab2597b59482c2bb9d3" alt="Step 1" width="449" height="223" data-path="images/checkout-extension-step1.png" />
  </Step>

  <Step title="Open the Checkout Editor">
    2. Click **Customize** to open the checkout customization screen.

           <img src="https://mintcdn.com/atomcommerce/Qdf55X3VaKcwOMVo/images/checkout-extension-step2.png?fit=max&auto=format&n=Qdf55X3VaKcwOMVo&q=85&s=d35706c27d259b1bd457465ef519c27d" alt="Step 2" width="1052" height="360" data-path="images/checkout-extension-step2.png" />
  </Step>

  <Step title="Choose the Apps Tab">
    3. In the left sidebar, select **Apps**.
    4. Make sure the **All** tab is selected to see all available extensions.

           <img src="https://mintcdn.com/atomcommerce/eeBgceIUudWsB5Fi/images/checkout-extension-step3.png?fit=max&auto=format&n=eeBgceIUudWsB5Fi&q=85&s=44ebe99f5834a436e6e476639ac30a77" alt="Step 3 - Choose the Apps Tab" title="Step 3 - Choose the Apps Tab" className="mr-auto" width="734" height="976" data-path="images/checkout-extension-step3.png" />
  </Step>

  <Step title="Add the Atom Checkout Extension">
    5. Locate **atom-checkout-delivery** and click the **(+)** icon to add it to Checkout.

           <img src="https://mintcdn.com/atomcommerce/eeBgceIUudWsB5Fi/images/checkout-extension-step4.png?fit=max&auto=format&n=eeBgceIUudWsB5Fi&q=85&s=f2fe8939b90e47c34f999791f6daec96" alt="Step 4" width="194" height="73" data-path="images/checkout-extension-step4.png" />
  </Step>

  <Step title="Confirm Placement">
    6. The extension will appear at the top of the page. It has **no visible elements**, so its position does not matter.

           <img src="https://mintcdn.com/atomcommerce/eeBgceIUudWsB5Fi/images/checkout-extension-step5.png?fit=max&auto=format&n=eeBgceIUudWsB5Fi&q=85&s=d8f3a75834bdd2096111a546fb53b8d0" alt="Step 5" width="609" height="307" data-path="images/checkout-extension-step5.png" />
  </Step>

  <Step title="Save Your Checkout">
    7. Finally, click the **Save** button in the checkout editor to publish your changes.

           <img src="https://mintcdn.com/atomcommerce/eeBgceIUudWsB5Fi/images/checkout-extension-step6.png?fit=max&auto=format&n=eeBgceIUudWsB5Fi&q=85&s=aaf982e64631dd1e3066e76cfd688e62" alt="Step 6" width="1050" height="165" data-path="images/checkout-extension-step6.png" />
  </Step>
</Steps>

## Example Use Case

* **Allowed**: Apply a discount when the customer selects *Standard Shipping*.
* **Not Allowed**: Prevent the same discount from applying when the customer selects *Local Pickup*.

This ensures discounts are only used with the fulfillment methods you intend, protecting margins and keeping promotional rules consistent.

## When You Need This Extension

You should enable this extension if you use:

* **fulfillment type exclusions**
* **shipping discounts with minimum cart value requirements**
* **free shipping promotions where local pickup or other methods should be excluded**

Without the extension, Atom Commerce cannot reliably enforce these fulfillment-based rules at checkout.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="The discount does not appear at checkout">
    Make sure the checkout extension is **installed and saved** in Shopify. Without it, Atom Commerce cannot evaluate fulfillment method conditions.
  </Accordion>

  <Accordion title="The extension doesn’t show any visible block">
    This is expected. The extension only runs logic behind the scenes and does not render UI in checkout.
  </Accordion>

  <Accordion title="Changes aren’t taking effect">
    Double-check that you clicked **Save** in the checkout editor after enabling the extension. Also, if you just enabled your discount, be sure to make a change to items in your cart to ensure the discount is applied.
  </Accordion>
</AccordionGroup>
