Which CSV Columns Are Required for the Bidders Import vs the Registrations Import?
Learn which CSV columns the BidWrangler Bidders Import and Registrations Import require, what each import does, and how the column mapping step works.
The Bidders Import requires First Name, Last Name, and Email Address. The Registrations Import requires First Name, Last Name, Email Address, and a Paddle Number. Every other column, phone and address fields included, is optional.
What Each Import Does, and Which One to Pick
The two imports do different work, so pick the one that matches your goal.
The Bidders Import creates new user accounts or updates existing bidder information in bulk. It can assign a permanent bidder number to an account. It does not register anyone for an auction.
The Registrations Import creates accounts where needed and registers each bidder for the auction you select. Each imported bidder is approved for that auction automatically. This import does not assign permanent bidder numbers. If you want to register and approve a full list of bidders for one sale, use the Registrations Import.
Required Columns for the Bidders Import
The Bidders Import needs three columns on every row:
First Name
Last Name
Email Address
The email address is the unique identifier on a BidWrangler account. A re-import with the same email address updates the existing account and does not create a second user.
How to Run the Bidders Import
Open the BidWrangler admin portal.
Click on Bidder Import.
Click on Create.
Upload your .csv file
Map your columns to the BidWrangler fields.
Click on Save.
Monitor the progress of the import on the import screen.
Required Columns for the Registrations Import
The Registrations Import needs these columns on every row:
First Name
Last Name
Email Address
Paddle number
he paddle number you supply maps to the Online paddle number or the Live paddle number for that auction.
Two constraints apply to the paddle numbers in your file:
Each paddle number must be greater than or equal to the auction's Online Starting Paddle Number. The default value is 10,000.
If the sale runs across multiple platforms with an external paddle range configured, the number must fall inside that range.
How to Run the Registrations Import
Open the BidWrangler admin portal.
Click on Registrations Import.
Click on Create.
Select an Auction from the drop-down.
Select a Buyer's Premium from the drop-down.
Map your columns to the BidWrangler fields.
Click on Save.
Monitor the progress of the import on the import screen.
Important Notes
Address fields
With both imports there are 5 address fields available, labeled as Location Street, Location City, Location State, Location Zip, and Location Country.
If you include any one of these fields in your import, you must include all five
The Location State and Location Country fields must use a two-letter abbreviation, eg: PA for Pennsylvania, VA for Virginia, AB for Alberta, US for United States, CA for Canada, etc.
Your Headers Do Not Have to Match Ours: The Mapping Step
Both imports include a mapping step. On the mapping screen, you line your columns up with the BidWrangler fields. Your headers can stay exactly as your system already writes them. You do not need to match a template byte for byte.
Why a Row Fails to Import
A row fails when the paddle number in the file is already in use by a different user. A row also fails when the bidder is already registered for the selected auction.
If a bidder already carries a permanent bidder number on their account, the file must use that exact number. A different number on that row causes an error.
If you've only mapped one 'location' column, or have not used the two-letter abbreviation for state or country, the address will not be mapped.
FAQ
Does the Registrations Import approve bidders automatically? | Yes. There is no approval status column on this import, and none is needed. Each bidder in the file is registered and approved for the auction you select. |
What happens if I import the same file twice? | A re-import updates rather than duplicates. The email address is the unique identifier on a BidWrangler account, so the same address cannot produce a second user. |
Do my CSV headers have to match the BidWrangler template exactly? | No. Both imports include a mapping step where you line your columns up with the BidWrangler fields. Your headers can stay as your system writes them. |
Which import assigns permanent bidder numbers? | Only the Bidders Import can assign a permanent bidder number. The Registrations Import assigns paddle numbers for one auction only. The Bidder Number field on the user record is meant for the small group of regulars who keep the same number across every sale. |
Why did my paddle numbers get rejected? | Each paddle number must be greater than or equal to the auction's Online Starting Paddle Number, which is 10,000 by default. A number that is already in use by a different user also causes the row to fail. |
Can I use the Bidders Import to register bidders for my auction? | No. The Bidders Import creates or updates user accounts only. To register bidders for a specific auction, use the Registrations Import. |
Related Articles
Questions about your import file? Reach out to helpdesk@bidwrangler.com and we are happy to help.
