Docs — Folder Lister

First-Time Setup — Folder Lister

This guide walks you through your very first Folder Lister setup: installing the app, signing in with eBay, entering your license key, and preparing your folder structure for bulk listing.

1. Get your license from the website

Visit folderlister.com and request a license key. Enter your email address, press Send Code, check your inbox, and validate the code. Copy the resulting license key from the email (Ctrl+C). You'll paste it into the app later.

2. Download and install the application

Download the installer from: https://download.folderlister.com Run the installer and launch the application.

3. Sign in with eBay

On first launch, the app will show the welcome dashboard. Click the Sign in with eBay… button and follow the login process. Complete the OAuth steps until the page closes and the app shows:

• Logged in
• Your selected eBay site (e.g., UK)
• A green status indicator

You should now see the eBay environment (env), site, and connection status ticked as OK.

4. Enter your license key

Open the same menu and select Enter license key… Paste the license key you received via email (Ctrl+V) and confirm.

If the license is valid, the app will display your expiry date (example: 2099-12-31). After your first upload session, the license becomes tied to your eBay account and can only be switched once every 3 weeks.

5. Understanding the dashboard

Once logged in and licensed, the main screen shows:

• Your current eBay site (important: for most users, set this to UK to get correct item specifics and business policies)
• Your daily image upload limit, visualized as a battery bar
• The Folder Lister robot reacting as uploads progress

6. Open the menu

Click the small ▲ arrow to open the main menu. If you wanna change any settings For now we'll Press Start to begin your initial setup.

7. Choose your main storage folder

During the first run, Folder Lister will ask you to select your storage root — this is the folder where all your eBay listing folders will live.

A clear folder structure is important: each folder represents one eBay category, and each folder can have its own item specifics, title rules, description template values, and store categories.

8. Example folder structure

C:\eBay listings\
   pins\
       cars
       motors
       sports
   coins\
       ancient
       country\
           Netherlands
           England
   cards\
       europe
       world
       USA
  

9. Category Mapping

After selecting your folders, the app will open the Category Mapping Setup screen:

Here you can:

• Double-click a row to set the correct eBay category
• Use Shift / Ctrl to select multiple folders at once
• Right-click to edit columns or apply settings quickly
• Use the search box to find matching categories (comma-separated keywords improve results)

10. Advanced settings

Click Advanced… to open more options:

• Store category (auto-loaded from your eBay account)
• Description template (replaces the {description} tag)
• Other per-category overrides

11. Start – prepare your first listing run

When your folders and categories are mapped, click Start from the main screen.

Select the folders you want to upload in this batch. Tick the boxes next to the folders, then press Next.

12. Basic listing settings & scheduler

On the Basic tab you choose:

• Listing type (FixedPrice / Auction)
• Duration
• Quantity
• Condition and optional Condition description

The scheduler is especially useful for auctions. With Schedule listing you pick the start date and time; with Time between listings (min) you add a small delay between each listing so hundreds of listings go live in a controlled stream instead of all at once.

13. Policies & VAT

On the Policies tab you set:

• Location (City, State)
• Shipping policy
• Return policy
• Payment policy
• Store category
• VAT % (optional)

Business policies are loaded automatically from your eBay account and remembered for next runs. Your eBay account must be configured for business policies; see eBay’s own help pages for instructions.

14. Create your first draft batch

When everything is set, press Go!. Folder Lister uploads your images to eBay (EPS). A progress dialog shows which image is being uploaded.

When the upload finishes, the app opens the Web Editor with your drafts ready for review and bulk editing.

Next steps:

• Configure per-folder values in Item specifics & title codes.
• Fine-tune large batches of drafts with the Bulk Editor.

Item specifics & title codes

Item specifics control structured details such as brand, material, size, and country of origin. Folder Lister lets you set them per folder and automate them using short codes in your titles.

1. Folder-level item specifics

Select a folder in the left tree, then click the item specific you want to edit. At the bottom, choose a Value to lock that specific for the whole folder.

