From your products to a checked TikTok Shop listing.
Every step, in the order you will do it, with the buttons named the way the app names them. The first four parts you do once; after that, listing a new product is a few minutes.
Written for ZoraLister 0.1.2 · private beta · WindowsWhat this version does, and what it does not do yet
Working today: your catalog (products, variants, photos), importing a spreadsheet, reading a TikTok Shop bulk upload template, choosing your category, mapping your fields to it once, and a preview that shows exactly what each variant would send and names anything TikTok would reject.
Not in this version yet: approving drafts and writing the filled TikTok upload file. The Queue, Exports and Settings screens are there but empty. That is the next beta build, and this guide will grow with it.
In this guide
Install ZoraLister
- Run ZoraLister-Setup-0.1.2.exe, the file you were sent as a beta tester. It installs for your own Windows account, so there is no administrator prompt.
- Start ZoraLister from the Start menu. It opens in its own window on the Catalog screen.
The beta installer is not code-signed yet, so Windows SmartScreen or your antivirus may ask before running it. That is expected for now. Check that the file came from us, then allow it.
You need Windows 10 or 11. Installing a newer version later upgrades in place and keeps everything you made.
Add a product
- On Catalog, click + Add product.
- Fill in Title (the only required field), then Description, Brand, Price and Quantity. Leave SKU blank and ZoraLister suggests one.
- Enter Weight (g) and Length, Width, Height (mm) as the packed product: what goes in the mail.
- Click Save.
You enter each measurement once, in one unit. Every marketplace then gets it in the unit its template asks for: a US TikTok Shop template wants pounds and inches, and ZoraLister converts for you (20 g becomes 0.04 lb, 150 mm becomes 5.91 in).
Product type / category hint, Tags, Cost, Barcode / GTIN and Notes are for you; fill them if you use them. Archive hides a product without deleting it.
Colors and sizes: variants
Each color, size or style you sell is a variant of the product, with its own SKU, price and quantity. Every product starts with one variant.
- Open the product and scroll to Variants.
- On the first row, fill Option 1 with a name and a value, for example Color and Black. If you also sell sizes, use Option 2: Size and Small.
- Click + Add variant for each other combination (Color White, Size Small, and so on) and give each its own SKU, and a price or quantity if it differs.
Give every variant the same options. A product where one variant has a Color and another has none cannot be listed, and the preview will say so. A product with no colors or sizes at all is fine: leave the options empty on its single variant.
Removing a variant retires it and frees its SKU; nothing is destroyed.
Add photos
- In the product, scroll to Images and drag your photos in, or use choose files.
- The first photo becomes the main image; the rest are gallery. Change a photo's role with the dropdown under it: main, gallery, swatch or size chart.
Your original files are never modified: ZoraLister keeps them untouched and makes resized copies beside them. Removing a photo moves the original to a trash folder inside your data folder instead of deleting it.
Or import your spreadsheet
If your products already live in a spreadsheet, bring them in instead of typing them.
- On Catalog, click Import CSV / Excel and choose your file. CSV and Excel (.xlsx) both work, including exports from Shopify, Etsy, eBay, Excel and Google Sheets. For a workbook, the first sheet is read.
- Match your columns to ZoraLister's: for each CSV column you see a Sample of what is in it and choose the Catalog field it belongs to.
- Click Import.
Rows that share a title become one product with several variants. A row whose SKU you already have updates that variant instead of creating a duplicate, so importing a corrected file is safe.
If no column is mapped to SKU, every row is imported as new, and importing the same file again would create duplicates. ZoraLister warns you before it does that.
Export CSV on the Catalog screen writes your whole catalog back out, any time.
Drop in TikTok's template
ZoraLister ships no marketplace templates of its own. It reads yours, so the rules are always the ones TikTok is enforcing today.
- In TikTok Shop Seller Center, go to where you add products in bulk, pick your product category, and download the bulk upload template. It is an Excel file whose name starts with Tiktoksellercenter_.
- In ZoraLister, open Templates & Profiles and drop the file on the box at the top, or use choose the file. Do not open and re-save it in Excel first; use it exactly as downloaded.
- ZoraLister reads it, including the hidden sheets where TikTok keeps the real rules, and shows a summary: the template version, its units, how many categories are in the file, and the brands your account is approved for.
One template covers a whole top-level category: the Automotive & Motorcycle file, for instance, knows 567 categories. If you sell in two different top-level categories, download and drop in both. ZoraLister keeps its own copy exactly as downloaded, and your file is never changed.
A template you download carries details of your seller account, such as the id of a brand you are approved for. Treat it as private. If you send one to us to fix a problem, we use it only for that (see the privacy page).
Add your category
- The template opens by itself after you drop it in. Later, click it in the list on Templates & Profiles to open it again.
- Under Categories you list in, type part of your category in Find a category… (for example car sticker), choose it, and click Add category.
- ZoraLister shows every field that category has: the column it lives in, whether it is Mandatory or Optional, its type, the exact values a dropdown accepts, length limits, and TikTok's own help text.
Fields your category forbids are hidden, because they must be left blank and ZoraLister does that for you. Tick show fields this category forbids if you want to see them. Remove category archives it; adding it again brings it back.
Build the listing profile
A listing profile tells ZoraLister, once, where each of the category's fields gets its value. After that, every product you list in that category uses it.
- With the category open, click New listing profile. ZoraLister starts it with sensible suggestions already filled in: title, description, price, quantity, SKU, images, options and package size.
- Give it a Profile name.
- Set the filter to Required fields (or Not decided yet) so you only see what still needs a decision.
- For each field, choose where its value Comes from (see the table below) and fill in the details.
- Watch the line at the top. When it reads every required field decided and this profile is ready to build listings, click Save.
| Comes from | Use it for | Example |
|---|---|---|
| Catalog field | A value straight from your product. | Product name comes from Title |
| Fixed value | The same answer for every product in this category. Dropdown fields offer TikTok's exact values to pick from. | Country of origin, warranty type, a compliance question |
| Text pattern | Text built from several values, written with {curly} names. | {title} - {option1_value} |
| Number (×, +, units) | A number from your product, multiplied, added to, converted to another unit, or rounded. | Weight (g) converted to pounds; Price × 1.15 |
| Option name / Option value | The variant's first, second or third option. | "Color" and "Black" |
| Product image | The product's photos by number, main photo first. | Main image is picture 1 |
| Variant's own image | A photo that belongs to one variant. | The white version's photo |
| Leave blank | You have decided this field stays empty. This is different from not having decided yet. | An optional field you do not use |
Text patterns can use {title} {brand} {sku} {price} {option1_value}, and measurements with a unit after a bar: {length_mm|in}, {weight_g|lb}. Add |upper or |lower to change the case.
Most categories have mandatory questions such as dangerous goods or California Proposition 65 warnings. ZoraLister makes you answer them once per profile instead of once per product, but it cannot know the answer. Answer them truthfully for the products this profile will list, and make a second profile if some of your products need a different answer.
Selling in a second, similar category? Open a finished profile and use Copy to category. Every rule the new category accepts is carried over, and ZoraLister tells you which ones it could not take. Archive keeps a profile without deleting it. If you leave with unsaved changes, ZoraLister asks first.
Preview a product
- In the profile, scroll to Preview with one of your products, type part of a product's name in Find a product… and choose it.
- You get a table of exactly what would be sent: one column per variant, one row per field, with your photos shown as thumbnails and every converted number already converted.
- Anything TikTok would reject is listed in red, in plain words, naming the field: a missing mandatory value, a dropdown value that is not on TikTok's list, a title over the length limit, a missing weight or photo, or variants that would collide.
- Fix it where it lives: a missing weight in the product, a wrong answer in the profile. Then preview again.
A product with problems is held back; it will never reach an upload file until the list is empty. Once one product previews clean, the rest of that category is just adding products.
From here, products will become drafts in the Queue for you to approve, and approved drafts will be written into a copy of your TikTok template on the Exports screen, ready to upload in Seller Center. Nothing will ever be sent anywhere without your approval.
Your data, and backing it up
Everything lives in one folder on your PC: Documents\ZoraLister. It holds the database (zoralister.db), an images folder with your original photos and their resized copies, and a templates folder with the marketplace files exactly as you downloaded them. There is no account and nothing is uploaded to us.
To back up, close ZoraLister and copy that whole folder somewhere safe. To move to a new PC, install ZoraLister there and copy the folder into the same place. Uninstalling removes the program only and never touches this folder.
When something goes wrong
| What you see | What it means, and what to do |
|---|---|
| "Saving was blocked" | Your antivirus is guarding the Documents folder (AVG and Avast call it Ransomware Protection; Windows calls it Controlled folder access). Nothing was saved. Add ZoraLister to the allowed apps, then save again. |
| Windows or your antivirus questions the installer | The beta build is not code-signed yet. If the file came from us, allow it. |
| The import refuses your file | You gave Import CSV / Excel a marketplace template. Templates go in Templates & Profiles; the importer is for your own product spreadsheet. |
| "You already have this template; opened it." | You dropped in a file ZoraLister already holds. Nothing was duplicated. |
| The preview complains about options | Some of the product's variants have a Color or Size and others have none. Give every variant the same options (see part 3). |
| A dropdown value is refused | TikTok accepts only its own spelling. In the profile, pick the value from the list the field offers instead of typing it. |
| ZoraLister cannot read your template | We want to see it. Write to support@zoralister.com; that is how the reader gets better. |
Stuck, or found something odd?
Write to support@zoralister.com and say what you were doing and what you saw. The person who answers is the person who built it.