> 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 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 2 experience types** | Type | What it's for | | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | | [**Shipping Rates**](/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**](/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. | Both types can give you a free shipping threshold, and they get there differently. The difference is what decides which one you want. **Shipping Rates** replaces 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** leaves your Shopify rates where they are. It's an Intelligems offer that takes the shipping charge to $0 once a cart reaches the value you set, the way a discount does. Use it when your rates are staying as they are and you're adding or moving a free shipping reward. Because they work on different mechanisms, they don't collide. A Free Shipping experience keeps applying while a Shipping Rates experience is running, and it will take the rate to $0 for any shopper whose cart clears the threshold, whichever group they're in. ## **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.** Intelligems installs the carrier rate on your Shopify profile as soon as the experience is created, so a second one in a pending or running state causes conflicts. To build a new one, end any that are running 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](/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**](/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](/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](/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](/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](/shipping-experiences/shipping-testing-getting-started/how-to-set-up-a-free-shipping-experience.md) {% endcontent-ref %} {% content-ref url="/pages/3tT7UeEfXo93NhgZSRtI" %} [Shipping Experience QA Checklist](/shipping-experiences/shipping-test-qa-checklist.md) {% endcontent-ref %} {% content-ref url="/pages/rbHIw27EzYgNN7tpUVLN" %} [Starting a Shipping Experience](/shipping-experiences/shipping-testing-getting-started/starting-a-shipping-test.md) {% endcontent-ref %} {% content-ref url="/pages/Naccm5huI8Qy30typXw9" %} [Ending a Shipping Experience](/shipping-experiences/shipping-testing-getting-started/ending-a-shipping-test.md) {% endcontent-ref %} {% content-ref url="/pages/QeBoHa0W2qHs6BwS69mI" %} [Shipping Progress Bar Integration](/shipping-experiences/shipping-progress-bar-integration.md) {% endcontent-ref %} {% content-ref url="/pages/F0YnQs6ec2rrAiK2QMcc" %} [Shipping Experiences FAQs](/shipping-experiences/shipping-testing-faqs.md) {% endcontent-ref %} The [Shipping Experiences FAQs](/shipping-experiences/shipping-testing-faqs.md) cover carrier behavior, international rates, and progress bar questions. For test ideas, see [Shipping Experience Use Cases](/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](/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=&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.