> 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/changelog/shopify.md).

# Shopify

New features, improvements and fixes in the Mimeeq Shopify app. Historical entries start at version 2.0.

{% updates format="full" %}
{% update date="2026-09-16" tags="improvement" %}

## Version 4.17.0

**👍 Improvements**

* New storefront error types — Tracking for product data, customer data, short code and configurator template errors.
* Error settings per type — Error tracking and email notifications can now be turned on or off separately for each error type.
* Configurator loading errors — More reliable detection of configurator loading failures.
* Multiple embeds warning — The theme editor warns when a page has more than one Mimeeq embed.
  {% endupdate %}

{% update date="2026-09-15" tags="improvement" %}

## Version 4.16.0

**👍 Improvements**

* B2B company location catalogs in Multi-Market Pricing — Company location catalogs can now be mapped to Mimeeq Public Price List Groups alongside market catalogs, so B2B buyers get the correct Mimeeq price for configured products.
  {% endupdate %}

{% update date="2026-08-25" tags="improvement,fixes" %}

## Version 4.15.0

**👍 Improvements**

* Automatic access token renewal — The app now uses Shopify's expiring access tokens and renews them automatically in the background. Existing stores are upgraded on first use, with no reinstall or reauthorisation required, keeping the app compliant with Shopify's January 2027 requirement. Stored credentials are now protected with stronger authenticated encryption.
* Mimeeq items identifiable in the cart — Bundles and their component products now carry a hidden \_\_isMimeeq line item property, making Mimeeq-created items easy to single out in the cart and at checkout for theme customisation and third-party integrations.

**🛠️ Bug fixes**

* Fewer false "variant unavailable" errors on bundles — Adding a configured bundle to the cart now retries up to three times while Shopify catches up with stock for newly created variants, instead of failing on the first attempt. Genuinely sold-out items still report immediately, as before.
  {% endupdate %}

{% update date="2026-08-21" tags="fixes" %}

## Version 4.14.2

**🛠️ Bug fixes**

* Fixed an issue where adding a configured product to the cart could occasionally fail on stores using static bundles.
* Fixed unnecessary errors being reported when updating market prices for a bundle whose product had been removed from Shopify.
  {% endupdate %}

{% update date="2026-08-13" tags="fixes" %}

## Version 4.14.1

**🛠️ Bug fixes**

* Fixed issue causing the Error Recovery Center to display only part of the error list on stores with a large number of reported errors.
  {% endupdate %}

{% update date="2026-08-03" tags="new-features" %}

## Version 4.14.0

**🚀 New features**

* Extend component breakdown metafield support to regular (non-modular) products, so the same custom metafield can now be populated with breakdown JSON regardless of product type.
  {% endupdate %}

{% update date="2026-07-03" tags="new-features" %}

## Version 4.13.0

**🚀 New features**

* Add support for a component breakdown metafield key, which lets you specify the custom metafield that will be populated with the modular product breakdown JSON.
  {% endupdate %}

{% update date="2026-06-16" tags="fixes" %}

## Version 4.12.1

**🛠️ Bug fixes**

* Fixed issue causing skeleton loader to incorrectly persist for 20 seconds whenever modular configurator is loaded in non-modal layout.
  {% endupdate %}

{% update date="2026-05-14" tags="improvement" %}

## Version 4.12.0

**👍 Improvements**

* Enhanced custom product configuration — Custom products (from commerce settings) now automatically inherit theme templates and tags from store configuration. Product descriptions are also auto-populated with cart parameters defined in the custom product configuration, streamlining the setup process.
  {% endupdate %}

{% update date="2026-05-06" tags="new-features,improvement" %}

## Version 4.11.0

**🚀 New features**

* Add validation logic for custom mapping data with optional field support, allowing the add-to-cart operation to proceed even when optional custom mappings contain invalid data.
* Add an option to copy variant IDs directly from the Shopify product details view for easier reference and integration.

**👍 Improvements**

