Bulk Importing Metafields is Possible

When migrating a blog from another CMS like WordPress to Shopify, you don’t have to manually enter your unique data (Metafields) one by one. By using Blog Importer, you can bulk-map hundreds of article data points, including images, and import them automatically simply by renaming your CSV headers to a specific format.


”Special Luggage” That Doesn’t Fit in Standard Boxes

Imagine moving to a new house. Most of your belongings fit into standard boxes labeled “clothes” or “dishes.” In Shopify, these are standard fields like “Title,” “Body Content,” and “Tags.”

However, some items, like “custom-made musical instruments” or a “wine collection,” require special handling. In Shopify, these are Metafields. Standard import functions cannot carry these “special items,” leading to the massive task of manually moving (entering) them one by one after the migration.

Cases Where Custom Field Migration is Necessary This is required when you’ve managed data like “subtitles” using ACF (Advanced Custom Fields) in WordPress and want to replicate that data in your Shopify theme. In other words, theme customization is essential to display custom field data.


The Solution: Automatic Mapping with Blog Importer

Blog Importer acts as an “interpreter” between your source data structure and Shopify’s Metafields.

Step 1: Define Metafields in Shopify

Before starting the import, prepare the “boxes” (containers) in Shopify. Navigate to Settings > Custom Data > Articles, define the Namespace and Key, and select the correct Type (e.g., single-line text, file).

Step 2: Prepare Migration Data in CSV (or XML)

If migrating from WordPress, use a free conversion tool to convert XML to CSV. During this process, content from <wp:postmeta> tags (custom fields) is automatically extracted as CSV columns.

Step 3: Apply the Header Format for Mapping

Rename your CSV column headers to the following format: metafield_[Namespace]_[Key]:[Type]

Examples:

  • metafield_custom_author:single_line_text_field
  • metafield_custom_banner:file_reference

Step 4: Run the Import

Upload your created CSV to Blog Importer. The app automatically detects the special headers and flows the data into the specified Metafields. If a file_reference (File) column contains image URLs, the app automatically uploads the images to Shopify’s servers and completes the linking.


Frequently Asked Questions (FAQ)

Can images within Metafields also be migrated?

Yes. While many tools can only handle text data, Blog Importer detects image URLs within the CSV, automatically hosts (uploads) them to Shopify’s CDN, and links the new image IDs to the Metafields.

What data types are supported?

It supports major Shopify data types such as single-line text, files, URLs, and booleans. For exact type names and details when specifying them in CSV, please refer to the following guide.


Summary

By mastering Metafields, Shopify evolves into an even more powerful CMS. Utilize Blog Importer to migrate all your valuable data assets without omission.

Migration Service

A professional service for those who want peace of mind during their migration.