Menu
Welcome to PeerMetals
Shop
HomeMarketplaceSpot DealsAuctionsSocial FeedCalculators & Tools
My Activity
Cart
My Account
Become a Seller
Support
Help CenterContact

Copyright © PeerMetals 2026

PeerMetals Help Center

Back to Help Center

Table of Contents

No headings found

Bulk Importing Listings (Beta)

Have a lot of inventory to list? PeerMetals has two ways to create many listings at once: the CSV/Excel Importer for spreadsheets, and URL Bulk Import for listings you already have on other websites.

Both tools are in Beta. They're still being tested and may not always work as intended. Always review your listings after an import, and let us know if something looks wrong.


At a Glance

  • CSV/Excel Importer: on the Experiments page. Download the template, fill in one row per listing, upload, review, and import.

  • URL Bulk Import: paste links to your listings on other sites, and PeerMetals fills in the details for you.

  • Import as Draft or Inactive first, then check each listing before you publish it.

  • Careful with titles: in the CSV importer, a row with the same title as one of your existing listings replaces that listing.


1. CSV/Excel Importer

  1. Open the Experiments page in your Seller Hub and choose CSV/Excel Importer.

  2. Click Download Template to get a CSV file with every column and a sample row.

  3. Fill in one row per listing. Save as CSV (choose CSV UTF-8 in Excel) or as an Excel file (.xlsx or .xls).

  4. Under Upload File, drag in your file or click to browse. You can upload one file at a time.

  5. Read any Validation Warnings and fix them. Warnings don't stop the import, so fix them first.

  6. Under Import Settings, choose the status after import. It's set to active (live) by default. Choose inactive or draft if you want to check listings before buyers see them.

  7. In the Data Preview, click any cell to edit it, use Add Images to upload photos for a row, and remove rows you don't want.

  8. Select the rows and click Import Selected.

Required columns:

  • title (up to 50 characters), description (up to 2,000 characters), and quantity

  • weight and purity. Set weight_unit to oz (the default), g, kg, or lb.

  • tier1_category (the metal: Gold, Silver, Platinum, Palladium, Copper, Base Metal, Currency, or Accessories & Supplies) and tier2_category (Bullion, Numismatic, Exonumia, Scrap, Jewelry, or Paper Currency)

  • shipping_profile_id: the ID of one of your shipping profiles. The importer page lists your profiles and their IDs, and you can also pick a profile in the preview.

  • price, unless the listing uses spot pricing

Optional columns include year, mintage, face value, country, mint or brand, grade, tags (up to 10), offers and auto-accept/decline prices, and image URLs.

  • Spot-price listings: set useSpotPrice to true and fill in the spot price offset, the offset type (percentage or fixed), and the direction (above or below).

  • Auctions: set is_auction to true and fill in starting_bid and end_date. Reserve price is optional.

  • Yes/no columns accept true/false or 1/0.

Photos: upload images for each row with Add Images (image files up to 5 MB each), or list image links in the image_urls column, separated by commas. Uploading is more reliable: linked images stay on the other website and break if they're removed there. Rows without any images get a placeholder image, so add real photos before you publish.

Updating existing listings: if a row's title matches one of your current listings, the preview marks it Will Update, and importing it overwrites that listing with the row's details. Change the title if you meant to create a new listing.


2. URL Bulk Import

  1. Go to Create with AI from your Listings page, and click Bulk Import next to Import from URL.

  2. Paste a product link into each Product URL row, then click Import on each row or Import All URLs.

  3. Click each imported listing to review and correct the details, and choose a Shipping Profile for each one.

  4. Click Save as Draft to keep them unpublished, or Publish All to put them live.

  • Where links can come from: PeerMetals listings, eBay item pages, and other online stores. Listings from other stores are read by AI, so check the title, weight, metal, price, and photos carefully.

  • Daily limit: the shared AI allows up to 50 imports a day. Under AI API Settings, you can add your own free Gemini API key for unlimited imports. The key is stored only in your browser.

  • Required before publishing: a title, description, price, weight, metal, category, at least one photo, and a shipping profile.

  • Standard listings only: URL imports can't create auctions, spot-price listings, or listings with offers. Edit the listing afterwards to add those.


3. Tips

  • Start small. Import a few listings first to see how they come across.

  • Set up Shipping Profiles before you import. Every listing needs one.

  • Import as Draft or Inactive, check each listing on your Listings page, then publish.

  • Use real photos of the items you're selling. See Listing Optimization Tips.

  • Changing many existing listings? Use Bulk Tools → Bulk Listing Changes on your Listings page instead.

  • Selling on eBay too? See Syncing Listings from eBay (Beta).


Need Help?

If you have questions about importing listings or something isn't working, start a live chat or visit our Contact Us page. Our support team is here to help!


eBay, Gemini, and other product and company names are trademarks of their respective owners. PeerMetals is not affiliated with, sponsored by, or endorsed by them.

Was this article helpful?

Bulk Importing Listings (Beta) | PeerMetals Help Center