Where to find it
Open your seller dashboard and choose Bulk Tools. Pick one of three jobs: Add new listings, Edit existing listings or Update credentials.
Before you start
- One game and category per file. Each category has its own columns and attribute options, so you pick both first.
- Excel or CSV. The Excel file has dropdowns for delivery methods, attributes, units and Yes/No, plus a Valid Values sheet. The CSV comes in a zip with a valid-values file. Use Excel unless you need CSV.
- Required columns end with *. Columns are matched by name, so you can reorder them or delete optional ones.
- Decimals use a dot: 12.5, not 12,5.
- Lists use a pipe: put several images, tags or attribute values in one cell, separated by |. For example: rare | fast.
- Limits: up to 2,000 rows and 5 MB per file. Split bigger batches into several files.
Add new listings
Add gift cards one at a time with the sell form. Bulk Tools can’t add new gift card listings yet.
- Choose the game and category.
- Select Download Excel template or Download CSV template. It has one example row; replace it or delete it.
- For accounts, items and keys, drop your images into the media tray. Then write each image’s file name in the images column, for example hero.png. You can also paste a full image URL.
- Upload your file and select Validate. Each row is marked ok, warning or error, with the problem written next to it.
- To fix errors, select Download fix file, correct the rows and upload it again.
- Select Publish. Valid rows become listings; rows with errors are skipped.
- For instant-delivery accounts and keys, select Attach credentials and upload the credentials file (see below).
Large batches finish in the background, so you can leave the page. You get a notification when the batch is done.
Edit existing listings
- Choose the game and category.
- Select Export Excel or Export CSV. The file is filled in with your current listings.
- Change what you need: price, stock, title, description, attributes, delivery times, tags or images.
- Upload the file. If you reference new image files by name, drop them in the tray too.
- Select Review changes. Each row shows what will change, from the old value to the new one.
- Select Apply changes.
Rules for editing
- Don’t change product_id. It’s how each row is matched to your listing.
- Only changed rows are applied. Rows you leave as they are aren’t touched.
- Deleting a row never deletes a listing. The listing just stays as it is.
- The game and category can’t be changed here.
- A blank cell clears that field for discount, tags and images. A blank delivery time or delivery method keeps the saved one.
- Descriptions are exported as plain text. An unchanged description keeps its original formatting. An edited one is saved as plain paragraphs, without bold, italics or lists.
What the export includes
- Items, currency and top-ups: all your listings, including paused and out-of-stock ones, so you can restock them.
- Accounts and keys: only listings that are still for sale. Sold and empty ones are left out.
- Keys and gift cards: there’s no quantity column. Stock is the number of codes in the listing’s pool, so it changes only when you add codes or sell them.
- Accounts: the quantity column is for manual-delivery accounts. For instant-delivery accounts it’s left blank and ignored, because their stock is the number of accounts in the listing.
Applying a changed row counts as confirming your stock. It restarts the listing’s 30-day stock clock and turns a paused listing back on if it has stock. Listings paused by our team or for an unanswered Linked email question stay paused. See Keeping listings active.
Update credentials and codes
This job is only for instant-delivery accounts, keys and gift cards. Login details and codes never go in the listing file.
- Choose Update credentials, then the game and category.
- Select Export Excel or Export CSV. The file lists each listing’s product_id and title, with empty credential columns. Your current login details are never exported.
- Fill in the new values:
- Accounts: one account per row, in the columns login and password (required), email_url, email_login, email_password, 2fa_login, 2fa_password and additional_info. Repeat the product_id on more rows to add several accounts to one listing. They’re added to the listing, and stock goes up by the number of new accounts. An account already in the listing is skipped. Files with the older credentials and notes columns still work.
- Keys and gift cards: codes in license_key. Separate several codes with |. They’re added to the listing’s pool, and stock goes up by the number of codes.
- Upload the file, select Review, then Apply credentials.
Credentials are encrypted when they’re saved, and the uploaded file is deleted right after it’s processed.
After Add, the credentials file matches rows by the sku you used in your listing file; repeat the sku on more rows to put several accounts in one listing. In Update credentials, rows are matched by product_id.
Filling in the columns
Your file’s Valid Values reference lists every column for your category. The common ones:
| Column | What to enter |
|---|---|
| sku | Add only. Your own unique label for the row, such as ROW-001. |
| product_id | Edit only. Leave it as exported. |
| title, description | The listing title and description. Currency and top-up titles are created for you. |
| price | Price in USD. |
| quantity | Stock, for items, currency, top-ups and manual-delivery accounts (1 if left blank). Ignored for instant-delivery accounts. |
| discount | A whole-number percentage from 0 to 100. |
| currency_amount and unit | Currency only. For example, 5 and M for 5 million. Units: Unit, K, M, B, T, Q. |
| selected_amount | Top-ups only. Pick the amount from the dropdown. |
| minimum_offer_quantity | Items and currency. The smallest amount a buyer can order. |
| delivery_method | Pick from the dropdown. For accounts, keys and gift cards, the automatic method means instant delivery. |
| delivery_time_online, delivery_time_offline | Your guaranteed delivery time when you’re online and offline. The online time is required, except for instant-delivery listings. |
| images | File names from the tray or image URLs, separated by |. Not used for currency and top-ups. |
| tags | Tags separated by |. |
| Attribute columns | One column per attribute, named as on the sell form. Pick from the dropdown; yes/no attributes take Yes or No. |
| volume_discount_tiers | Quantity discounts, such as Qty:5,Pct:1;Qty:10,Pct:2 for 1% off 5 or more and 2% off 10 or more. |
Images
- From the tray: drop the file in the tray and write its file name in the images cell.
- From a URL: paste a full https:// link. We copy the image to PlayerBay, so your listing doesn’t depend on another site.
- Existing images (Edit): leave the exported links to keep them, or remove a link to take that image off.
A file name that isn’t in the tray, or a link we can’t download, is skipped with a warning. The row still goes through.
Troubleshooting
| Problem | Fix |
|---|---|
| A row doesn’t match a listing | Its product_id was changed, or the listing is in another category. Export again and edit the new file. |
| A CSV row split into the wrong columns | A value contains a comma. Use Excel, or type 270000 instead of 270,000. |
| A delivery method or attribute is refused | The value isn’t in the allowed list. Use the dropdown or check Valid Values. |
| A yes/no attribute fails in Google Sheets | Type the words Yes or No, not TRUE or FALSE. |
| An instant-delivery account is still a Draft | Attach its login details with Attach credentials or Update credentials. |
| The file is too large | Split it into files of up to 2,000 rows and 5 MB. |