For the complete documentation index, see llms.txt. This page is also available as Markdown.

Shopify Add to Cart Methods

Control how configured products reach the Shopify cart, from single products to bundles. Learn to set up each add-to-cart method for standard and modular products.

Mimeeq provides advanced bundling functionality for 3D configurators integrated with Shopify stores. This feature allows you to group multiple product components into a single purchase unit, so complex product configurations can be added to cart as packages.

Before you start: 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. See Shopify Admin Settings to make sure all required settings are configured correctly.

Example of a bundled product in a Shopify cart

Bundling methods by product type

Standard products: two bundling approaches

Standard products support two bundling methods:

#
Method
How it works

1

Cart Transform API (Dynamic Bundling)

Real-time bundling that occurs during the cart process without creating products in your catalogue

2

Admin Bundling

Creates static bundles via Shopify's Admin API during the add-to-cart process

Modular products: custom bundling methods

Modular products use different bundling approaches that allow flexible element combinations. See Shopify bundling methods for modular products for detailed configuration.


Creating bundles in Mimeeq

To create a bundle in Mimeeq:

  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.

When you select Single Custom Product, your configured product is 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 Product Breakdown Metafield Key field in the Add to Cart Configuration panel

When you select Shopify Custom Defined Logic (multiple components), 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. See Custom products configuration.

  2. Single Variants to Add to Cart: adds existing Shopify variants directly to the cart as a single item. See Single variants configuration.

  3. Bundles: creates a grouped collection of products that are treated as a single unit. Choose between:


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

To add individual Shopify variants to bundles, configure the following:

Field
Description

Variant ID

Shopify variant ID. For example, it can be created from block placeholders using Item Master {ItemMaster[{keyboardtype#code}]#commerceId}, or entered directly as a variant ID (7234567890123)

Qty

Quantity to add to the cart

Cart Parameters

Additional variant data


Cart bundle configuration

When creating a Cart Bundle, configure the following:

Field
Description

Bundle Name

Name of the bundle, for internal use only

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

Customises the bundle title using variables like {shortcode}, {productname}

Override Image

None: use the default product image. Configurator image: override the default image with a custom image for the product; this may add a short delay (2–3 seconds) when adding the product to your cart

After you define the main bundle settings, define the variants that will be added to the bundle:

Field
Description

Is master

Defines the Master Product as the primary item in the bundle. To add a price to the Master Product, Repeat Master in Components must be set 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 the bundle

Price Each

Individual item price

Cart Parameters

Additional data passed to cart


Admin bundle configuration

When creating an Admin Bundle, configure the following:

Field
Description

Bundle Name

Name of the bundle, for internal use only

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 the default image with a custom image for the product; this may add a short delay (2–3 seconds) when adding the product to your cart

Title

Customises the bundle title using variables like {shortcode}, {productname}

Bundle Price

Price per bundle. Only available if Price Method is Mimeeq

After you define the main bundle settings, define the variants that will be added to the bundle:

Field
Description

Type

Variant ID or Product ID

Variant ID / Product ID

Shopify Variant ID or Product ID, depending on the type

Qty

Quantity of this item in the bundle


Shopify bundling methods for modular products

To create a bundle in Mimeeq for modular products:

  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

1

Custom Product

Creates a single custom product with elements listed as cart line attributes

2

Shopify All Elements as Single Items

Each element is added individually to the cart

3

Shopify Single Bundle With All Elements

All elements are bundled together

4

Shopify Custom Defined Logic

Custom bundle rules for complex scenarios with multiple bundle groups


How to configure modular product bundles

This is the standard approach, where all configured elements become one custom product.

  1. Select Shopify All Elements as Single Items from the Method dropdown.

  2. Each element with a Shopify mapping is added separately to the cart.

  3. Elements appear as individual line items in the cart.

When you select Shopify Single Bundle With All Elements, 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

Customises the bundle title using variables like {shortcode}, {productname}

Override Image

No: use the default product image. Yes: override the default image with a custom image for the product; this may add a short delay (2–3 seconds) when adding the product to your cart

This advanced method lets you 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 are added as single items to the cart if not specified in a bundle; unselected products are not added to cart. Add All Elements as Single Items: any products that are not specified in a bundle are 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 is selected

Create custom bundles for modular products

  1. Select Shopify Custom Defined Logic as the method.

  2. Configure how to handle undefined elements.

  3. Click Add Bundle to create a new bundle.

  4. Configure each bundle using the fields below.

Field
Description

Bundle Name

Name of the bundle, for internal use only

Method

Type selection: Bundle or Custom product (creates a standard custom product for each selected product, using the 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 the default image with a custom image for the product; this may add a short delay (2–3 seconds) when adding the product to your cart

Override Title

Customises the bundle title using variables like {shortcode}, {productname}

List of Products to Include

Select which elements go in this bundle


Last updated

Was this helpful?