Ecommerce Custom Field Mappings

Content

1. Overview
2. Where to Find Field Mapping Settings
3. Setting Up Mappings
4. Platform-Specific Field Types
5. Practical Examples
6. Validation and Error Prevention

Overview

Ecommerce Custom Fields Mappings allow you to pass additional product data — beyond the standard SKU and price — to your connected sales channel when a product or variant is created or added to cart. This lets you push configuration-specific metadata directly into Shopify products, Shopify variants, or WooCommerce product custom fields without any custom development.

When a customer configures and adds a product to cart, Mimeeq normally sends the SKU code and price to your ecommerce platform. With Custom Field Mappings, you can also send:

These mappings are evaluated at the time of product/variant creation and the values are written directly to the ecommerce platform record.

Where to Find Field Mapping Settings

1. Open any product in the Product Admin
2. Go to the Codes & Pricing tab
3. Scroll down to the Add to Cart Configuration section
4. Look for the Ecommerce Custom Fields Mappings collapsible panel

Setting Up Mappings

Step 1 — Select Your Method

At the top of Add to Cart Configuration, choose a Method. The method controls how configured products are sent to your sales channel, and it directly determines how field mappings are structured.

Step 2 — Select Your Integration Type

Once you've selected a method, set the Integration type:

The available mapping types update automatically based on your selection.

Step 3 — Configure Your Field Mappings

How you configure field mappings depends on the method selected in Step 2.

If you selected Single Product

A single flat mappings table is available. Click Add row to add individual field mappings directly.

Each row has three fields:

All mappings defined here are automatically applied to every product created via this configurator.

If you selected Custom Defined Logic

You can create one or more mapping groups, each containing its own set of field mappings. Groups can then be assigned to specific custom products and admin bundles.

Click Add mapping group to create a group. Each group:

• Has an optional Mapping Group Name for internal reference (not shown to customers)
• Contains one or more individual field mapping rows
• Can be added or removed as needed

Each row within a group has the same three fields as above: Type, Field / Key, and Value.

Platform-Specific Field Types

Shopify — Product Property

Maps to standard built-in Shopify product fields. Select from the predefined list:

Shopify — Product Metafield & Variant Metafield

Maps to custom metadata stored on the Shopify product or variant object.

Key format: namespace.key

custom.lead_time
custom.sku_internal
myapp.product_category

Validation rules:

• Must contain exactly one dot (.) separator
• Namespace: 3–255 characters
• Key: 2–64 characters

WordPress (WooCommerce) — Product Metafield

Maps to WooCommerce product _meta fields.

Key format: snake_case

custom_sku
lead_time_days
product_origin

Validation rules:

• 1–255 characters
• Lowercase alphanumeric with underscores only
• Must match the pattern lowercase_with_underscores

The Value Field

Static Values

Plain text or numbers written exactly as entered:

United Kingdom
true
GB
9401.61

Dynamic Formulas

Start the value with = to reference configuration data. Formulas can pull from:

• Option selections made by the customer during configuration
• Item Master data fields
• Mathematical calculations

Examples:

={fabric#code}
={frame_material#name}
={width_cm#value}

This means the value written to Shopify or WooCommerce can reflect exactly what the customer configured — for example, writing the selected material code as a searchable product metafield.

Practical Examples

Example 1 — Write a Material Code to a Shopify Variant Metafield

Store the selected fabric code in a Shopify variant metafield for use in order workflows.

Result: When a customer selects fabric LINEN_NATURAL and adds to cart, the Shopify variant record will include custom.fabric_code = LINEN_NATURAL.

Example 2 — Set Customs Data for Export Products

Apply HS code, country of origin, and tax code to every product created via this configurator.

Example 3 — Pass Lead Time to WooCommerce

Write the lead time for the selected material to a WooCommerce custom field.

Each material option carries its own lead time value (e.g. 14 for standard, 28 for bespoke), which is passed through dynamically.

Example 4 — Tag Bespoke Variants with a Custom Metafield

Flag made-to-measure products using a combination of a static taxable value and a dynamic bespoke identifier.

Validation and Error Prevention

Related Articles

1. Shopify Add to Cart Configuration Methods
2. Shopify Latest Version Updates: Your Guide to New Features and Enhancements
3. Custom Ecommerce Integration

Updated on: 16/03/2026