BigCommerce data reference

A per-tab list of every column SyncRange can export from BigCommerce, with a short description of what each one contains. Use this page when picking columns in the export builder, or when you need to know exactly what a value represents in BigQuery or Google Sheets.

Each tab below notes whether it uses the export date range or always exports a full current snapshot (date range does not apply).

For configuration steps see Configuring BigCommerce exports.

Orders

One row per order. Date range: filtered by order date_created. Includes totals, payment fields, and flattened billing address columns.

ColumnDescription
Order IDRecord ID from BigCommerce.
Customer IDBigCommerce customer ID (blank for guest orders when applicable).
Date CreatedWhen the record was created.
Date ModifiedWhen the record was last modified.
Date ShippedWhen the order was shipped (if shipped).
Status IDNumeric order status ID.
StatusOrder or record status as reported by the platform.
Custom StatusCustom status label when configured.
Subtotal Ex TaxOrder subtotal excluding tax.
Subtotal Inc TaxOrder subtotal including tax.
Subtotal TaxTax portion of the subtotal.
Base Shipping CostBase Shipping Cost in the row currency unless noted otherwise.
Shipping Cost Ex TaxShipping Cost Ex Tax: amount excluding tax.
Shipping Cost Inc TaxShipping Cost Inc Tax: amount including tax.
Shipping Cost TaxShipping Cost Tax.
Base Handling CostBase Handling Cost in the row currency unless noted otherwise.
Handling Cost Ex TaxHandling Cost Ex Tax: amount excluding tax.
Handling Cost Inc TaxHandling Cost Inc Tax: amount including tax.
Handling Cost TaxHandling Cost Tax.
Base Wrapping CostBase Wrapping Cost in the row currency unless noted otherwise.
Wrapping Cost Ex TaxWrapping Cost Ex Tax: amount excluding tax.
Wrapping Cost Inc TaxWrapping Cost Inc Tax: amount including tax.
Wrapping Cost TaxWrapping Cost Tax.
Total Ex TaxOrder or line total excluding tax.
Total Inc TaxOrder or line total including tax.
Total TaxTotal tax amount.
Items TotalTotal number of items on the order or address.
Items ShippedNumber of items shipped.
Payment MethodHow the order was paid.
Payment Provider IDPayment provider identifier.
Payment StatusPayment status for the order.
Refunded AmountCumulative amount refunded on the order.
Order Is DigitalWhether the order is digital-only.
Store Credit AmountStore credit applied to the order.
Gift Certificate AmountGift certificate amount applied.
IP AddressBuyer IP address captured at checkout.
GeoIP CountryCountry inferred from IP.
GeoIP Country ISO2ISO2 country code inferred from IP.
Currency IDBigCommerce currency ID for the order.
Currency CodeISO 4217 currency code (e.g. USD).
Currency Exchange RateExchange rate used for the order currency.
Default Currency IDDefault Currency ID (ISO 4217 when applicable).
Default Currency CodeStore default currency code.
Store Default Currency CodeStore Default Currency Code (ISO 4217 when applicable).
Store Default Exchange RateStore Default Exchange Rate in the row currency unless noted otherwise.
Staff NotesInternal staff notes on the order.
Customer MessageMessage from the customer on the order.
Discount AmountDiscount amount on the order.
Coupon DiscountCoupon discount amount on the order.
Shipping Address CountShipping address count.
Is DeletedWhether the order is soft-deleted in BigCommerce.
eBay Order IDeBay Order ID from the source platform.
Cart IDCart ID from the source platform.
Channel IDSales channel ID for the order or assignment.
External SourceExternal Source.
External IDExternal ID from the source platform.
External Merchant IDExternal Merchant ID from the source platform.
Tax Provider IDTax Provider ID from the source platform.
Customer LocaleCustomer Locale.
Order SourceSource of the order (e.g. www, manual).
ConsignmentsConsignment payload when returned by the API.
CouponsJSON or serialized coupon data attached to the order.
Products Resource URIResource URI for order products (use Order Line Items tab for row data).
Shipping Addresses Resource URIResource URI for shipping addresses (use Order Shipping Addresses tab for row data).
Billing Address First NameBilling address first name.
Billing Address Last NameBilling address last name.
Billing Address CompanyBilling address company.
Billing Address Street 1Billing address street 1.
Billing Address Street 2Billing address street 2.
Billing Address CityBilling address city.
Billing Address StateBilling address state.
Billing Address ZipBilling address zip.
Billing Address CountryBilling address country.
Billing Address Country Iso2Billing address country iso2.
Billing Address PhoneBilling address phone.
Billing Address EmailBilling address email.
Billing Address Form FieldsBilling address form fields.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Order Line Items

