> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.syncbase.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🎛️ Metaobject synchronization: how does it work?

SyncBase lets you sync Shopify metaobjects with Airtable in just a few clicks. This guide explains how the sync works, what to watch out for, and how to create new entries from Airtable.

# General

* **One tab = one metaobject definition** 
* Each tab (or table) in your Airtable corresponds to a specific metaobject definition in Shopify.
* **One record = one entry** 
* Each row in your table represents one metaobject entry (i.e., a single instance).
* **One column = one field** 
* Each column match a field in your metaobject definition in Shopify.
* **Status ACTIVE/DRAFT for entry** 
* If you activate the `Active-draft status` option in the metaobject definition you will be able to update it from Airtable. If not, you won’t have values into this column.
* You can include Metaobjects in your Airtable-synced base during your onboarding (base generation step) or add them afterwards ([see tutorial here](https://help.syncbase.app/en/article/how-to-add-metaobjects-to-your-synced-base-id9zlt/)). 

# Required fields for metaobject

If a field is marked as required in your Shopify metaobject definition, make sure that every Airtable record has a value for it.

||| Missing required values will cause Shopify to reject the entire update.

# Creating new entries from Airtable

Yes—you can create new metaobject entries directly from Airtable!
Check out our [full guide to learn how to do it](https://help.syncbase.app/en/article/how-to-create-a-new-metaobject-entry-from-syncbase-1jypbf4/).

# Creating a new synced field for a metaobject definition

Already syncing a metaobject definition and want to add a new field to it? 

No problem—here’s how to make that field appear in your Airtable base:

1. Go to your Shopify admin: `Content` > `Metaobjects`
2. Select the desired definition
3. Click on `Manage definition`
4. Add the new field you need and click `Save`
5. Still in the Shopify admin, open **one existing entry** of this definition
6. Enter any value in the newly created field and save the entry

✅ That’s it! A new column should now appear in the corresponding Airtable tab. You can start filling in this field for all your entries directly from Airtable.

# Adding a new unsynced column to a metaobject tab

Want to keep internal notes or custom data that shouldn't sync back to Shopify? You can add unsynced columns to any metaobject tab.

__Here’s how__:

1. Open the desired metaobject tab in Airtable
2. Add a new column
3. Name it as you like, but be sure to **end the column name with `- SyncIgnore`

|| Example: if you want to create a column named "Hello", you will then need to name it "Hello - SyncIgnore"

✅ Done! This column will remain in Airtable and won’t be synced to or from Shopify.