* Relocated extension settings to the primary settings tab for easier access and improved user experience.
* Integrated skeleton loader directly into the Dynamic Configurator and Standalone blocks with a new **Enable skeleton loader** toggle in the Skeleton Loader Settings section, eliminating the need for a separate Mimeeq Skeleton Loader block (available for inline embeds only; [learn more](/commerce-and-integrations/shopify/theme-extension.md#skeleton-loader))
  {% endupdate %}

{% update date="2026-03-31" tags="new-features,fixes" %}

## Version 4.10.0

**🚀 New features**

* Add support for custom mapping data that uses shipping data placeholders, including delivery time and weight of the selected configuration.

**🛠️ Bug fixes**

* Automatically remove storefront access tokens when the store reaches its limit of 100 tokens.
  {% endupdate %}

{% update date="2026-03-26" tags="fixes" %}

## Version 4.9.3

**🛠️ Bug fixes**

* Fixed an issue where cart transform bundles were not created correctly when using the merge operation with master components that had a quantity greater than 1.
  {% endupdate %}

{% update date="2026-03-25" tags="fixes" %}

## Version 4.9.2

**🛠️ Bug fixes**

* Fixed an issue where cart transform bundles were not created correctly when using the expand operation with master components that had a quantity greater than 1.
  {% endupdate %}

{% update date="2026-03-18" tags="fixes" %}

## Version 4.9.1

**🛠️ Bug fixes**

* Filter out bundles when the master component has no variant ID defined.
  {% endupdate %}

{% update date="2026-03-16" tags="new-features,improvement" %}

## Version 4.9.0

**🚀 New features**

* Added product status selection for new products. Users can now choose between "Unlisted" or "Active" when creating products, replacing the previous default of Active only.

**👍 Improvements**

* Implemented retry logic for add-to-cart operations to handle Shopify's product propagation delays.
* Added Skeleton Loader Block. Learn how to add the **Mimeeq Skeleton Loader** to your page in our [help article](/commerce-and-integrations/shopify/theme-extension.md#skeleton-loader).
  {% endupdate %}

{% update date="2026-03-09" tags="new-features,fixes" %}

## Version 4.8.0

**🚀 New features**

* Add support for custom property mappings, enabling you to populate product properties and metafields that aren't used by the app by default.

**🛠️ Bug fixes**

* Fixed an issue where the return URL for dynamic bundles was not properly encoded, which prevented the configurator from loading correctly.
  {% endupdate %}

{% update date="2026-02-25" tags="improvement" %}

## Version 4.7.1

**👍 Improvements**

* Filter out bundles where all components have a quantity of 0
  {% endupdate %}

{% update date="2026-02-23" tags="new-features,improvement" %}

## Version 4.7.0

**🚀 New features**

* Add an option to include a return URL in dynamic bundles, enabling users to navigate back to their selected configuration.
* The pound (lb) weight unit is now supported.

**👍 Improvements**

* Add support for Custom UIs in Cart Processing Tooltip block.
  {% endupdate %}

{% update date="2026-01-30" tags="new-features,fixes,improvement" %}

## Version 4.6.0

**🚀 New features**

* Add support for compare-at pricing across custom products, product variants, and bundles.

**👍 Improvements**

* Updated default settings for Mimeeq Advanced Button.
* Add new customization options to Cart Processing Tooltip (respective tooltip delays, colour palette, icon change).

**🛠️ Bug fixes**

* Fixed Cart Processing Tooltip display bug causing second and third message to disappear immediately.
  {% endupdate %}

{% update date="2026-01-14" tags="new-features,improvement" %}

## Version 4.5.0

**🚀 New features**

* Add support for static product bundles through Shopify product configuration, enabling merchants to create on-the-fly product groupings that sync with Mimeeq bundle settings and appear as standard products in the Shopify catalog.
* Add support for price list mappings to synchronize pricing between Shopify and Mimeeq, enabling automatic price updates across different markets and currencies for each product configuration.

**👍 Improvements**

* Introduced dedicated error types to handle variant out-of-stock scenarios and non-existent variant references.
* Storefront API access tokens can now be regenerated if the cached token becomes invalid.
  {% endupdate %}

{% update date="2025-12-09" tags="fixes" %}

## Version 4.4.2

**🛠️ Bug fixes**

* Implemented filtering mechanism to exclude component products from synchronization operations, resolving errors that occurred when these products were included in the sync process.
  {% endupdate %}

{% update date="2025-12-05" tags="fixes" %}

## Version 4.4.1

**🛠️ Bug fixes**

* Fixed incorrect product short code display in recovery center error entries.
* Added modular configuration URL property to error entries, enabling better error tracking and resolution.
  {% endupdate %}

{% update date="2025-10-21" tags="improvement" %}

## Version 4.4.0

**👍 Improvements**

* Bundle images are now reused for identical configurations, improving performance by skipping redundant image uploads and creating a cleaner cart experience by automatically merging identical bundles.
  {% endupdate %}

{% update date="2025-10-17" tags="new-features" %}

## Version 4.3.0

**🚀 New features**

* Expand dynamic product bundles capabilities with support for modular products, enabling more flexible and configurable product combinations through the Cart Transform API.
  {% endupdate %}

{% update date="2025-09-22" tags="fixes" %}

## Version 4.2.2

**🛠️ Bug fixes**

* The quantity from the configurator is now correctly applied to the number of bundles in the cart.
* Multiple bundles with the same master product created by MERGE operations no longer cause cart errors.
  {% endupdate %}

{% update date="2025-09-17" tags="improvement" %}

## Version 4.2.0

**👍 Improvements**

* Reimplement the Cart Transform function in Rust to enhance performance and support a higher volume of bundles in the shopping cart.
* Identical variants within bundle components are now consolidated into a single entry.
  {% endupdate %}

{% update date="2025-09-11" tags="fixes" %}

## Version 4.1.1

**🛠️ Bug fixes**

* Simplify bundle payload signature to increase the capacity of the Cart Transform function, allowing more bundles to be added to the cart.
  {% endupdate %}

{% update date="2025-09-10" tags="new-features" %}

## Version 4.1.0

**🚀 New features**

* Add support for dynamic product bundles through the Cart Transform API, enabling merchants to create customized product groupings in real-time based on Mimeeq bundle settings
  {% endupdate %}

{% update date="2025-08-21" tags="new-features,improvement" %}

## Version 4.0.0

**🚀 New features**

* Introduce [Error Recovery Center](/commerce-and-integrations/shopify/error-recovery.md) - a centralized dashboard for monitoring and managing all app-related errors in one convenient location.
* Introduce [Email Notifications](/commerce-and-integrations/shopify/error-notifications.md) to instantly alert users when problems arise, delivering timely notifications about app issues.

**👍 Improvements**

* Redesigned App Dashboard with improved layout featuring quick access to key features (API keys, settings, product sync, notifications), added helpful resources section, and enhanced navigation flow.
* Completely redesigned configurator button with new visual effects, animations, and customization options while maintaining backward compatibility.
  {% endupdate %}

{% update date="2025-06-02" tags="improvement" %}

## Version 3.7.0

**👍 Improvements**

* Product short code is now generated on the Backend side, which eliminates potential desynchronization between configuration code and short code
  {% endupdate %}

{% update date="2025-05-06" tags="fixes" %}

## Version 3.6.1

**🛠️ Bug fixes**

* Fix issue with weight not being set for modular products
  {% endupdate %}

{% update date="2025-04-02" tags="new-features" %}

## Version 3.6

**🚀 New features**

* Add support for Mimeeq basket. If the embed template assigned to the Shopify product template is configured to use Mimeeq basket, products from the configurator will be added to our internal basket instead of a Shopify one.
  {% endupdate %}

{% update date="2025-03-29" tags="fixes" %}

## Version 3.5.2

**🛠️ Bug fixes**

* Fix validation errors caused by blank values in product/variant metafields
  {% endupdate %}

{% update date="2025-03-20" tags="fixes" %}

## Version 3.5.1

**🛠️ Bug fixes**

* Fix issues with product creation request being sent before the preview image is fully uploaded
  {% endupdate %}

{% update date="2025-02-17" tags="new-features" %}

## Version 3.5

**🚀 New features**

* SKU code is now being set for all newly created products and variants
* Added a new setting, which allows users to customise the SKU code structure
  {% endupdate %}

{% update date="2025-02-12" tags="improvement" %}

## Version 3.4

**👍 Improvements**

* Mimeeq Button supports custom UI settings
  {% endupdate %}

{% update date="2024-11-27" tags="new-features" %}

## Version 3.3

**🚀 New features**

* A new setting for creating products for each embed template was added. Once enabled, each template will be assigned to a separate Shopify product or variant instance. This is useful if you want to have different price lists for various customer groups, such as end clients vs B2B resellers.
  {% endupdate %}

{% update date="2024-11-05" tags="improvement,fixes" %}

## Version 3.2

**👍 Improvements**

* Modular products now have a breakdown specification on the cart page and order, indicating the specification for each element of the modular configurator.

**🚀 New features**

* Added support for allowing non add to cart embed scenarios if you wish to not add to cart now you can set the embed template to non basket mode and it will be respected. This is useful if you want to use Shopify as a non-shopping site.
  {% endupdate %}

{% update date="2024-10-18" tags="improvement,new-features" %}

## Version 3.1

### 👍 Improvements

* Improved error handling for some common issues like removal of non-existing images or exceeding the number of media per product

**🚀 New features**

* Added a new setting for allowing/disallowing products with zero price to be added to the cart. If not allowed, users will be shown an error message if the product has no price.
  {% endupdate %}

{% update date="2024-10-03" tags="new-features,improvement" %}

## Version 3.0

**👍 Updated Shopify Dependencies**

* We made a significant update to support the depreciation of rest API and added support for GraphQL.

**🚀 New features**

* Allow for override price list to be set, for the who store to support multiple market price lists, this allows you to use different templates for the visual display in the configurator and a different price list for the products that are added to the cart.
  {% endupdate %}

{% update date="2023-11-16" tags="improvement,new-features" %}

## Version 2.0

**🚀 New features**

* Pass weights based on the configuration to Shopify newly created products, to learn more about using Item master to pass weights read [Item Master](/pricing-and-codes/pricing-setup/item-master.md)

**👍 Improvements**

* Mimeeq Button text changed from Upper Case to Natural Text Case
* Removed override price group on the standalone app block
* Added the new URL for Embeds to take advantage of our new global CDN
* Sync new products only sync active products and no longer sync draft products
* Update to default settings for newly installed apps
  {% endupdate %}
  {% endupdates %}


---

# 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/changelog/shopify.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.