You can still override values later per item in the Web Editor, but folder-level values are a quick way to keep large collections consistent.

2. Edit codes for an item specific

Click Edit codes… to open the code editor for the selected item specific.

In this example, the code UK is linked to the item specific Country of Origin = United Kingdom. You can add as many codes as you like per folder.

3. Using codes in titles

Once a code is defined, you can use it directly in your filenames or titles, for example:

Alexander the Great Coin[UK].jpg
  

During processing, [UK] is picked up as the code and converted into Country of Origin = United Kingdom for that item.

This is ideal when you want to drive everything from titles and avoid extra manual work in the Bulk Editor.

For an overview of all supported codes and advanced tricks, see the upcoming Title codes overview section.

Title codes

Title codes let you add preset text before or after your title and trigger extra automation such as item specifics, prices and quantities.

Open the Title coding window from the main menu. From here you can:

• Code guide — jump to this documentation section.
• Practice — open a live preview per folder to test which codes are active.
• Set codes… — define and edit the actual title codes.

Set codes

In the Title coding — settings window you define your codes. Each code has:

• a short Code (for example S),
• the Text that should be added (for example Silver),
• and whether it is added before or after the title.

In this example the code [S] adds the word Silver to the title.

Example filename:

Alexander the Great Coin[S].jpg
  

During the run this becomes a title like Silver Alexander the Great Coin (depending on your before/after choice). Title codes can be combined with item specifics: the same code [S] can both set the item specific Material = Silver and add the word Silver to the title, producing highly searchable listings with minimal typing.

More advanced codes for prices, BIN, bundles and quantities are covered in the overview below.

Title codes overview

This cheat sheet shows all basic title codes at a glance: item specifics, SEO text, start prices, BIN prices, bundles and quantities.

Click the image to open the full-size version. It explains each code type in plain language, with filename examples for every case.

In short:

• Item specific codes set structured values (for example Country of origin, Material) using tags like [UK].
• Title / SEO text codes add words such as Silver, Rare or Proof without retyping them.
• Start price codes set the starting price numerically from the filename.
• BIN price codes add a Buy It Now price on top of an auction start price.
• Bundle codes link multiple images into a single listing.
• Quantity codes control fixed-price quantity directly from the filename.

Use these patterns together with Item specifics and the Title codes section to drive almost your entire listing from filenames alone.

Bulk Editor

The Web Editor is where your uploaded drafts land. Here you can review images, tweak titles, and edit hundreds of listings at once.

Bulk editing fields

To bulk-edit listings:

1. Tick the checkboxes for the listings you want to change.
2. Use the Bulk dropdown at the top to choose which column you want to edit (for example Start price).
3. Enter or pick the new value.
4. Click Apply to selected.

This works for prices, quantities, item specifics, categories, policies and more.

Publish drafts

When everything looks good, publish your drafts to eBay:

• Publish selected – only the checked listings are sent.
• Publish ALL – the entire batch is sent.

Be mindful of your eBay fee structure and free-listing limits before publishing large batches.

FAQ

Is the app free?

Yes, you can use it for free. Launch memberships may convert to paid later with advance notice.

Who pays eBay fees?

You do. Always check free‑listing limits and local rules before bulk publishing.

How do I report issues?

Email support@folderlister.com with logs/steps to reproduce.

Privacy Policy

Data we process

• Account & licensing: email address, license key, plan/trial status.
• Operational: logs (timestamps, errors), and IP strictly for security, rate-limiting, and abuse prevention.
• eBay integration: tokens/IDs required to act on your behalf with eBay APIs.
• Support: messages you send to support@folderlister.com.

We do not sell your data, profile you for ads, or train models with your content.

Purposes & legal bases (GDPR)

• Provide the service/features you request (contract necessity).
• Security, fraud and abuse prevention (legitimate interests).
• Legal compliance where applicable (legal obligation).
• Optional product feedback (legitimate interests/consent).

Minimization & retention

