Create Metafield/Variant Metafield Definitions in Shopify (Before Import)

Before adding metafields to your import file, make sure you’ve already created their definitions in your Shopify admin. Otherwise, Shopify will treat them as unstructured fields and may not handle them properly.

You can follow Shopify’s official guide here to create definitions.

Adding Metafield/Variant Metafield to Your Import File

If you're using BulkFlow Template:

You must follow the exact column format so the system can detect your metafields automatically.

• Product Metafields:```

metafield:namespace.key

* **Variant Metafields**:

variant_metafield:namespace.key

**If you don't follow this format, BulkFlow will return an error for incorrect field structure.**

### If you're using Other Templates:
You are allowed more flexibility in naming metafield columns (e.g., `custom.material` or just `material`).
However: You **must manually map** these columns in the Field Mapping step, because the system won't auto-detect metafield structures unless they follow the standard `metafield:` or `variant_metafield:` format.

### Notes
* You can include multiple metafields by creating multiple columns with different `namespace.key`.
* Capitalization does not matter (e.g., `Custom.Material` = `custom.material`)
* Parent SKUs should use `metafield`; variations use `variant_metafield`.

Updated on: 09/07/2025