> For the complete documentation index, see [llms.txt](https://docs.auctionplusapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.auctionplusapp.com/auctions/csv-column-reference.md).

# CSV Column Reference

This page provides a reference for the columns used in CSV imports for auction listings. Use this as a guide when creating your CSV file to ensure proper formatting and successful imports.

## Required Columns

Every import must include these columns:

| Column         | Description                | Example         |
| -------------- | -------------------------- | --------------- |
| Product Handle | The Shopify product handle | `vintage-watch` |
| Start Price    | The opening bid amount     | `99.00`         |

## Optional Columns

| Column                        | Description                                          | Example        |
| ----------------------------- | ---------------------------------------------------- | -------------- |
| Reserve Price                 | Hidden minimum sale price                            | `150.00`       |
| Bid Increment                 | Fixed bid increase amount                            | `5.00`         |
| Bid Increment %               | Percentage bid increase                              | `10`           |
| Automatic Bids                | Enable proxy bidding                                 | `true`         |
| Enable Soft Close             | Extend the auction near the end                      | `true`         |
| Soft Close From (seconds)     | Window before end time that can trigger an extension | `120`          |
| Soft Close Duration (seconds) | Time added when soft close triggers                  | `120`          |
| Offer Rule Name               | Existing offer rule name                             | `10% off`      |
| Product Fee Name              | Existing product fee name                            | `Standard Fee` |

## Important Rules

* For fixed or percentage increments, provide either **Bid Increment** or **Bid Increment %**, not both.
* To apply the default [Bid Increment](/auctions/auction-listing-settings.md#bid-increment) tiers, leave both **Bid Increment** and **Bid Increment %** blank.
* Leave optional cells blank if you do not want to set a value.
* Offer rule names and product fee names must match existing records exactly.

## Tip

If you are unsure about formatting, export listings from an existing event and use that file as your template.

## Related Pages

* [CSV Import Guide](/auctions/csv-import-export-guide.md)
* [Auction Events](broken://pages/1QAwJm5tmpOyrrzjN6tX)