Skip to main content
Variable’s data import system lets you quickly populate your workspace with bulk data from spreadsheets, ERP exports, or other sources. The same wizard handles every import type - pick the type that matches your data, upload a file, map your columns, and submit.

What you can import

Import typeDescription
ProductsYour company’s own products with SKUs and attributes
MaterialsMaterial inputs and source products from suppliers - unprocessed, processed, or pre-formed
Bill of materials (BOM)Bill of materials linking products to their inputs, with optional supplier and material breakdowns
SuppliersSupplier companies and contacts
LocationsNamed locations (factories, warehouses, ports) with optional address geocoding
Activity dataPurchase and sales transactions for GHG inventory tracking
Air travelAir travel emissions data (flights, distances, classes)
TransportLogistics and freight emissions data

Supported file formats

Variable accepts the following file formats:
FormatExtension
Comma-separated values.csv
Excel spreadsheet.xlsx
CSV and XLSX work equally well. For multi-sheet XLSX workbooks, you’ll be prompted to pick which sheet to import. See Troubleshooting for tips on merged cells, hidden rows, and formulas.

Import workflow

The import process follows these steps:
1

Upload file

Choose the import type, set the data source system and decimal separator, and upload your CSV or XLSX file. For multi-sheet XLSX workbooks, pick the sheet to import.
2

Parse and detect

Variable parses your file and identifies columns. AI-assisted mapping suggests how your columns map to Variable fields.
3

Map columns

Review and adjust column mappings. The system learns from your previous imports.
4

Map values

Configure how individual values are transformed: units, dates, and enum values.
5

Submit import

Review your data and submit. Variable creates the records and calculates footprints.

Key benefits

Bulk creation

Import thousands of products, materials, or activities in a single operation instead of creating them one by one.

AI-assisted mapping

Variable uses AI to suggest how your column headers map to Variable fields, reducing manual configuration.

Learning from history

The system remembers your previous import mappings. When you import similar files, it automatically applies your past configurations.

Idempotent re-imports

Re-importing the same file produces no duplicate data - products are matched by SKU (or by name when no SKU is given) and inputs are deduplicated automatically.
This applies to products, materials, suppliers, locations, and BOMs. Activity, air travel, and transport imports are not deduplicated - each row becomes a new record every time. See Import behavior by type for the per-type rules.
Re-imports do not update existing items. If a matching SKU is found, Variable leaves the existing product alone - it won’t overwrite the name, supplier, or other fields with the newer values from your file. To change an existing product’s data, edit it directly in the app or via the API.

Automatic calculations

After import, Variable automatically calculates CO2e footprints wherever it can - which means wherever a dataset is assigned to supply the emission factors. Products and materials that don’t yet have a dataset assigned have nothing to calculate; once you assign one, Variable recalculates automatically.

Next steps