One row per order line item. Date range: parent orders filtered by date_created.

ColumnDescription
Order IDParent order ID.
Line Item IDRecord ID from BigCommerce.
Product IDCatalog product ID.
Variant IDCatalog variant ID.
Order Address IDOrder Address ID from the source platform.
NameBuyer or entity display name.
Customer NameCustomer Name.
Merchant NameMerchant Name.
SKUSKU for the product, variant, or line.
UPCUPC barcode.
TypeProduct or coupon type.
Base PriceBase unit price before adjustments.
Price Ex TaxUnit price excluding tax.
Price Inc TaxUnit price including tax.
Price TaxTax on the unit price.
Base TotalBase line total before adjustments.
Total Ex TaxOrder or line total excluding tax.
Total Inc TaxOrder or line total including tax.
Total TaxTotal tax amount.
WeightWeight.
WidthWidth.
HeightHeight.
DepthDepth.
QuantityAvailable or ordered quantity.
Base Cost PriceBase Cost Price in the row currency unless noted otherwise.
Cost Price Inc TaxCost Price Inc Tax: amount including tax.
Cost Price Ex TaxCost Price Ex Tax: amount excluding tax.
Cost Price TaxCost Price Tax.
Is RefundedWhether the line item has been refunded.
Quantity RefundedUnits refunded on the line.
Refund AmountRefund amount for the line.
Return IDReturn ID from the source platform.
Wrapping IDWrapping ID from the source platform.
Wrapping NameWrapping Name.
Base Wrapping CostBase Wrapping Cost in the row currency unless noted otherwise.
Wrapping Cost Ex TaxWrapping Cost Ex Tax: amount excluding tax.
Wrapping Cost Inc TaxWrapping Cost Inc Tax: amount including tax.
Wrapping Cost TaxWrapping Cost Tax.
Wrapping MessageWrapping Message.
Quantity ShippedQuantity Shipped.
Event NameEvent Name.
Event DateEvent Date.
Fixed Shipping CostFixed Shipping Cost in the row currency unless noted otherwise.
eBay Item IDeBay Item ID from the source platform.
eBay Transaction IDeBay Transaction ID from the source platform.
Option Set IDOption Set ID from the source platform.
Parent Order Product IDParent Order Product ID from the source platform.
Is Bundled ProductBoolean: Is Bundled Product.
Bin Picking NumberBin Picking Number.
External IDExternal ID from the source platform.
Fulfillment SourceFulfillment Source.
BrandBrand.
Applied DiscountsJSON of discounts applied to the line.
Product OptionsJSON of selected product options.
Configurable FieldsConfigurable Fields.
Gift Certificate IDGift Certificate ID from the source platform.
Order Date CreatedCreated date of the parent order (for joining / filtering).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Order Shipping Addresses

One row per shipping address on orders in the selected date range.

ColumnDescription
Order IDParent order ID.
Shipping Address IDRecord ID from BigCommerce.
Items TotalTotal number of items on the order or address.
Items ShippedNumber of items shipped.
Shipping MethodShipping method name.
Base CostBase Cost in the row currency unless noted otherwise.
Cost Ex TaxCost Ex Tax: amount excluding tax.
Cost Inc TaxCost Inc Tax: amount including tax.
Cost TaxCost Tax.
Base Handling CostBase Handling Cost in the row currency unless noted otherwise.
Handling Cost Ex TaxHandling Cost Ex Tax: amount excluding tax.
Handling Cost Inc TaxHandling Cost Inc Tax: amount including tax.
Handling Cost TaxHandling Cost Tax.
Shipping Zone IDShipping Zone ID from the source platform.
Shipping Zone NameShipping Zone Name.
Cost Tax Class IDCost Tax Class ID from the source platform.
Handling Cost Tax Class IDHandling Cost Tax Class ID from the source platform.
Shipping QuotesShipping Quotes.
First NameFirst name.
Last NameLast name.
CompanyCompany name.
Street 1Street 1.
Street 2Street 2.
CityShip-to city.
StateShip-to state or region.
ZipShip-to postal code.
CountryCountry.
Country Iso2Country Iso2.
PhonePhone number.
EmailCustomer email address.
Form FieldsForm Fields.
Order Date CreatedCreated date of the parent order (for joining / filtering).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Order Shipments

