Column reference
Column reference: the Bulkvane file format
Last updated
How the file is laid out
- Products: one row per variant. Product-level columns are written on the first row of each product. On import, the first non-empty value in a product's rows is used.
- Customers: one row per customer.
- Collections: the details on the first row; one condition or one product per row.
- Columns you leave out, and empty cells, are left unchanged in Shopify (except in Replace mode).
- Excel (.xlsx) and CSV both work. Excel files can hold one sheet per data type.
Metafield columns
Name a column “Metafield: namespace.key [type]”, for example “Metafield: custom.material [single_line_text_field]”. Shopify's style “Material (product.metafields.custom.material)” works too; the type then comes from your metafield definition. Values are checked per type — booleans, numbers, dates, colors, URLs, JSON — and “a; b; c” becomes a list.
Inventory columns
Name a column “Inventory: <location name>”. It holds each variant's available quantity at that location, as a whole number. Empty cells never change stock.
Customer columns
ID, Email, First Name, Last Name, Phone, Note, Tags, Tax Exempt, Company, Address 1, Address 2, City, Province Code, Country Code, Zip, Address Phone. Read-only: Email Marketing, SMS Marketing, Orders Count, Amount Spent, Created At, Updated At.
Collection columns
ID, Handle, Title, Body HTML, Sort Order, Image Src, SEO Title, SEO Description, Must Match, Rule: Product Column, Rule: Relation, Rule: Condition, Product: ID, Product: Handle. Read-only: Collection Type, Updated At.
All columns
Generated from the same column list the app uses, so it can't drift from the product.
Identity
| Column | Level | On import | Also accepted |
|---|---|---|---|
| ID | product | Identifies the row | Product ID |
| Handle | product | Identifies the row | URL handle |
| Variant ID | variant | Identifies the row | — |
Details
| Column | Level | On import | Also accepted |
|---|---|---|---|
| Title | product | Updated | — |
| Body HTML | product | Updated | Body, Description, Description HTML |
| Vendor | product | Updated | — |
| Type | product | Updated | Product type |
| Tags | product | Updated | — |
| Status | product | Updated | — |
SEO
| Column | Level | On import | Also accepted |
|---|---|---|---|
| SEO Title | product | Updated | — |
| SEO Description | product | Updated | — |
Media
| Column | Level | On import | Also accepted |
|---|---|---|---|
| Image Src | product | Updated | Images, Image URL |
Options
| Column | Level | On import | Also accepted |
|---|---|---|---|
| Option1 Name | product | Updated | — |
| Option1 Value | variant | Updated | — |
| Option2 Name | product | Updated | — |
| Option2 Value | variant | Updated | — |
| Option3 Name | product | Updated | — |
| Option3 Value | variant | Updated | — |
Variant
| Column | Level | On import | Also accepted |
|---|---|---|---|
| Variant SKU | variant | Updated | SKU |
| Variant Barcode | variant | Updated | Barcode |
| Variant Price | variant | Updated | Price |
| Variant Compare At Price | variant | Updated | Compare at price |
Info
| Column | Level | On import | Also accepted |
|---|---|---|---|
| Variant Inventory Qty | variant | Read-only | — |
| Created At | product | Read-only | — |
| Updated At | product | Read-only | — |