Shopify App - Admin Settings
Content
This guide will walk you through configuring the Mimeeq Shopify app settings from your admin panel.
- Step 1: Install the Mimeeq Shopify App
- Step 2: Configure Your API Key
- Step 3: Configure Primary Settings
- Step 4: Connect Your Products with Mimeeq
- Step 5: Configure Notifications
- Add Mimeeq to Your Storefront
Step 1: Install the Mimeeq Shopify App
If you haven't already done so, install the Mimeeq App from the Shopify App Store. When you first access the Mimeeq App, you'll see a welcome dashboard with notification banners reminding you to add your API key and configure email notifications, along with four quick setup steps that guide you through the essential configuration process:
- API Key - connect your Mimeeq account to Shopify
- Primary Settings - configure core functionality
- Products Sync - synchronize your products with Mimeeq
- Notifications - set up notification preferences
Step 2: Configure Your API Key
The API key allows Shopify to connect with the Mimeeq service on your behalf.
Where to Find Your API Key
- Go to your Mimeeq Admin Panel
- Navigate to Settings > Account Settings
- Find your API key and click Copy
How to Add Your API Key
- In the Mimeeq App dashboard, click on the API Key card or navigate to it from the menu
- Click the Edit button
- Paste your API key into the field
- Click Save
Step 3: Configure Primary Settings
Click on Primary Settings from the Quick Setup section or navigate to it from the menu. The settings are organized into several sections:
Cart Configuration
Setting | Description | Options |
---|---|---|
Cart Product Creation Method | Choose how configured products are handled when customers add them to cart | Create new product (Recommended) - each configuration becomes a separate product; Create product variant - adds configurations as variants to existing products |
After Add to Cart Action | What happens after a customer successfully adds a configured product to their cart | Redirect to Cart (Recommended) - takes customer to their cart; Close Modal - closes the configurator window; Do Nothing - keeps the configurator open |
Zero Price Product Handling | Control what happens when a configured product has no price set | Block adding to cart (Recommended) - shows error message and prevents adding; Allow adding to cart - allows zero-price items (use only if setting prices manually later) |
Pricing Configuration
Setting | Description | Options |
---|---|---|
Market-Specific Pricing | Override configuration pricing with market-specific rates when customers add items to cart | Price List Group ID field |
Create New Product for Each Embed Template | When using multiple embed templates for different markets, enable this to create separate products for each template. Note: This option is disabled when using market-specific pricing | Yes - creates separate products for each template; No - uses the same product across templates |
How to find your Price List Group ID:
- Go to your Mimeeq Admin Panel → Settings → Pricing
- Find your market-specific price list
- Copy the Group ID and paste it to Price List Input Field
Dynamic Fields Settings
Setting | Description |
---|---|
Information to Include with Orders | Select which product details to include with cart items (specification is always included by default) |
SKU | Define how SKUs are populated for configured products. Accepts dynamic variables |
Product Template | Default theme product page template assigned to newly created products. Only applicable if "Create New Product" option is selected as the Product Creation Type. |
Cart Product Name Template | Format pattern for the title of newly created products. Accepts dynamic variables. Only applicable if "Create New Product" option is selected as the Product Creation Type. |
Cart Product Description Template | Format pattern for the description of newly created products. Accepts dynamic variables. Only applicable if "Create New Product" option is selected as the Product Creation Type. |
Tags | Tags automatically added to new configured products. Only applicable if "Create New Product" option is selected as the Product Creation Type. |
Available Variables
Use these variables in your templates by wrapping them in curly brackets (e.g., {productName}):
Variable | Description |
---|---|
{specification} | Breakdown of the selected options. For example, for a chair with 2 options (fabric and base type), this will list those options along with the selected parameters |
{productName} | Display name of the product in the Mimeeq app |
{sku} | Dynamic SKU code created for the specific configuration |
{shortCode} | Short unique code based on the specification (autogenerated by Mimeeq) |
{code} | Variant code for the product in the Mimeeq app |
Properties Passed to Products
Here's what information is always automatically passed to newly created products or variants:
Name | Details | Default Setting | Configured in App Settings |
---|---|---|---|
Name | Product name based on template pattern | -- | ✅ |
Description | Description based on template pattern | -- | ✅ |
Image | Final configured product image | ✅ | -- |
Sale Price | Calculated price from configuration | ✅ | -- |
Cost Price | Cost price (even if zero in Mimeeq) | ✅ | -- |
Weight | Total weight if configured in Item Master | ✅ | -- |
Tags | As configured in settings | -- | ✅ |
Product Template | As selected in settings | -- | ✅ |
Step 4: Connect Your Products with Mimeeq
When connecting product configurations from Mimeeq to your Shopify products, there are two methods you can use:
Method 1: Manual Product Setup (For Existing Products)
If your products already exist in Shopify and you want to map the configurator to a product page with Shopify that you've already created, you would need to do this manually.
Manually Mapping Mimeeq Products When Using the Create New Product Method
If you're using the "Create new product" method, you'll need to add the embed shortcode to your existing Shopify products:
- Navigate to the product in Shopify
- Scroll to the bottom and click Product metafields
- Find the "Mimeeq Embed Shortcode" field
- Copy the embed shortcode from your Mimeeq app and paste it here
Manually Mapping Mimeeq Products When Using the Create Variant Method
If you're using the "Create product variant" method, you'll need to create a mapping so Mimeeq knows where to create the new variants:
- Open product page in Shopify where you want variants to be created
- Click More actions (three dots) in the top right
- Select Create product mapping (Mimeeq icon)
- Enter the Product ID which you copy from Mimeeq
- Save the mapping
Method 2: Sync Products from Mimeeq (For New Stores)
If you're starting with a new store, a faster way is to use the sync from Mimeeq. This will create new products which you can edit later, but all the mapping will already be in place.
How to Sync Products
- Navigate to Products Sync from the Quick Setup section or menu
- Select your synchronization mode:
- Add only new and active products (Recommended) - only syncs products not previously synced
- Override all - overwrites any changes made since last sync
- Click Synchronise products
- Wait for the sync to complete
When you sync products from Mimeeq, they'll be set up with all the information in the metafields ready to use in your storefront.
Understanding Metafields
Metafield Name | Purpose |
---|---|
Mimeeq Embed Shortcode | The embed shortcode you copy from the Mimeeq app. It tells the system which configurator to load for this product/variant. |
Mimeeq Configuration Shortcode | Automatically populated after a product is added to cart. Stores the shortcode for the specific configuration, which can be used in API calls. For modular configurators, this ensures the correct scene loads when customers click the item from their cart. |
Mimeeq Configuration Code | The long configuration code that defines the product configuration. Not used for modular configurators |
Mimeeq Product ID | 🚫 Deprecated since 04/07/23 and not required. If you see this in your metafields, you can delete it or leave it. No longer used by the Mimeeq app. For installs after 04/07/23, this field won't be present. |
Setting Different Starting Configurations
You can create multiple entry points in your store with different starting configurations. For example, if you offer a chair in three popular materials, you can create separate product listings that each load the configurator with a specific material pre-selected.
How to Set a Starting Configuration
- Go to the product in Mimeeq Admin
- Click Preview
- Configure the product with your desired starting options
- Click More Options → Copy Config Code
- For Standard Configurators: Paste the code into the "Mimeeq Configuration Code" metafield
- For Modular Configurators: Paste the code into the "Mimeeq Configuration Shortcode" metafield
This ensures that when customers click on that specific product listing, the configurator loads with your pre-selected options already applied.
Managing Variant Limits
Shopify has a 100-variant limit per product. Mimeeq manages this automatically by:
- Creating new variants for unique configurations
- Reusing variants when configurations and prices match
- Deleting and recreating variants when prices change
- At 99 variants, removing the oldest modified variant to make room for new ones
Step 5: Configure Notifications
Set up notification preferences to stay informed about errors. For detailed instructions, see our separate guide: How to Set Up Error Notification Emails.
Add Mimeeq to Your Storefront
After configuring the app settings, you'll need to add the Mimeeq configurator to your storefront theme. See our guide: Shopify App Theme Extension - Configure Your Storefront
Related Help Articles
- Error Recovery Center Guide
- Shopify App Theme Extension - Configure your Store Front
- Shopify Latest Version Updates
Updated on: 03/09/2025
Thank you!