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

Shopify Error Recovery Center

Track configurator and cart errors in one place and follow up with affected customers. Learn to filter, export and resolve errors in the Error Recovery Center.

Running an online store means dealing with inevitable technical challenges, from pricing sync issues to API timeouts and configurator glitches. The Error Recovery Center transforms these potential roadblocks into opportunities for exceptional customer service.

View error logs, export data and follow up with customers who experienced problems, all in one place. When errors occur, they're automatically logged here and you receive email notifications (if configured). Each error record contains detailed information to help you quickly resolve issues and maintain customer satisfaction.

To receive email alerts for errors, configure notifications in your Mimeeq app settings. See Shopify Error Notifications for step-by-step instructions. Errors are only logged here when the notification category is turned on and Track in Error Recovery Center is enabled. Critical alerts are on by default; Optional diagnostics are off by default, so those errors only appear here after you turn them on.


Access the Error Recovery Center

  1. Log in to your Shopify admin panel.

  2. Navigate to the Mimeeq app.

  3. Click Error Recovery Center in the app menu.


Error data grid overview

The main view displays all error records in a data grid. Here's what each column means:

Column
Description

Error Type

The type of error that occurred (e.g. Zero Price, Add to Cart, Configurator Not Loading, Variant Not Available, Non Existing Variant)

Error Code

Unique code for tracking each error

Timestamp

Exact time when the error occurred

Status

Current status: Unresolved or Resolved (manually changeable)

Product Name

Name of the affected product (empty for configurator loading errors)

Page URL

Direct Shopify URL where the error occurred

Email

Customer's email address (if provided)

Name

Customer's name (if provided)

Comment

Customer's comment or note (if provided)

Error Recovery Center data grid listing error records with type, code, timestamp, status and customer details

Error types reference

The Error Recovery Center can log the following error types. Each maps to a notification category in your notification settings. Categories belong to one of two groups:

  • Critical alerts: issues that stop a customer from completing a purchase. On by default.

  • Optional diagnostics: deeper technical signals for troubleshooting. Off by default, so these errors are only logged after you turn the category on.

A single notification category can cover more than one underlying error type. For example, both Configurator not loading and App template error appear under the Configurator failed to initialize category in Notifications, but are stored and displayed as distinct labels in the Error Recovery Center.

Notification category
Group
Error Recovery Center label
What it means

Product price missing

Critical alerts

Zero price

A customer tried to add a product with no price or a $0 price

Add to cart failed

Critical alerts

Add to cart error

A customer couldn't add a configured product to cart due to a Mimeeq–Shopify connection or configuration problem

↳

Critical alerts

Non existing variant

The selected variant doesn't exist in the product catalogue. Tracked and emailed under the Add to cart failed category

↳

Critical alerts

Unknown error

An unexpected error occurred while adding to cart. The record may later show a more specific error type once the cause is identified

Variant not available

Critical alerts

Variant not available

The selected product variant is out of stock

Configurator failed to initialize

Optional diagnostics

Configurator not loading

The configurator failed to load or become ready in time

↳

Optional diagnostics

App template error

A missing or invalid template, or a custom interface that failed to load

Product failed to load

Optional diagnostics

Product failed to load

Network failure, server error, or invalid/missing product data

Customer data unavailable

Optional diagnostics

Customer data error

Required Mimeeq account metadata couldn't be loaded

Product not linked to configurator

Optional diagnostics

Short code error

The product has no shortcode connecting it to a configurator


Filter and sort errors

Find specific errors quickly using filters and sort options. Filter by status to focus on unresolved issues, or by error type to identify patterns. Sort by any column to organise the data the way you need.

Available filters:

  • Status: All, Unresolved, Resolved

  • Error Type: every error type listed in the Error types reference, including optional diagnostics

Status and Error Type filter dropdowns above the Error Recovery Center grid

Export error data

Click Export above the data grid to export your error data for further analysis. The system generates and downloads a CSV file with all your error records.


View error details

Click any error record to open a detailed view with complete information about the issue. The view has three main sections:

  • Error information with status controls

  • Customer contact details for follow-up

  • Product configuration data to help diagnose the problem

Detailed error view with error information, customer contact details and product configuration data

Manage errors

Change error status

Open the error detail view and use the status dropdown to mark the error as Resolved once the issue is fixed. We recommend adding internal notes to document what was done to resolve the issue for future reference.

Status dropdown and internal notes section in the error detail view

Follow up with customers

When a customer provides contact information, copy their email address from the detail view to send them a personalised follow-up message. After reaching out, update the error status to Resolved and add notes about the interaction to keep a complete record of how the issue was handled.


Best practices and troubleshooting

Follow these strategies for efficient error management and customer satisfaction:

  1. Prioritise by impact: focus on critical alerts first, and on errors affecting multiple customers or high-value products.

  2. Document resolutions: use internal notes to track what fixed each issue.

  3. Follow up promptly: contact customers within 24 hours when possible.

  4. Look for patterns: identify recurring issues that need permanent fixes.

Not seeing errors?

  • There is a chance you do not have errors, which is the most likely explanation. The Error Recovery Center only logs issues when they occur, so an empty error log typically indicates your store is functioning correctly.

  • Check whether the category is turned on. Optional diagnostics are off by default, so configurator loading, product loading, customer data and shortcode errors are not logged until you turn them on.

  • Check that Track in Error Recovery Center is checked for the category in your notification settings.

The primary email only controls email notifications. Errors are still logged in the Error Recovery Center without it, but no alerts are sent.

Missing customer information?

  • This is normal. Customers can choose not to provide contact details.

  • The customer error form works separately from notifications. If it isn't shown on your storefront, no contact details are collected.

  • Consider updating your error form messaging to encourage customers to submit contact information.


Last updated

Was this helpful?