> 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/add-to-cart.md). # Add to Cart Learn how to create and map dynamic product bundles in Shopify using Mimeeq's advanced bundling functionality. ## Content 1. [Overview](#overview) 2. [Bundling Methods by Product Type](#bundling-methods-by-product-type) 3. [Creating Bundles in Mimeeq](#creating-bundles-in-mimeeq) 4. [Custom Products Configuration](#custom-products-configuration) 5. [Single Variants Configuration](#single-variants-configuration) 6. [Cart Bundle Configuration](#cart-bundle-configuration) 7. [Admin Bundle Configuration](#admin-bundle-configuration) 8. [Shopify Bundling Methods for Modular Products](#shopify-bundling-methods-for-modular-products) 9. [How to Configure Modular Product Bundles](#how-to-configure-modular-product-bundles) ## Overview Mimeeq provides advanced bundling functionality for 3D configurators integrated with Shopify stores. This feature allow you to group multiple product components into a single purchase unit, enabling complex product configurations to be added to cart as packages. {% hint style="warning" %} Important: Custom Product, Single Variant, and Product Bundles functionality is available for Shopify-integrated stores. To use these features, enable Add to Cart Configuration in your Shopify app Extension Settings. This feature requires an active Shopify connection and will not function without proper Shopify integration. Refer to the [Shopify App - Admin Settings](/commerce-and-integrations/shopify/admin-settings.md#add-mimeeq-to-your-storefront) to ensure all required settings are configured correctly. {% endhint %} ![Example of a bundled product in a Shopify cart](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FkDtdLmjlX1cMwKY5ONjQ%2Fshopify-bundle-1_1ar7t0f.png?alt=media) ## Bundling Methods by Product Type ### Standard Products - Two Bundling Approaches Standard products support two bundling methods * Cart Transform API (Dynamic Bundling) - Real-time bundling that occurs during the cart process without creating products in your catalog. * Admin Bundling - Creates static bundles via Shopify's Admin API during the add-to-cart process. {% hint style="warning" %} Note: Both bundling methods have specific technical limitations and use cases. For detailed information about Cart Transform API limitations and when to choose each method, please see our Understanding Shopify Cart Transform API Limitations guide (Coming soon!) {% endhint %} ### Modular Products - Custom Bundling Methods Modular products use different bundling approaches that allow flexible element combinations. See the [Modular Product Bundles ](#shopify-bundling-methods-for-modular-products)section for detailed configuration. ## Creating Bundles in Mimeeq To create a bundle in Mimeeq, follow these steps: 1. Navigate to your product's configuration page 2. Open the **Pricing and Codes** tab 3. Find the **Add to Cart Configuration** section 4. In the **Method** dropdown, select your bundling approach - **Single Custom** **Product** or **Shopify Custom Defined Logic** **Single Custom Product** When you select **Single Custom Product**, your configured product will be added as a single item to the cart. This is the simplest approach where all components are combined into one product. **For Shopify integrations**, you can optionally set a **Product Breakdown Metafield Key**. This is the key of the JSON metafield where the app stores the product breakdown, entered in `namespace.key` format (e.g. `custom.product_breakdown`). The metafield must be configured as a JSON-type metafield in Shopify, otherwise the integration will not work. ![The Product Breakdown Metafield Key field in the Add to Cart Configuration panel](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2F8FOIezwCBZSmEUC0mkr2%2Fkey-shopify_gqqv29.png?alt=media) **Shopify Custom Defined Logic (Multiple Components)** When you select Shopify Custom Defined Logic, you have three independent options that can be used separately or together: 1. **Custom Products to Create** - Creates entirely new products in Shopify before adding to cart 2. **Single Variants to Add to Cart** - Adds existing Shopify variants directly to the cart as a single item 3. **Bundles** - Creates a grouped collection of products that are treated as a single unit. Choose between: * **Cart Bundle** (Cart Transform API) - For dynamic bundling * **Admin Bundle** - For static bundle creation ## Custom Products Configuration When creating custom products, configure the following: | Field | Description | | --------------- | ----------------------------------------------------------------------------------------------------------------------- | | Name | Product name with variable support. For example PC Case - `{{CASETYPE#name}}` - `{{Casecolour#name}}` - `{{shortcode}}` | | SKU Code | Optional SKU identifier | | Qty to Add | Quantity of this item | | Price Each | Individual item price | | Cart Parameters | Additional data passed to cart | ## Single Variants Configuration {% hint style="warning" %} ⚠️ Important: If your variant ID is being created dynamically (i.e. the variant does not already exist in Shopify before the add-to-cart call), be aware that newly created variants take time to propagate to Shopify's cart service — typically a few seconds, but occasionally up to \~30s. A variant may be readable via the Variants API while the cart service still rejects it with a 422 "sold out" error, even with inventory tracking disabled. This is a Shopify propagation delay, not a Mimeeq configuration issue. For dynamic configurations, we recommend using Custom Products instead of Single Variants where possible. Freshly created products propagate faster than variants appended to an existing root product, and this approach avoids Shopify's per-product variant ceiling. {% endhint %} For adding individual Shopify variants to bundles: | Field | Description | | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Varaint ID | Shopify Мariant ID. For example, it can either be created from block placeholders, using Item Master `{ItemMaster[{keyboardtype#code}]#commerceId}` or variant id directly 7234567890123 | | Qty | Quantity to add to the cart | | Cart Parameters | Additional variant data | ## Cart Bundle Configuration When creating Cart Bundle, configure the following: | Field | Description | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Bundle Name | Name of the bundle, only for internal use | | Price Method | Determines how component prices are calculated - Mimeeq (per item) or based on Shopify Variant (Uses Merge) | | Repeat Master in Components | Whether to include the master product in the component list | | Override Title | Customizes the bundle title using variables like {shortcode}, {productname} | | Override Image | None - use the default product image. Configurator image - override default image with a custom image for product and it may add a short delay (2-3 seconds) when adding product to your cart. | After you define main bundle settings, you can define variants that will be added to a bundle. | Field | Description | | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Is master | Defines the Master Product as the primary item in the bundle. Note that to add price to Master Product “Repeat Master in Components” have to be set up to Yes. Must be assigned to only one item per bundle | | Variant ID / Custom Product | Shopify Variant ID or created Custom Product | | Qty | Quantity of this item in bundle | | Price Each | Individual item price | | Cart Parameters | Additional data passed to cart | ## Admin Bundle Configuration When creating Admin Bundle, configure the following: | Field | Description | | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Bundle Name | Name of the bundle, only for internal use | | Price Method | Determines how component prices are calculated - Mimeeq (per item) or based on Shopify Variant (Uses Merge) | | Image | None - use the default product image. Configurator image - override default image with a custom image for product and it may add a short delay (2-3 seconds) when adding product to your cart. | | Title | Customizes the bundle title using variables like {shortcode}, {productname} | | Bundle Price | Price per bundle. Only available if Price Method - Mimeeq | After you define main bundle settings, you can define variants that will be added to a bundle. | Field | Description | | ----------------------- | ------------------------------------------------------------ | | Type | Variant ID or Product ID | | Variant ID / Product ID | Specify Shopify Variant ID or Product ID depends on the type | | Qty | Quantity of this item in bundle | ## Shopify Bundling Methods for Modular Products To create a bundle in Mimeeq for modular products, follow these steps: 1. Navigate to your product's configuration page 2. Open the **Products** tab 3. Find the **Add to Cart Configuration** section 4. In the **Method** dropdown, select your bundling approach. **Available Bundling Methods** | Method | **Description** | | --------------------------------------- | --------------------------------------------------------------------------- | | Custom Product | Creates a single custom product with element listed as cart line attributes | | Shopify All Elements as Single Items | Each element added individually to cart | | Shopify Single Bundle With All Elements | All elements bundled together | | Shopify Custom Defined Logic | Custom created bundle rules. Complex scenarios with multiple bundle groups | ## How to Configure Modular Product Bundles #### Method 1: Custom Product (Default) This is the current standard approach where all configured elements become one custom product. #### Method 2: Shopify All Elements as Single Items 1. Select "Shopify All Elements as Single Items" from the Method dropdown 2. Each element with a Shopify mapping will be added separately to the cart 3. Elements appear as individual line items in the cart #### Method 3: Shopify Single Bundle With All Elements When you select this method, additional settings appear: | **Field** | **Description** | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Price Method | Determines how component prices are calculated - Mimeeq (per item) or based on Shopify Variant (Uses Merge) | | Override Title | Customizes the bundle title using variables like {shortcode}, {productname} | | Override Image | No - use the default product image. Yes - override default image with a custom image for product and it may add a short delay (2-3 seconds) when adding product to your cart. | #### Method 4: Shopify Custom Defined Logic This advanced method allows you to create multiple custom bundles from your modular elements. **Additional Settings for Custom Logic:** | **Field** | **Description** | | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | How to Handle Undefined Elements | What happens to elements not in any bundle. Add Selected Only Elements as Single Items - Only elements that you select will be be added as single items to the cart if not specified into a bundle. Unselected products will not be added to cart. Add All Elements as Single Items - Any products that are not specified into a bundle will be added as single items to the cart. | | Single Items to Add | Specific elements to add as single items. *Available only if Add Selected Only Elements as Single Items selected* | **Creating Custom Bundles for Modular Products:** 1. Select "Shopify Custom Defined Logic" method 2. Configure how to handle undefined elements 3. Click "Add Bundle" to create a new bundle 4. For each bundle, configure: | **Field** | **Description** | | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Bundle Name | Name of the bundle, only for internal use | | Method | Type selection: Bundle or Custom product (create a standard custom product for each selected product, using component's specification as cart attributes) | | Price Method | Determines how component prices are calculated - Mimeeq (per item) or based on Shopify Variant (Uses Merge) | | Override Image | No - use the default product image. Yes - override default image with a custom image for product and it may add a short delay (2-3 seconds) when adding product to your cart. | | Override Title | Customizes the bundle title using variables like {shortcode}, {productname} | | List of Products to Include | Select which elements go in this bundle | {% hint style="warning" %} Only items shown on the finish screen are included in bundles (items with "Hide on Finish Screen" are excluded) {% endhint %} ## Related articles: 1. Shopify Cart Transform API Limitations (Coming soon!) 2. [Shopify App - Admin Settings](/commerce-and-integrations/shopify/admin-settings.md) 3. [**Shopify Latest Version Updates**](/commerce-and-integrations/shopify/changelog.md) --- # 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/add-to-cart.md?ask=&goal= ``` `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.