> For the complete documentation index, see [llms.txt](https://responsive-media.gitbook.io/advanced-free-shipping/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://responsive-media.gitbook.io/advanced-free-shipping/getting-started/quick-start.md).

# Quick Start Guide

## Your First Shipping Discount: Free Shipping Over $50

Let's create a simple but effective shipping discount: free shipping for orders over $50. This is one of the most popular shipping strategies and takes just a few minutes to set up.

1. **Open the Dashboard**

   From your Shopify admin, open the Advanced Free Shipping app. You'll see your dashboard with any existing shipping discounts.
2. **Create New Shipping Discount**

   Click the **"Create shipping discount"** button in the top right corner.
3. **Choose Discount Method**

   Select whether you want:

   * **Automatic** - Applies automatically at checkout (recommended for most cases)
   * **Code** - Requires customers to enter a discount code

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>For "free shipping over $50" promotions, choose <strong>Automatic</strong> so customers don't need to remember a code.</p></div>
4. **Name Your Shipping Discount**

   Enter a clear name like "Free Shipping Over $50". This is for your internal reference and helps you manage multiple shipping discounts.

   If you chose **Code**, you'll also need to enter the discount code customers will use (e.g., "FREESHIP50").
5. **Add a Condition**

   Now we'll set the $50 threshold:

   1. Click **"Add condition"**
   2. Select **"Cart total"** from the dropdown
   3. Choose **"Is at least"** as the operator
   4. Enter **"50"** as the value

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Cart total is calculated after other discounts but before shipping. This ensures customers must spend $50 on products to qualify.</p></div>
6. **Set the Shipping Discount**

   In the "Shipping Targets" section:

   1. Keep **"All shipping rates"** selected (this applies the shipping discount to any shipping method)
   2. Keep **"Free"** selected as the discount type

   That's it! The shipping discount will make shipping completely free when the condition is met.
7. **Review Settings**

   Scroll down to review optional settings:

   * **Active dates** - Leave blank to start immediately and run indefinitely
   * **Usage limits** - Leave blank for unlimited uses
   * **Combinations** - Choose if this can stack with other discounts
   * **Purchase types** - Keep both "One-time" and "Subscription" checked
8. **Enable Test Mode (Optional)**

   Before going live, you can enable **Test Mode** to verify the shipping discount works:

   1. Toggle **Test mode** ON
   2. Click **Save**
   3. Go to checkout and enter **ABC123** as the first name
   4. Verify the shipping discount appears (you may need to refresh checkout)
   5. Come back and toggle Test mode OFF when ready

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>In test mode, the shipping discount only applies when <strong>ABC123</strong> is entered as the first name at checkout. Real customers won't see it.</p></div>
9. **Save Your Shipping Discount**

   Click the **Save** button at the bottom. Your shipping discount is now live!

## Verify It's Working

1. **Visit Your Store**

   Open your online store in a new browser window (or incognito mode).
2. **Add Products to Cart**

   Add products totaling at least $50 to your cart.
3. **Go to Checkout**

   Proceed to checkout and enter a shipping address.
4. **Check Shipping Options**

   You should see "FREE" or "$0.00" for your shipping rates. Success!

{% hint style="warning" %}
If the shipping discount isn't appearing:

1. **Check combination settings** - If you're using other Shopify discounts (product/order), BOTH discounts must be configured to combine with each other
2. **Verify Test Mode is OFF** (if testing with real customer account)
3. **Verify your cart total is at least $50**
4. **Check that you've entered a valid shipping address**
5. See our [Troubleshooting Guide](/advanced-free-shipping/troubleshooting/common-issues.md) for the top 2 issues that cause 99% of problems
   {% endhint %}

## What's Next?

Now that you've created your first shipping discount, explore more powerful features:

* [**How It Works**](/advanced-free-shipping/core-concepts/how-it-works.md) - Understand rule groups, conditions, and targets
* [**Common Use Cases**](/advanced-free-shipping/common-use-cases/use-cases.md) - Copy ready-made discount examples
* [**All Conditions**](/advanced-free-shipping/conditions-cart-and-order/cart-total.md) - Browse all available condition types
* [**Advanced Features**](/advanced-free-shipping/advanced-features/multiple-rule-groups.md) - Create complex discount rules

## Tips for Success

{% hint style="info" %}
**Start simple.** Create one or two straightforward shipping discounts first. Once you're comfortable, you can create more complex rules with multiple conditions.
{% endhint %}

{% hint style="info" %}
**Use clear names.** Name your shipping discounts descriptively (e.g., "Free Shipping CA Only" or "VIP Free Shipping") so you can easily manage them later.
{% endhint %}

{% hint style="info" %}
**Monitor performance.** Check your dashboard regularly to see which shipping discounts are being used most. This helps you optimize your shipping strategy.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://responsive-media.gitbook.io/advanced-free-shipping/getting-started/quick-start.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.