> For the complete documentation index, see [llms.txt](https://docs.intelligems.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intelligems.io/shipping-experiences/shipping-testing-getting-started.md).

# Shipping Experiences Overview

How shipping testing works and how to get started.

## **What is a Shipping Experience?**

Intelligems gives you the tools to&#x20;

test your shipping rates, free shipping threshold, and beyond. Testing your shipping rates with Intelligems allows you to find rates that work for you and your customers. The right shipping profile can allow you to boost profits, maximize conversion without sacrificing on margin, or boost AOV.

{% hint style="info" %}
Shipping experiences are available on Smart Shipping and Unlimited plans.
{% endhint %}

## **The 3 experience types**

| Type                                                                                                                                                   | What it's for                                                             |
| ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- |
| [**Shipping Rates**](https://docs.intelligems.io/shipping-experiences/shipping-testing-getting-started/how-to-set-up-a-shipping-test.md)               | Find the rates that hold your conversion without giving away your margin. |
| [**Free Shipping**](https://docs.intelligems.io/shipping-experiences/shipping-testing-getting-started/how-to-set-up-a-free-shipping-experience.md)     | Give free shipping above a cart value, so shoppers add more to get it.    |
| [Shipping Discount](https://docs.intelligems.io/shipping-experiences/shipping-testing-getting-started/how-to-set-up-a-shipping-discount-experience.md) | Give a percentage off shipping when the cart reaches a minimum.           |

Shipping Rates, Free Shipping, and Shipping Discount all change what a shopper pays for shipping, but the results are a bit different. See below for a quick rundown on how each experience type functions:

**Shipping Rates** eplaces the rates in your Shopify shipping profiles for the length of the experience. Intelligems becomes a rate carrier on the profiles and zones you pick, hides the rates you selected to test, and serves its own rate to each group. Use it when you’re changing what shipping costs, including the cart value where it becomes free.

**Free Shipping** and **Shipping Discount** leave your Shopify rates where they are. They’re Intelligems offers that kick in once a cart reaches the value you set, the way a discount does. Free Shipping takes the shipping charge to $0. Shipping Discount takes a percentage off it. Use one of these when your rates are staying as they are and you’re adding or moving a shipping reward. Pick Shipping Discount when you want to reward a bigger cart without giving shipping away entirely, or to test whether a partial discount moves shoppers as much as free shipping does.

Because the offers work on a different mechanism from Shipping Rates, they don’t collide. A Free Shipping or Shipping Discount experience keeps applying while a Shipping Rates experience is running. For any shopper whose cart clears the threshold, whichever group they’re in, the offer applies to the rate that group sees: Free Shipping takes it to $0, and Shipping Discount takes your percentage off that group’s rate.

## **How does a Shipping Test it work?**

Intelligems runs Shipping Rate Tests using a Shopify feature called the [Third Party Rate Carrier API](https://help.shopify.com/en/manual/shipping/setting-up-and-managing-your-shipping/enabling-shipping-carriers). This feature allows Intelligems to calculate a shopper's rate based on which group they are in, what products they are purchasing, and where they will be shipping to. Because Intelligems provides the rates while the experience is running, we automatically hide the rates you selected to test when you start it.

{% hint style="danger" %}
To activate the third-party carrier-calculated shipping a Shipping Rates experience depends on, your store needs to be on the Advanced or Shopify Plus plan. This is a Shopify limitation.\
\
If you're on the Shopify plan, then you can add this feature for a monthly fee (paid to Shopify) or switch from monthly to yearly billing. For more information, contact [Shopify Support](https://help.shopify.com/questions).
{% endhint %}

{% hint style="danger" %}
**Advertising on Google Shopping or Performance Max? Check your Google & YouTube channel before you start a Shipping Rates experience.**

While a Shipping Rates experience runs, Intelligems hides the Shopify rates you selected and serves its own. Google can't import rates from a third-party app, so if your Google & YouTube channel syncs shipping to Merchant Center automatically, Merchant Center has no shipping data for the zones you're testing. It flags an error and can stop syncing your products, which takes them out of your ads until the experience stops.

Switch the channel's shipping settings to manual and set your rates in Merchant Center before you start. Here's how.

Free Shipping experiences don't change your Shopify rates, so they don't affect your feed.
{% endhint %}

{% hint style="warning" %}
**Only one Shipping Rates test can exist at a time, including one you've created but not yet started.** Only one Shipping Rates test can exist at a time. A pending, paused, or active test blocks a new one, including one you've created but not yet started. Intelligems installs the carrier rate on your Shopify profile as soon as the experience is created, so a second one in any of those states causes conflicts. To build a new one, end any that are running or paused and delete any that are pending.

Free Shipping experiences aren't affected by this limit.
{% endhint %}

After you save a Shipping Rates experience, check that Intelligems appears as a rate carrier in your Shopify shipping settings for every profile and zone you selected. If it isn't there, add it from the carrier options. Until it is, none of your Intelligems rates will show at checkout. The [Shipping Experience QA Checklist](https://docs.intelligems.io/shipping-experiences/shipping-test-qa-checklist.md) covers this and the rest of what to verify.

## **Managing the rest of the experience onsite**

Intelligems also provides features to manage the onsite merchandising a shipping experience needs. A few examples:

* **A** [**shipping progress bar**](https://docs.intelligems.io/shipping-experiences/shipping-progress-bar-integration.md)**.** If you're testing your threshold, you'll likely want the Intelligems shipping progress bar, found in your **Global styles** components, so the correct threshold displays in the cart for each group. There's also a Shipping Progress Bar block for your Shopify checkout, available to Shopify Plus stores on every plan, so the two surfaces show the same number.
* **Different copy for each group.** If you have text on the site that mentions your control shipping options, in your announcement bar or on a shipping FAQ page, use the [Visual Builder](https://docs.intelligems.io/general-features/editors/visual-builder.md) to add a Content Edits modification to show the correct copy for each group.

## How can I get started?

Before you can run a shipping test using Intelligems, you'll need to add the Intelligems script to your theme; [here is our help guide](https://docs.intelligems.io/getting-started/adding-intelligems-script-to-your-theme.md) on adding that snippet.

Once the snippet has been added to your theme, see the guides below for more information on shipping testing:

{% content-ref url="/pages/atf9gLwVgxie5uRncGvh" %}
[How to Set Up a Shipping Test](https://docs.intelligems.io/shipping-experiences/shipping-testing-getting-started/how-to-set-up-a-shipping-test.md)
{% endcontent-ref %}

{% content-ref url="/pages/66JXA8mK1AfZ28zvQdQD" %}
[How to Set Up a Free Shipping Experience](https://docs.intelligems.io/shipping-experiences/shipping-testing-getting-started/how-to-set-up-a-free-shipping-experience.md)
{% endcontent-ref %}

{% content-ref url="/pages/kF0c4A3EAM7t7fP8upFk" %}
[How to Set Up a Shipping Discount Experience](https://docs.intelligems.io/shipping-experiences/shipping-testing-getting-started/how-to-set-up-a-shipping-discount-experience.md)
{% endcontent-ref %}

{% content-ref url="/pages/3tT7UeEfXo93NhgZSRtI" %}
[Shipping Experience QA Checklist](https://docs.intelligems.io/shipping-experiences/shipping-test-qa-checklist.md)
{% endcontent-ref %}

{% content-ref url="/pages/rbHIw27EzYgNN7tpUVLN" %}
[Starting a Shipping Experience](https://docs.intelligems.io/shipping-experiences/shipping-testing-getting-started/starting-a-shipping-test.md)
{% endcontent-ref %}

{% content-ref url="/pages/Naccm5huI8Qy30typXw9" %}
[Ending a Shipping Experience](https://docs.intelligems.io/shipping-experiences/shipping-testing-getting-started/ending-a-shipping-test.md)
{% endcontent-ref %}

{% content-ref url="/pages/QeBoHa0W2qHs6BwS69mI" %}
[Shipping Progress Bar Integration](https://docs.intelligems.io/shipping-experiences/shipping-progress-bar-integration.md)
{% endcontent-ref %}

{% content-ref url="/pages/F0YnQs6ec2rrAiK2QMcc" %}
[Shipping Experiences FAQs](https://docs.intelligems.io/shipping-experiences/shipping-testing-faqs.md)
{% endcontent-ref %}

The [Shipping Experiences FAQs](https://docs.intelligems.io/shipping-experiences/shipping-testing-faqs.md) cover carrier behavior, international rates, and progress bar questions. For test ideas, see [Shipping Experience Use Cases](https://docs.intelligems.io/shipping-experiences/shipping-testing-getting-started/shipping-test-common-use-cases.md).

Shipping experiences can't be rolled out the way other types can. See [Ending a Shipping Experience](https://docs.intelligems.io/shipping-experiences/shipping-testing-getting-started/ending-a-shipping-test.md) for how to make winning rates live in Shopify yourself.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.intelligems.io/shipping-experiences/shipping-testing-getting-started.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