One row per shipment (with tracking) for orders in the selected date range.

ColumnDescription
Order IDParent order ID.
Shipment IDRecord ID from BigCommerce.
Customer IDBigCommerce customer ID (blank for guest orders when applicable).
Order Address IDOrder Address ID from the source platform.
Date CreatedWhen the record was created.
Tracking NumberShipment tracking number.
Merchant Shipping CostMerchant Shipping Cost in the row currency unless noted otherwise.
Shipping MethodShipping method name.
Shipping ProviderShipping provider code or name.
Shipping Provider Display NameShipping Provider Display Name.
Tracking CarrierCarrier used for tracking.
Tracking LinkTracking URL when provided.
Generated Tracking LinkGenerated Tracking Link in the row currency unless noted otherwise.
CommentsComments.
ItemsItems.
Order Date CreatedCreated date of the parent order (for joining / filtering).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).
Shipping Address First NameShipping address first name.
Billing Address First NameBilling address first name.
Shipping Address Last NameShipping address last name.
Billing Address Last NameBilling address last name.
Shipping Address CompanyShipping address company.
Billing Address CompanyBilling address company.
Shipping Address Street 1Shipping address street 1.
Billing Address Street 1Billing address street 1.
Shipping Address Street 2Shipping address street 2.
Billing Address Street 2Billing address street 2.
Shipping Address CityShipping address city.
Billing Address CityBilling address city.
Shipping Address StateShipping address state.
Billing Address StateBilling address state.
Shipping Address ZipShipping address zip.
Billing Address ZipBilling address zip.
Shipping Address CountryShipping address country.
Billing Address CountryBilling address country.
Shipping Address Country Iso2Shipping address country iso2.
Billing Address Country Iso2Billing address country iso2.
Shipping Address PhoneShipping address phone.
Billing Address PhoneBilling address phone.
Shipping Address EmailShipping address email.
Billing Address EmailBilling address email.
Shipping Address Form FieldsShipping address form fields.
Billing Address Form FieldsBilling address form fields.

Order Transactions

One row per payment transaction or refund for orders in the selected date range.

ColumnDescription
Order IDParent order ID.
Transaction IDRecord ID from BigCommerce.
EventPayment transaction event type (purchase, refund, etc.).
MethodPayment method on the transaction.
AmountCoupon amount or gift certificate face value / monetary amount.
CurrencyCurrency code for monetary fields on the row.
GatewayPayment gateway.
Gateway Transaction IDGateway's transaction ID.
Date CreatedWhen the record was created.
TestTest.
StatusOrder or record status as reported by the platform.
Fraud ReviewFraud Review.
Reference Transaction IDReference Transaction ID from the source platform.
Payment Method IDPayment Method ID from the source platform.
AVS ResultAVS Result.
CVV ResultCVV Result.
Credit CardCredit Card.
Gift CertificateGift Certificate.
Store CreditStore Credit.
CustomCustom.
Payment Instrument TokenPayment Instrument Token.
OfflineOffline.
Order Date CreatedCreated date of the parent order (for joining / filtering).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Customers

One row per customer. Full export each run: current customer records; the date range does not apply.

ColumnDescription
Customer IDRecord ID from BigCommerce.
CompanyCompany name.
Customer Group IDCustomer group ID.
EmailCustomer email address.
First NameFirst name.
Last NameLast name.
NotesNotes.
PhonePhone number.
Registration IP AddressRegistration IP Address.
Tax Exempt CategoryTax Exempt Category.
Date CreatedWhen the record was created.
Date ModifiedWhen the record was last modified.
Accepts Review/Abandoned Cart EmailsAccepts Review/Abandoned Cart Emails.
Origin Channel IDOrigin Channel ID from the source platform.
Channel IDsChannel IDs.
Store Credit AmountsStore Credit Amounts in the row currency unless noted otherwise.
AuthenticationAuthentication.
AddressesAddresses.
AttributesAttributes.
Form FieldsForm Fields.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Products

