Using Shopify Metafields in xConnector

Shopify metafields let you store additional information about your products and variants beyond the standard Shopify fields. In xConnector, this information can support both invoicing and warehouse operations—from using a specific product name or code on invoices to recording warehouse, row, and shelf locations for easier product picking.

This allows you to keep your storefront product details unchanged while providing the information needed for your internal workflows. To use these values in xConnector, create the supported metafields with the required namespace, key, and type, then enable metafield reading in your settings.

xConnector reads supported metafields when:

• The Read order and product metafields option is enabled.
• The metafields use the required namespace, key, and type.
• Values have been entered for the relevant products or variants.

How Metafield Values Are Applied

Supported metafield values take priority over the corresponding information in the order. If no corresponding metafield is available, xConnector uses the original order data.

This override applies to the corresponding field—not to all the information in the order.

For example:

Supported Product Metafields

The table below uses the xconnector namespace shown in the configuration example.

Configuration

step 1 Create the Metafields in Shopify

Create the metafield definitions at the appropriate level:

• Product variant: for products with variants.
• Product: for products without variants.

For each definition, use the exact namespace, key, and type required by xConnector.

For example, to configure an alternative product name:

Important: xconnector is the namespace. xconnector.product-name is the combined namespace and key, not the namespace alone.

step 2 Enable Metafield Reading in xConnector

Go to:

xConnector → Profile → Preferences → Automation

Enable Read order and product metafields.

The metafield values will be read automatically during the next synchronization (next day, after 07.00 a.m)

To refresh the metafield newly created:

1. Open an order in xConnector that contains the relevant product.
2. Click the product within the order.
3. Click Refresh metafields.

Example: Use a Different Product Code on the Invoice

Your product’s original code is AAA, but you want AAB to appear on the invoice.

1. Create xconnector.product-code with the type Single line text at the appropriate product or variant level.
2. Enter AAB as the metafield value.
3. Enable metafield reading in xConnector.
4. Wait for synchronization or use Refresh metafields.
5. Generate the invoice.

The invoice will use AAB, not AAA, because the metafield value takes priority. If the product has no corresponding metafield, xConnector uses the original code, AAA.

Contact

➡️ Need help with xConnector? We are just a message away:

Chat: click the blue chat icon (bottom-right)
E-mail: support@xconnector.app
Phone: +4 0373 747 991

➡️ Stay connected with xConnector:

Facebook group: https://www.facebook.com/groups/shopify.romania.xconnector
Facebook page: https://www.facebook.com/xConnectorApp
TikTok: https://www.tiktok.com/@xconnector.app
YouTube: https://www.youtube.com/@xconnector_app