Shopify Error Notifications

Get an email alert as soon as customers hit a configurator or cart error. Learn how critical alerts and optional diagnostics work and how to set them up.

Once you've installed the Mimeeq app in your Shopify store, you can enable instant email notifications. They alert you when customers experience issues with the 3D configurator or with adding a product to cart. This helps you quickly identify and resolve problems that could impact your sales, ensuring a smooth shopping experience for your customers.

Action required: if you have the Mimeeq app installed in your Shopify store, you must configure a primary email address to receive error notifications. This applies to all store admins. Without a primary email, no email alerts are sent when issues occur. Errors are still logged in the Error Recovery Center.

For each notification category, you choose what happens when the error occurs:

• Track only: a record is created in the Error Recovery Center with the error details.

• Track and email: a record is created in the Error Recovery Center and you also receive an instant email notification.

The customer error form is separate from notifications. When the form is shown on your storefront, customers who hit an error can leave their contact information, and it's added to the error record.

To learn more about how the Error Recovery Center works and how to use it, see Shopify Error Recovery Center. To customise the appearance and messages of the error form on your storefront, see Shopify Theme Extension.

---

Notification groups

The Notifications page splits notifications into two groups: Critical alerts and Optional diagnostics.

#	Group	What it covers	Default
1	Critical alerts	Issues that stop a customer from completing a purchase	On. We recommend keeping these on.
2	Optional diagnostics	Deeper technical signals for troubleshooting a specific customer issue or setup problem, like a configurator that won't load, a missing shortcode, or a customer data error	Off. Turn on individually as needed.

---

Critical alerts

Critical alerts cover issues that block a sale. They are turned on by default and marked Recommended on the Notifications page. We recommend keeping them on.

#	Error type	Description
1	Product price missing	A customer tried to add a product with no price set, or with a $0 price, usually indicating a pricing setup issue in your catalogue
2	Add to cart failed	A customer couldn't add a configured product to cart due to a connection or configuration problem between Mimeeq and Shopify. This also covers a selected variant that doesn't exist in the product catalogue
3	Variant not available	A customer selected a product variant that is currently unavailable or out of stock

---

Optional diagnostics

Optional diagnostics are off by default. Turn them on one at a time when you need to troubleshoot a specific customer issue or validate a new setup.

These reports don't always mean something is wrong. They can include isolated loading failures caused by unstable connections, ad blockers, privacy settings, network security restrictions, or temporary service interruptions. A single report doesn't necessarily point to an ongoing problem with your store configuration or Mimeeq. On busy stores, enabling all of these at once can mean a high volume of notifications. We recommend turning them on temporarily to validate a setup, then off again if they get noisy.

#	Error type	Description
1	Configurator failed to initialize	The configurator failed to load or become ready, caused by script errors, missing templates, or a custom interface that couldn't be loaded
2	Product failed to load	The configurator couldn't load product data, for example due to a missing or deleted product, an invalid shortcode, a server error, or invalid product data
3	Customer data unavailable	Required Mimeeq account metadata couldn't be retrieved, possibly due to a temporary service outage. This may affect personalised pricing or saved configurations
4	Product not linked to configurator	The configurator embed is missing a product shortcode, or the shortcode lookup returned no result, usually caused by an incorrect page setup

---

Set up notifications

1

Configure the primary email

The primary email receives all error notifications and is required for email alerts. It doesn't affect tracking in the Error Recovery Center.

1. Navigate to the Notifications settings.

2. Enter your primary email address in the Primary email settings field.

This email receives all email notifications by default.

Notifications settings with the primary email address field

2

Review critical alerts and turn on optional diagnostics

The Notifications page has seven categories: three under Critical alerts and four under Optional diagnostics. Some categories cover more than one underlying error type, which you can see in more detail in the Shopify Error Recovery Center.

Each category has a toggle to turn it on or off, and two controls:

• Track in Error Recovery Center: logs the error so you can review it later

• Send email notification: sends an alert to your team when the error occurs

Critical alerts are already on. Leave them on unless you have a specific reason to turn one off. Optional diagnostics are off; use the toggle to turn on only the ones you need.

You can also uncheck the two controls individually to mix and match, with one thing to keep in mind:

Unchecking Send email notification also turns off tracking. To keep tracking without emails, uncheck Send email notification, then re-check Track in Error Recovery Center, and click Save.

Notification category cards with Track in Error Recovery Center and Send email notification checkboxes

3

Add recipients and save

You can add extra recipients (comma-separated) to any category. The primary email is always included in all notifications.

Changes take effect after you click Save. Discard resets to the last saved state.

Important: zero price notifications are only sent when Block adding to cart is selected in the Zero Price Product Handling settings.

Zero Price Product Handling setting with Block adding to cart selected

---

Example email structure

Each notification email contains:

• Error type: e.g. "Zero Price Error", "Configurator Not Loading"

• Timestamp: when the error occurred

• Product URL: direct link to the affected product

• Error ID: unique identifier for tracking

• Configuration details: short and long configuration code

• Customer details: if provided by the customer

Example error notification email with error type, timestamp, product URL and configuration details

---

Best practices

1. Keep critical alerts on so you hear about every issue that blocks a purchase.

2. Use optional diagnostics temporarily to validate a new setup or investigate a specific customer report, then turn them off if they get noisy.

3. Test your notifications after setup to ensure emails are delivered.

4. Add team members who need immediate awareness of issues.

5. Check spam folders if notifications aren't received.

6. Review the Error Recovery Center regularly for patterns.

---

Related articles

Shopify Error Recovery Center

Track errors and follow up with affected customers.

Shopify Admin Settings

Connect your API key, products and cart settings.

Shopify Theme Extension

Add configurators and buttons to your storefront theme.

Changelog

See the latest Shopify app features, improvements and fixes.