Introduction

This article explains how to synchronize order custom fields from Shopify into TRAEDE. In Shopify, these fields are called note attributes, and they can be transferred into TRAEDE order custom fields as long as the field names match between the two systems.

This guide is useful for users who want to import order reference numbers, gift messages, delivery instructions, or any other custom data from Shopify orders.

Understanding how fields must match

Shopify order custom fields are stored as note attributes.
In TRAEDE, these map to order custom fields.

To ensure correct synchronization:

• The field name must match exactly between Shopify and TRAEDE.

• TRAEDE converts field names automatically by:

  • Lowercasing all letters

  • Replacing spaces with underscores

Example:

• Display name in TRAEDE: Order reference

• Internal field name used for syncing: order_reference

Therefore, in Shopify, the note attribute must also be named:

order_reference

This naming rule is essential.

Example scenario

You want to transfer this Shopify note attribute:

Additional details → order_reference: 12345

…into this TRAEDE field:

Order reference (internal name: order_reference)

If the names match, TRAEDE will import the value correctly.

Step 1: Enable syncing in TRAEDE

1. Go to the Shopify settings in TRAEDE.

2. Scroll down to Sync order custom fields.

3. Select the custom fields you want to sync (e.g., order_reference).

4. Click Save.

TRAEDE supports syncing any number of custom fields, as long as names match.

Step 2: Re-import the order

To test that everything works:

1. Re-import the order from Shopify (via Document Exchange).

2. Open the order in TRAEDE.

You should now see that:

• The Shopify value

• → Has been transferred into the matching TRAEDE custom field

Example:

• Shopify: order_reference = 12345

• TRAEDE: Order reference = 12345

What about checkbox fields?

If you want to synchronize checkbox logic instead (e.g., mark an order as “Gift order” when certain conditions are met), this requires a different setup.

A separate guide explains how to synchronize Shopify custom fields into TRAEDE checkbox fields.
See the next article in this series after this one.