> For the complete documentation index, see [llms.txt](https://help.mimeeq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.mimeeq.com/commerce-and-integrations/shopify/discount-codes.md).

# Shopify Discount Codes

Run promotions on configured products without changing their base price. Learn to apply Shopify discount codes to Mimeeq products and bundles.

Use Shopify's discount code system with Mimeeq products. The setup depends on which type of Mimeeq integration you use.

With Mimeeq's Shopify integration, you can:

1. Create smart collections that automatically include all Mimeeq products.
2. Apply discount codes specifically to these collections.
3. Offer promotional pricing without changing the base price in your product configurations.

{% hint style="warning" %}
**Important:** the setup process differs depending on your integration type. Review the section below that matches your setup.
{% endhint %}

***

## Integration types

<table><thead><tr><th width="60.71484375">#</th><th>Integration type</th><th>What it is</th><th>Discount codes</th></tr></thead><tbody><tr><td>1</td><td><strong>Custom Mimeeq Products</strong></td><td>Products created entirely through the Mimeeq configurator and added to Shopify as new custom products. They are automatically tagged with <code>mimeeq_custom</code>.</td><td>Work with standard Shopify discount codes</td></tr><tr><td>2</td><td><strong>Bundled Existing Products (Cart Transform API)</strong></td><td>Configurations that use existing Shopify product variants and bundle them together at the cart/checkout level using Shopify's Cart Transform API.</td><td>Require special considerations to work correctly</td></tr></tbody></table>

***

## Basic discount code setup

All products created in the Mimeeq configurator are automatically tagged with `mimeeq_custom` in your Shopify store. Use this tag to group them in a smart collection and target them with a discount code.

{% stepper %}
{% step %}

### Create a smart collection for Mimeeq products

1. Navigate to **Products > Collections** in your Shopify admin.
2. Click **Create Collection**.
3. Give your collection a name (e.g. "Mimeeq Products").
4. Select **Smart collection** as the collection type.
5. Set the condition: **Tag equals mimeeq\_custom**.
6. Save the collection.

All products with the `mimeeq_custom` tag are now included in this collection. New products created with the Mimeeq configurator are added to it automatically.
{% endstep %}

{% step %}

### Create a discount code for the collection

1. Go to **Discounts** in your Shopify admin.
2. Click **Create discount**.
3. Choose your discount type (e.g. **Fixed amount**).
4. Enter the discount value (e.g. 500).
5. Under **Specific collections**, select your Mimeeq collection.
6. Configure any additional parameters (usage limits, dates, etc.).
7. Click **Save**.
   {% endstep %}

{% step %}

### Test your discount code

1. Go to your store frontend.
2. Add a Mimeeq-configured product to cart.
3. Proceed to checkout.
4. Apply your discount code in the discount code field.
5. Verify that the discount is applied correctly.
   {% endstep %}
   {% endstepper %}

***

## Discount codes with bundled products (Cart Transform API)

If you use Mimeeq's bundling functionality with Shopify's Cart Transform API, discount codes work with some important considerations. This section explains how different discount types interact with bundled products created through the configurator.

### Order-level discounts

**Status:** ✅ Works normally

Discount codes that apply to the entire order work without any special considerations. These include:

* Percentage off entire order
* Fixed amount off entire order
* Free shipping

**Example:** a 10% off entire order code correctly applies to all items, including bundled products.

### Product- and collection-specific discounts

**Status:** ⚠️ Works with specific requirements

Product or collection-based discount codes have special behaviour with bundles.

**Key requirements:**

* The discount code must target the **master component** of the bundle.
* The master component must either:
  * be directly assigned to the discount code, or
  * be included in a collection that's assigned to the discount code.
* If the discount code only targets non-master bundle components, the discount will **not** be applied.

**Important behaviour:** the discount affects the **entire bundle price**, not only the master component price.

{% hint style="success" %}
**Tip:** when working with modular products where multiple masters may be selected based on user choices, ensure that all potential masters have a discount code applied to them.
{% endhint %}

### Practical example

**Scenario:**

* Bundle total price: $3,000 USD
* Master component price: $1,000 USD
* Other components: $2,000 USD combined
* Discount code: 10% off the master component product

**Result:**

* Discount applied: **$300 USD** (10% of the $3,000 total bundle)
* Not $100 USD (which would be 10% of only the master component)

**Why?** From a discount code perspective, bundles are treated as single products where the master component represents the entire bundle. The system considers the total bundle price as the component price.

### Best practices for bundle discounts

1. Configure discount codes to target master components if you want them to apply to bundles.
2. Test discount codes with bundle configurations before going live.
3. Document which products are master components in your bundle configurations for your marketing team.
4. Set customer expectations about how discounts apply to configured bundles.
5. Consider order-level discounts for simpler discount management across all product types.

### Summary

<table><thead><tr><th width="63.5703125">#</th><th>Discount type</th><th>Works with bundles?</th><th>Special requirements</th></tr></thead><tbody><tr><td>1</td><td>Order-level (% or fixed)</td><td>✅ Yes</td><td>None</td></tr><tr><td>2</td><td>Free shipping</td><td>✅ Yes</td><td>None</td></tr><tr><td>3</td><td>Product-specific</td><td>⚠️ Yes</td><td>Must target master component</td></tr><tr><td>4</td><td>Collection-specific</td><td>⚠️ Yes</td><td>Master component must be in collection</td></tr></tbody></table>

***

## Alternative approaches

Discount codes through Shopify provide flexibility and tracking capabilities. You can also:

* Directly adjust pricing in the Mimeeq configuration if you prefer to show the discounted price upfront.
* Use Shopify's automatic discounts feature for collection-wide sales that don't require a code.

***

## Frequently asked questions

<details>

<summary>How are Mimeeq products automatically tagged in Shopify?</summary>

All products created in the Mimeeq configurator are automatically tagged with `mimeeq_custom` in your Shopify store, which allows for easy collection creation.

</details>

<details>

<summary>What's the key difference in how discount codes work between the two integration types?</summary>

Custom Mimeeq Products work with standard Shopify discount codes. Bundled Products (using the Cart Transform API) require special considerations: discount codes must target the master component of the bundle.

</details>

<details>

<summary>How do product-specific discounts apply to bundled products?</summary>

When applied to the master component, the discount affects the entire bundle price, not only the master component price. For example, a 10% discount on a $1,000 master component within a $3,000 bundle results in a $300 discount.

</details>

<details>

<summary>What are the steps to create a smart collection for Mimeeq products?</summary>

Navigate to **Products > Collections** in Shopify admin, click **Create Collection**, name it, select **Smart collection** as the type, set the condition **Tag equals mimeeq\_custom**, and save. All Mimeeq products are included automatically.

</details>

<details>

<summary>Which discount types work without special requirements for bundled products?</summary>

Order-level discounts (percentage off entire order, fixed amount off entire order) and free shipping work normally with bundled products without any special considerations.

</details>

{% hint style="info" %}
For additional help with Mimeeq configurations, discount code setup or the Shopify integration, contact our support team.
{% endhint %}

***

## Related articles

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Shopify Add to Cart Methods</strong></td><td>Choose how configured products and bundles reach the cart.</td><td><a href="/commerce-and-integrations/shopify/add-to-cart.md">Shopify Add to Cart Methods</a></td></tr><tr><td><strong>Shopify Multi-Currency &#x26; Markets</strong></td><td>Show regional prices in multiple currencies.</td><td><a href="/commerce-and-integrations/shopify/multi-currency-and-markets.md">Shopify Multi-Currency &amp; Markets</a></td></tr><tr><td><strong>Shopify Admin Settings</strong></td><td>Connect your API key, products and cart settings.</td><td><a href="/commerce-and-integrations/shopify/admin-settings.md">Shopify Admin Settings</a></td></tr><tr><td><strong>Shopify Custom Field Mappings</strong></td><td>Send extra configuration data to Shopify products and variants.</td><td><a href="/commerce-and-integrations/shopify/custom-field-mappings.md">Custom Custom Field Mappings</a></td></tr></tbody></table>


---

# 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://help.mimeeq.com/commerce-and-integrations/shopify/discount-codes.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.