Articles on: Synchronization

đź”— Metafields synchronization: how does it work?

You can 100% synchronize your Shopify metafields in Airtable thanks to SyncBase. This topic explains how it works.


Metafields sync available for


Metafields synchronization is currently available for:


  • Products
  • Variants
  • Orders
  • Customers


Metafields for other objects (Collections, Companies, Locations, Pages, Blogs...) will be soon available. If you're interested feel send us a message on the live chat!


Adding a new metafield definition after the base generation


To add a new metafield definition:


  1. Go to your Shopify settings.
  2. Add a new definition.
  3. Within Shopify, go to a product/variant/order/customer… and add an input to this new metafield.
  • Be sure to hit the “save” button to trigger a webhook.
  1. The column should appears within the linked tab of your Airtable synced base!


You can now use Airtable to add new values for this metafield.


Deleting a metafield definition


To delete a new metafield definition:


  1. Go to your Shopify settings.
  2. Delete the desired definition.
  3. That’s it! Data won’t be updated anymore.


Optional: you can 100% delete the linked column in your Airtable synced base.


Updating a metafield value within Airtable


You can absolutely update metafield values via Airtable! To do so, simply ensure the formatting matches Shopify's requirements.

For example, if a metafield definition has a type of “Color,” you’ll need to format the value as Shopify expects (e.g., #colorcode).


Unstructured metafields


Unstructured metafields are definitions created by third party app (example: Google Shopping) or archived metafields definitions.

We do not currently sync them inside metafields tab.


Metafields with reference types


Some Shopify metafields use reference types (for example: Product reference, Image reference, Collection reference, etc.). These metafields don’t store a simple value (text or number) but a reference to another Shopify object.


How reference values look in Airtable


When a metafield uses a reference type, the value synced into Airtable follows this format:


  • Image reference example gid://shopify/MediaImage/57257873768781
  • Product reference example gid://shopify/Product/10372488298805


This format must always be respected.


How to update a reference metafield value


To reference another object, you only need to replace the ID at the end of the value.


Example: gid://shopify/Product/10372488298805 → change 10372488298805 to the ID of another product.


Important notes:

  • The structure (gid://shopify/ObjectType/) must remain unchanged
  • Only the numeric ID at the end should be modified
  • This ID is the unique Shopify object ID


How to find the correct Shopify object ID


There are two ways to find the correct ID to use.


Option 1: From your Airtable synced base


  1. Open the related table (for example, Products, Orders, Customers, etc.)
  2. Look for the [Object name] ID field (Example: Product ID, Order ID, Customer ID)
  3. Copy the ID and use it in your metafield reference value


Option 2: From your Shopify admin URL


  1. Open your Shopify admin
  2. Navigate to the object you want to reference (product, order, customer, etc.)
  3. Look at the URL in your browser (Example for a producthttps://admin.shopify.com/store/yourstorename/products/10372488298805)
  4. The number at the end of the URL is the object ID


You can now safely use this ID inside your metafield reference value in Airtable.

Updated on: 13/01/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!