Import Data (CSV)

Bulk import listings from a CSV file to quickly populate your marketplace. Perfect for launching with many listings at once.

Overview

The CSV import feature lets you create many listings at once by uploading a spreadsheet file. This is ideal for:

Marketplace launch: Populate your marketplace with hundreds of listings from day one
Provider onboarding: Create listings on behalf of sellers before they join
Content migration: Move listings from another platform via CSV export/import
Batch updates: Prepare listings offline in a spreadsheet and upload them all at once

Before You Start

For best results, set up these things first:

Configure Listing Types in Listing Form settings. Define your types (e.g., "Experiences", "Products"), categories, and custom fields. The import will use these to validate and organize your listings.

Create Managed Sellers in Managed Sellers settings (optional). If you want to assign imported listings to specific sellers, create their accounts first. Otherwise, listings are assigned to you (the store owner).

How to Import

Go to Store Settings → Import Data

Upload your CSV file (or download the sample CSV to get started)

Preview the first rows to verify your data looks correct

Choose a seller to assign all listings to (or keep as "Me / Store Owner")

Choose a default listing type (if you have multiple types configured)

Optionally check "Publish all listings immediately" (otherwise they're created as drafts)

Click "Import" and review the results showing which listings were created or skipped

CSV Format

Your CSV file needs a header row with column names, followed by one row per listing.

Required Columns

Column	Description	Example
`title`	Listing title	Helicopter Tour - 30 Minutes
`description`	Listing description (no character limit)	Experience KC from above...
`price`	Price as a number	199

Optional Columns

Column	Description	Example
`category`	Category name	Experiences
`tags`	Comma-separated tags	helicopter,tour,aerial
`stock`	Inventory count	10
`sku`	SKU identifier	HELI-30
`images`	Comma-separated image URLs (automatically downloaded and stored on our servers)	https://example.com/photo.jpg
`listingType`	Listing type ID, slug, or name	experiences
`compareAtPrice`	Original price (for sale display)	249
`published`	true/false (overrides publish all setting)	false

Custom Fields

If you've added custom fields in your Listing Form settings, you can include them as CSV columns. Use the custom field's internal name (not the display label) as the column header.

Field Type	CSV Value Format	Example
Text / Textarea	Plain text	Downtown Helipad
Number	Numeric value	30
Checkbox	true, false, yes, no, 1, 0	true
Select	One of the defined options	Premium
Multi-select	Semicolon-separated values	WiFi;Parking;Photos
Date / Time	Date or time string	2026-04-15

Multi-select: Use Semicolons, Not Commas

Since commas are the CSV column separator, use semicolons (;) or pipes (|) to separate multiple values within a multi-select field. For example: WiFi;Parking;Pool

Image Handling

When you include image URLs in your CSV, they are automatically downloaded and re-uploaded to our servers during import. This means your listing images are safely stored even if the original source goes offline later.

Supported formats: JPEG, PNG, GIF, WebP, AVIF

Maximum 10 MB per image

Multiple images per listing: separate URLs with commas

Images that fail to download are skipped (listing is still created without them)

Images are deleted automatically if you later delete the store

Example CSV

Here's an example for a local experience marketplace with a custom "duration" field:

title,description,price,category,duration,amenities,published
"Helicopter Tour - 30 Min","See KC from above!",199,Experiences,30,Parking;Photos,false
"Downtown Limo Ride","Luxury limo with champagne",149,Nightlife,120,Champagne;Music,false
"Full Spa Day","Massage, facial & aromatherapy",249,Spa & Wellness,360,Towels;Robes;Parking,false

Seller Assignment

Store Owner (Default)

If no seller is selected, all imported listings belong to you. You can reassign them later.

Managed Seller

Pick a managed seller from the dropdown to assign all imported listings to them. Create sellers first in Managed Sellers.

Typical workflow: Create the listings assigned to yourself first, then reassign to the correct seller once they've been onboarded. Or, if you've already created managed seller accounts, pick them directly during import.

Limits

Limit	Value
Max rows per import	500
Max file size	10 MB
File format	CSV only (.csv)

Tips

Download the sample CSV from the import page to see the exact format
Import as drafts first, review them, then publish
Set up your listing types and custom fields before importing so validation works correctly
For large imports, split into multiple CSV files of 500 rows each
Use semicolons (not commas) to separate multi-select values

Business Plan Feature