Exporting

Generate CSV files to upload your lots to auction platforms like HiBid, Proxibid, and others.

Lead Admin

The Lot Exporter is where you generate CSV files that contain your lot data in the exact format required by your auction platform. ListerLeo includes pre-built templates for popular platforms and lets you create custom templates for any format.

Running an Export

  1. Navigate to Exports in the left sidebar.
  2. Click New Export.
  3. Select the Auction to export (only auctions with status "Ready" or later are shown).
  4. Choose an Export Template (e.g., "HiBid Standard", "Proxibid", or a custom template).
  5. Review the preview showing the first few rows of the CSV output.
  6. Click Generate Export.
  7. Download the CSV file or send it to a configured delivery destination.
Screenshot

Export Templates

Admin

Export templates define the structure and content of your CSV output. Each template specifies which columns to include, what order they appear in, and how ListerLeo data maps to those columns.

Built-in Templates

ListerLeo ships with pre-configured templates for popular platforms:

  • HiBid Standard — Includes lot number, title, description, category, starting bid, reserve, buy now, and image URLs. Compatible with HiBid's CSV import format.
  • HiBid with Shipping — Same as HiBid Standard plus shipping weight and dimensions fields.
  • Proxibid — Formatted for Proxibid's lot import specification.
  • Generic CSV — A basic export with all common fields. Useful as a starting point for custom templates.
Tip:

Built-in templates are read-only but you can duplicate them to create a custom version. Click the duplicate icon next to any built-in template.

Custom Templates

Admin

Create custom export templates when the built-in templates do not match your auction platform's requirements, or when you need a specific format for reporting purposes.

Creating a Custom Template

  1. Navigate to Exports > Templates.
  2. Click Create Template.
  3. Enter a template name (e.g., "Custom HiBid with Notes").
  4. Add columns by clicking Add Column:
    • Set the Column Header — the name that appears in the CSV header row.
    • Set the Data Source — which ListerLeo field populates this column.
    • Optionally set a Default Value for when the data source is empty.
    • Optionally set a Transform — text manipulation like uppercase, truncate, or prefix.
  5. Drag columns to reorder them.
  6. Click Save Template.
Screenshot

Template Fields

Admin

When configuring export template columns, these are the available data source fields you can map to.

Field Description Example Value
lot.numberThe lot number within the auction42
lot.titleThe lot titleSamsung 55" 4K Smart TV
lot.descriptionThe lot descriptionBrand new in box...
lot.categoryThe lot categoryElectronics
lot.starting_bidOpening bid price (resolved via cascade)25.00
lot.reserveReserve price100.00
lot.buy_nowBuy now price250.00
item.upcThe item's UPC/EAN barcode012345678901
item.asinThe item's Amazon ASINB0EXAMPLE1
item.fnskuThe item's Amazon FnSKUX00EXAMPLE
item.brandThe item's brandSamsung
item.msrpManufacturer's suggested retail price599.99
item.conditionThe item's condition codeNew / Open Box
item.weightItem weight42.5
images.primaryURL of the primary item photohttps://...
images.allAll image URLs, pipe-separatedurl1|url2|url3
vendor.nameVendor nameAmazon Returns
Tip:

You can combine multiple fields in a single column using the expression syntax. For example, {{item.brand}} - {{lot.title}} outputs "Samsung - 55\" 4K Smart TV".

Scheduled Exports

Admin

Automate your export workflow by scheduling exports to run at specific times. This is useful for operations that run auctions on a regular cadence.

Setting Up a Schedule

  1. Navigate to Exports > Schedules.
  2. Click Create Schedule.
  3. Select the Template to use for the export.
  4. Set the Frequency: daily, weekly (choose day), or custom cron expression.
  5. Set the Time the export should run.
  6. Choose What to Export: all lots in "Ready" status, lots in a specific auction, or lots matching a filter.
  7. Configure the Delivery method (download, FTP/SFTP, S3, or webhook). See Export Delivery.
  8. Click Save Schedule.
Tip:

Scheduled exports generate a notification when they complete. If a scheduled export fails (e.g., no lots match the filter), you receive an error notification instead.

Export Delivery

Admin

Export files can be delivered through multiple channels.

  • Download — The default. The CSV file is available for download from the exports list. Files are retained for 30 days.
  • FTP / SFTP — Upload the CSV directly to an FTP or SFTP server. Configure the server address, port, username, and password or SSH key. This is the recommended method for automated integrations.
  • S3 — Upload the CSV to an Amazon S3 bucket. Configure the bucket name, region, access key, and secret key.
  • Webhook — Send a POST request to a webhook URL with the export data. Useful for custom integrations.

Configuring FTP Delivery

  1. In the export or schedule settings, select FTP or SFTP as the delivery method.
  2. Enter the server hostname and port.
  3. Enter the username and password (or upload an SSH key for SFTP).
  4. Specify the remote directory path where files should be uploaded.
  5. Click Test Connection to verify the settings.
  6. Save your settings.
Important:

FTP credentials are stored encrypted. However, we strongly recommend SFTP over plain FTP for security. Many auction platforms support SFTP for automated uploads.

Export with Images

Lead Admin

Most auction platforms require item photos alongside the CSV data. ListerLeo handles image delivery in two ways.

Image URL References

The default approach: the CSV includes public URLs pointing to the images hosted by ListerLeo. The auction platform downloads the images from these URLs during import. This is the simplest method and works with HiBid, Proxibid, and most platforms.

Bundled Image Export

For platforms that require images as files rather than URLs, ListerLeo can generate a ZIP bundle containing the CSV and all associated images in a folder.

  1. When creating an export, check the Include Images as Files option.
  2. Choose the image naming convention (lot number, sequential, or original filename).
  3. ListerLeo generates a ZIP file containing the CSV and an "images" folder.
  4. Download or deliver the ZIP file.
Tip:

Image URL exports are much faster to generate than bundled exports. Use URL references unless your auction platform specifically requires image files. Large auctions with thousands of photos can produce multi-gigabyte ZIP files.

Export History

Lead Admin

Every export is logged in the export history. Navigate to Exports to see a chronological list of all exports, including:

  • Export date and time
  • Template used
  • Auction and lot count
  • File size
  • Delivery status (downloaded, uploaded, delivered)
  • User who initiated the export

Click on any export to re-download the file or view the lots that were included. Exports are retained for 30 days, after which the files are deleted but the history record remains.

Export Validation

Lead

Before generating an export, the preview shows sample rows so you can verify the output format and data are correct before proceeding.

Review the preview carefully to ensure titles, prices, and image URLs look correct. If something is wrong, cancel the export, fix the data, and try again.

Important:

Always review the preview before exporting. Uploading a CSV with errors to your auction platform may result in lots being rejected or appearing incorrectly in the listing.