One row per catalog product. Full export each run: current catalog; the date range does not apply.

ColumnDescription
Product IDRecord ID from BigCommerce.
NameBuyer or entity display name.
TypeProduct or coupon type.
SKUSKU for the product, variant, or line.
DescriptionFull description text.
WeightWeight.
WidthWidth.
DepthDepth.
HeightHeight.
PriceUnit or listing price in the row currency.
Cost PriceCost of goods.
Retail PriceRetail / MSRP price.
Sale PriceSale price when set.
MAP PriceMinimum advertised price.
Tax Class IDTax Class ID from the source platform.
Product Tax CodeProduct Tax Code.
Calculated PriceCalculated selling price after rules.
Brand IDBrand ID from the source platform.
Option Set IDOption Set ID from the source platform.
Option Set DisplayOption Set Display.
Inventory LevelCurrent inventory quantity.
Inventory Warning LevelInventory Warning Level.
Inventory TrackingHow inventory is tracked (none, product, variant).
Reviews Rating SumReviews Rating Sum.
Reviews CountReviews Count.
Total SoldTotal Sold in the row currency unless noted otherwise.
Fixed Cost Shipping PriceFixed Cost Shipping Price in the row currency unless noted otherwise.
Is Free ShippingBoolean: Is Free Shipping.
Is VisibleWhether the product or category is visible on the storefront.
Is FeaturedWhether the product is featured.
WarrantyWarranty.
Bin Picking NumberBin Picking Number.
Layout FileLayout File.
UPCUPC barcode.
MPNMPN.
GTINGTIN.
Search KeywordsSearch Keywords.
AvailabilityAvailability.
Availability DescriptionAvailability Description.
Sort OrderSort Order.
ConditionItem condition (e.g. New).
Is Condition ShownBoolean: Is Condition Shown.
Order Quantity MinimumOrder Quantity Minimum.
Order Quantity MaximumOrder Quantity Maximum.
Page TitlePage Title.
Meta KeywordsMeta Keywords.
Meta DescriptionMeta Description.
Date CreatedWhen the record was created.
Date ModifiedWhen the record was last modified.
View CountView Count.
Preorder Release DatePreorder Release Date.
Preorder MessagePreorder Message.
Is Preorder OnlyBoolean: Is Preorder Only.
Is Price HiddenBoolean: Is Price Hidden.
Price Hidden LabelPrice Hidden Label in the row currency unless noted otherwise.
Base Variant IDBase Variant ID from the source platform.
CategoriesCategory IDs or payload for the product.
Related ProductsRelated Products.
Custom URLCustom URL path for the catalog entity.
VariantsVariant payload when included on the product.
ImagesImage payload when included on the product.
Custom FieldsCustom fields payload.
Bulk Pricing RulesBulk Pricing Rules.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Product Variants

One row per product variant. Full export each run: current variants; the date range does not apply.

ColumnDescription
Variant IDRecord ID from BigCommerce.
Product IDCatalog product ID.
SKUSKU for the product, variant, or line.
SKU IDSKU ID from the source platform.
PriceUnit or listing price in the row currency.
Calculated PriceCalculated selling price after rules.
Sale PriceSale price when set.
Retail PriceRetail / MSRP price.
MAP PriceMinimum advertised price.
Cost PriceCost of goods.
WeightWeight.
WidthWidth.
HeightHeight.
DepthDepth.
Is Free ShippingBoolean: Is Free Shipping.
Fixed Cost Shipping PriceFixed Cost Shipping Price in the row currency unless noted otherwise.
Calculated WeightCalculated Weight.
Purchasing DisabledWhether purchasing is disabled for the variant.
Purchasing Disabled MessagePurchasing Disabled Message.
Image URLImage URL.
UPCUPC barcode.
MPNMPN.
GTINGTIN.
Inventory LevelCurrent inventory quantity.
Inventory Warning LevelInventory Warning Level.
Bin Picking NumberBin Picking Number.
Option ValuesJSON of variant option values.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Categories

One row per category. Full export each run: current category tree; the date range does not apply.

