How to Import Products with Custom Metafields into Shopify

Shopify’s default product fields are often not enough to store all the information modern online stores need. That’s where custom metafields come in. Metafields allow you to add and manage extra product data, such as technical specifications, material details, size charts, warranty information, internal flags, or app-specific attributes, without cluttering standard product fields. Shopify custom metafields give you complete flexibility to structure and store product data exactly the way your store requires.

For stores with large or complex catalogs, managing these custom metafields manually can quickly become inefficient. Updating each product one by one isn’t practical when you’re dealing with hundreds or thousands of items, or when migrating data from another platform. In these cases, using a structured import process becomes essential.

In this guide, we’ll focus on how to work with custom product metafields in Shopify and show you how to import product data along with these metafields using the StoreRobo Import Export app. You’ll learn how to create metafield definitions correctly, format your data so Shopify recognizes it, and bring everything into your store accurately and at scale.

Before importing products with custom data, it’s important to understand how metafields work in Shopify and how they’re structured. Once you get the basics right, working with metafields becomes much easier.

What Are Product Metafields in Shopify?

Product metafields are custom fields that let you store extra information for your product; data that doesn’t fit into Shopify’s default fields like title, price, or description.

Stores commonly use product metafields to store things like:

• Technical specifications
• Material or ingredient details
• Size charts or dimensions
• Warranty or care information
• Internal flags or identifiers
• Data required by apps or custom themes

Metafield Components Explained

Every metafield in Shopify is made up of three key parts:

1. Namespace

The namespace helps group related metafields together. Namespaces keep your metafields organized and prevent conflicts with apps or themes.

For example:

• custom
• specs
• details

2. Key

The key is the unique name of the metafield within its namespace. When combined with the namespace, it uniquely identifies the metafield.

For example:

• material
• warranty_period
• is_fragile

3. Data Type

The data type defines what kind of value the metafield stores, such as:

• Text
• Number
• Boolean (true/false)
• Date
• URL
  

When importing metafields via CSV, Shopify expects the column headers to follow a specific format.

For product metafields, the format is: Meta namespace.key (type)

For example:

• Meta custom.material (single_line_text)
• Meta specs.weight (number)
• Meta custom.is_fragile (boolean)

A Shopify metafield definition is a rule set that tells Shopify what kind of custom data you want to store and how it should be handled. In simple terms, it’s a way to define a custom field before you start using it.

Before you import products with custom metafields, you need to create the metafield definitions in Shopify first. This step is important because Shopify uses these definitions to understand what kind of data it should expect for each metafield.

If a metafield definition doesn’t exist before the import:

• Shopify may ignore the metafield data
• The import can fail due to a data-type mismatch
• Your metafields may appear unmapped or incomplete after import

Creating definitions in advance ensures that Shopify knows exactly how to store and display the incoming data.

Creating a Metafield Definition

You can create product metafield definitions directly from your Shopify admin by navigating to: Settings > Metafields and metaobjects.

• In the Metafields section, select where you want the metafield to apply. To add a metafield for products, choose Products and click Add Definition. 

When adding a new metafield definition, Shopify will ask for a few details. Each of these needs to match what you plan to import via CSV.

1. Name: The name is the label shown in your Shopify admin. Choose a clear, descriptive name that’s easy to recognize

Examples: Material, Warranty Period, Technical Specifications

This name is for admin use only and does not affect how the metafield is referenced in your CSV file.

2. Data Type: The data type defines what kind of value the metafield can store. This must match the format of the data in your CSV file.

Common data types include:

• Single line text
• Multi-line text
• Number
• Boolean (true/false)
• Date
• URL

If the data type selected in Shopify doesn’t match the values in your CSV, the metafield may fail to import or be ignored.

You can learn more about setting up custom metafield definitions by referring to Shopify’s official documentation. 

Once your metafield definitions are in place, Shopify is fully prepared to receive your custom product data. This makes the import process smoother, prevents errors, and ensures that all metafield values are stored exactly where they should be.

With your definitions ready, you can now move on to preparing your CSV file for import.

Step 2: Prepare Your CSV File for Products & Metafields

This CSV file will contain both your standard product data and the custom metafield values you want to import. Taking a little extra care here helps avoid failed imports and missing metafield data later.

Add Standard Product Columns

Begin by adding the standard product columns that Shopify expects. These form the core of your product data and are required whether or not you’re importing metafields.

Typical product columns include:

If you’re unsure about the correct structure, a good starting point is exporting a sample product from Shopify or using a sample CSV provided by your import tool.

Add Metafield Columns 

Once the basic product columns are in place, you can add columns for your custom metafields.

For product metafields, Shopify expects the column headers to follow this exact format: Meta namespace.key (data_type)

This format must match:

• The namespace and key you created in Shopify
• The data type defined in the metafield definition

Here are a few examples:

CSV Header	Sample Value
Meta custom.material (single_line_text)	Cotton
Meta specs.weight (number)	1.5
Meta custom.is_fragile (boolean)	true
Meta custom.warranty_period (single_line_text)	12 months

Each value in the CSV must match the specified data type exactly.

Once your CSV file is ready with both product data and correctly formatted metafield columns, you can move on to importing it into Shopify using StoreRobo.

• In the StoreRobo app, go to the Import section. 
• Upload your prepared CSV file.
• Select Products as the data type to import.
• Click Upload. 

Before starting the import, StoreRobo lets you configure how products should be handled. These options are especially useful when you’re updating existing products or migrating data.

Some common settings you may choose include:

• Ignore product IDs – Useful when importing products into a new store to avoid conflicts with existing IDs.
  
• Update existing products – Allows StoreRobo to match products (usually by handle or SKU) and update their details and metafields.
  
• Skip importing new products – Helpful if you only want to update existing products without adding new ones.
  
• Publish newly added products – Automatically sets imported products to active instead of draft.

Choose the options that best match your import goal, whether it’s a fresh migration or a bulk update.

Once everything is configured, click Upload to start the import process. StoreRobo will process the CSV and import products along with their metafield values.

After the import finishes, you’ll see a completion message in the dashboard. StoreRobo also sends an email notification confirming that the import has been completed, which helps track large or background imports.

At this point, your products and their custom metafields should be successfully added or updated in Shopify. The final step is to verify the imported data in your Shopify admin to make sure everything appears as expected.

After the import is complete, it’s important to verify that the metafields were added correctly. This quick check helps ensure your custom product data is stored properly and ready to be used by themes, apps, or storefront displays.

To review the imported metafields:

1. Go to Products in your Shopify admin
2. Open any product that was included in the import
3. Scroll down to the Metafields section on the product page

Here, you should see the custom metafields you defined earlier, now populated with values from your CSV file.

Importing products with custom metafields into Shopify may seem complex at first, but once you understand the workflow, it becomes a smooth and repeatable process. The key is following the right sequence: define your metafields in Shopify, format your CSV file correctly, import the data using StoreRobo, and verify the results in the Shopify admin.

Getting these steps right ensures your custom product data is stored accurately and works seamlessly with your themes and apps.

Now that you’re comfortable working with metafields, you can start using the same approach to handle more advanced product data tasks.

These guides build on what you’ve learned here and help you manage your Shopify product catalog more efficiently as your store grows.