• We aim to collect/store as little as possible.
• Technical logs retained only as long as needed for reliability and security, then deleted or anonymized.
• You can request deletion of account/identifying data where applicable.

Sharing & processors

We use trusted sub‑processors (e.g., hosting/email) solely to run the service; they may not use your data for their own purposes.

Security

We apply appropriate technical and organizational measures (encryption in transit, least‑privilege access, monitoring). No method is perfect, but protection gets maximum attention.

International transfers

If data crosses borders, we rely on appropriate safeguards (e.g., SCCs) where required.

Your rights

Depending on jurisdiction (EU/UK), you may have rights to access, correct, delete, restrict, port, object, and to complain to a supervisory authority (NL: Autoriteit Persoonsgegevens).

Children

Not directed to children; intended for adult/business users.

Changes

Material changes will be announced in‑app or via email with reasonable notice.

Contact

support@folderlister.com

Terms of Use (EULA)

Responsible use & eBay costs. You are solely responsible for any eBay fees; be mindful of per‑site free‑listing limits before publishing. Misuse may lead to IP blocking or account termination.

1. License Grant

Personal, limited, revocable, non‑exclusive, non‑transferable license to install/use the App on devices you own/control, solely to create/manage eBay listings with your own account(s). The App is licensed, not sold.

2. Ownership

All IP in the App, documentation, designs, and branding belongs to the publisher and its licensors. No copying, redistribution, or reverse‑engineering, except where mandatory law allows.

3. Third‑Party Services (eBay)

Your use of eBay remains subject to their terms/policies. You are responsible for any costs. We are not affiliated with eBay and not liable for third‑party costs, outages, or policy changes.

4. Acceptable Use

No spam/abuse, no bypassing rate limits, no unlawful or infringing content. Any form of spam may result in a permanent ban and/or IP block.

5. Data & Privacy

We minimize data and protect it. See the Privacy Policy.

6. Trials, Launch Memberships, Refunds

• Free trial or free launch membership available for testing.
• No general refund policy. In exceptional cases where the App is insufficiently functional despite support efforts, we may offer a discretionary remedy.
• Launch memberships may later convert to paid plans; we will inform you in advance with clear options before charges apply.

7. Updates & Changes

We may add/change/remove features. Updates may be required to continue use. Terms may change with notice where required.

8. Disclaimers

THE APP IS PROVIDED “AS IS” AND “AS AVAILABLE.” TO THE MAXIMUM EXTENT PERMITTED BY LAW, ALL WARRANTIES ARE DISCLAIMED, INCLUDING MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON‑INFRINGEMENT.

9. Limitation of Liability

TO THE MAXIMUM EXTENT PERMITTED BY LAW, NO LIABILITY FOR INDIRECT, SPECIAL, CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES; TOTAL LIABILITY CAPPED AT AMOUNTS PAID (IF ANY) IN THE PREVIOUS 12 MONTHS. Nothing excludes liability where prohibited by law.

10. Termination

Access may be suspended or terminated for violations or legal reasons. You may stop using/uninstall the App at any time.

11. Export & Compliance

You must comply with applicable laws (export, sanctions, anti‑abuse) and eBay policies.

12. Governing Law

Unless mandatory local law requires otherwise, Dutch law applies; disputes go to the competent courts in the Netherlands.

Copyright Notice

© 2025 Joep Litjens / Folder Lister. All rights reserved.

“Folder Lister” and associated logos/designs are trademarks or trade dress of the owner. eBay and the eBay logo are trademarks of eBay Inc. Folder Lister is not affiliated with or endorsed by eBay.

Open‑Source Acknowledgements

The App may include or reference open‑source components licensed under their respective licenses. Required notices are provided in‑app or on the website. Nothing here limits rights granted by such licenses.

Permitted Use

Except as allowed by mandatory law or applicable open‑source licenses, you may not copy, modify, redistribute, or create derivative works without prior written permission.

Attribution

If you publicly reference Folder Lister (e.g., tutorials/reviews), include a link to folderlister.com and follow fair use/brand guidelines.