ColumnDescription
Category IDRecord ID from BigCommerce.
Parent IDParent category ID (0 for top-level).
NameBuyer or entity display name.
DescriptionFull description text.
Sort OrderSort Order.
Page TitlePage Title.
Meta KeywordsMeta Keywords.
Meta DescriptionMeta Description.
Layout FileLayout File.
Image URLImage URL.
Is VisibleWhether the product or category is visible on the storefront.
Search KeywordsSearch Keywords.
Default Product SortDefault Product Sort.
Custom URLCustom URL path for the catalog entity.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Brands

One row per brand. Full export each run: current brands; the date range does not apply.

ColumnDescription
Brand IDRecord ID from BigCommerce.
NameBuyer or entity display name.
Page TitlePage Title.
Meta KeywordsMeta Keywords.
Meta DescriptionMeta Description.
Search KeywordsSearch Keywords.
Image URLImage URL.
Custom URLCustom URL path for the catalog entity.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Coupons

One row per marketing coupon. Full export each run: current coupons; the date range does not apply.

ColumnDescription
Coupon IDRecord ID from BigCommerce.
NameBuyer or entity display name.
TypeProduct or coupon type.
AmountCoupon amount or gift certificate face value / monetary amount.
Min PurchaseMinimum purchase required for the coupon.
ExpiresCoupon expiry datetime.
EnabledWhether the coupon or location is enabled.
CodeCoupon or location code.
Applies ToWhat the coupon applies to.
Number Of UsesTimes the coupon has been used.
Max UsesMaximum total uses.
Max Uses Per CustomerMaximum uses per customer.
Restricted ToRestricted To.
Shipping MethodsShipping Methods.
Date CreatedWhen the record was created.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Gift Certificates

One row per gift certificate. Full export each run: current gift certificates; the date range does not apply.

ColumnDescription
Gift Certificate IDRecord ID from BigCommerce.
Customer IDBigCommerce customer ID (blank for guest orders when applicable).
Order IDParent order ID.
CodeCoupon or location code.
To NameGift certificate recipient name.
To EmailGift certificate recipient email.
From NameGift certificate purchaser name.
From EmailGift certificate purchaser email.
AmountCoupon amount or gift certificate face value / monetary amount.
BalanceRemaining gift certificate balance.
StatusOrder or record status as reported by the platform.
Currency CodeISO 4217 currency code (e.g. USD).
Purchase DateWhen the gift certificate was purchased.
Expiry DateGift certificate expiry date.
TemplateTemplate.
MessageMessage.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Inventory Locations

One row per inventory location. Full export each run: current locations; the date range does not apply.

ColumnDescription
Location IDRecord ID from BigCommerce.
CodeCoupon or location code.
LabelLabel.
DescriptionFull description text.
Type IDType ID from the source platform.
EnabledWhether the coupon or location is enabled.
Managed By External SourceManaged By External Source.
Time ZoneTime Zone.
AddressAddress.
Storefront VisibilityStorefront Visibility.
Special HoursSpecial Hours.
Operating HoursOperating Hours.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Inventory Levels

One row per product/variant inventory level at a location. Full export each run: current levels; the date range does not apply.

ColumnDescription
Product IDCatalog product ID.
Variant IDCatalog variant ID.
SKUSKU for the product, variant, or line.
Location IDInventory location ID.
Location CodeInventory location code.
Available To SellUnits available to sell at the location.
Total Inventory On HandTotal on-hand inventory at the location.
Warning LevelWarning Level.
Safety StockSafety Stock.
Is In StockBoolean: Is In Stock.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Channels

One row per sales channel. Full export each run: current channels; the date range does not apply.

ColumnDescription
Channel IDRecord ID from BigCommerce.
NameBuyer or entity display name.
PlatformChannel platform (e.g. bigcommerce, amazon).
TypeProduct or coupon type.
Date CreatedWhen the record was created.
Date ModifiedWhen the record was last modified.
External IDExternal ID from the source platform.
Icon URLIcon URL.
Is Listable From UIBoolean: Is Listable From UI.
Is VisibleWhether the product or category is visible on the storefront.
StatusOrder or record status as reported by the platform.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Product Channel Assignments

One row per product-to-channel assignment for multi-storefront catalogs. Full export each run: current assignments; the date range does not apply.

ColumnDescription
Product IDCatalog product ID.
Channel IDSales channel ID for the order or assignment.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Related documentation

Something missing on this page? Email [email protected]

Start syncing your ecommerce data in minutes Start free today. No credit card required.