TikTok Shop bulk upload template: turning a supplier spreadsheet into rows that join up as one product
A supplier spreadsheet gives each colour its own product name, the weight in kilograms and a barcode Excel shows as 5.01235E+12. TikTok Shop’s bulk upload template needs one row per variant with every shared detail identical, the packed parcel in grams and centimetres, no barcode repeated across variants, and image links that open the picture itself. Here are the template’s fields, the rule that makes variant rows join up, where supplier files break it, one row before and after, and what happens at review.
Have a supplier file like this? Send it exactly as it arrived and see the same products before and after.
What the TikTok Shop bulk upload template is
A supplier’s spreadsheet for a yoga mat in three colours arrives as three rows with three different names: FENWALD YOGA MAT 6MM PURPLE!! on one, Fenwald yoga mat black on the next. Every row gives the weight as 1.1kg, the size as 183 x 61 x 0.6cm, and a barcode that Excel shows as 5.01235E+12.
The TikTok Shop bulk upload template is the .xlsx file that Seller Center’s Bulk Listing Tool gives you once you choose a category and brands.1 It needs one row per variant, with the product name and every other shared detail identical on each row, the package weight in grams and its length, width and height in centimetres as bare numbers, and image links that open the picture itself.1
Where to get it
TikTok’s Bulk Listing Tool page, dated 7 August 2025, gives two ways in: Products, Manage Products, then Bulk action; or Products, Batch Tool, then Bulk publish products. You “Select a category and brand(s), then download the template.”1 One file can hold many products, up to 5 MB.1
TikTok’s comparison of its listing tools puts the template with sellers who “don’t have Identifier codes for most products”, and gives its drawback as “Many required fields, like product category and image URL, leading to potential errors and listing failures.”16 Sellers whose codes are mostly there have a shorter route, the Product Upload Accelerator, which takes five columns and imports only products it can match to a valid identifier code.1617
The fields, and what each one takes
The Bulk Listing Tool page marks each field mandatory, optional or conditionally mandatory.1
| Field | Required | What goes in | Watch for |
|---|---|---|---|
| Category | Mandatory | One choice from the drop-down | A wrong category breaches TikTok’s guidelines3 |
| Brand | Optional | One choice from the drop-down | A branded product must show its actual brand7 |
| Product Name | Mandatory | Text; over 25 characters recommended | Ideally 80 characters at most; no promotions or symbols23 |
| Product Description | Mandatory | Text | At least 30 words3 |
| Package Weight | Mandatory | Grams, numbers only | The packed parcel, packaging included2 |
| Package Length/Width/Height | Mandatory | Centimetres, numbers only | The package, not the product2 |
| Identifier Code Type, Identifier Code | Optional | ISBN, UPC, EAN or GTIN, and the code | Format checked; one per variation4 |
| Variation 1 (Colour), Variation 2 (Size) | Variation 1 once a product has variations | One value per row | Variation 2 only for a second tier |
| Retail Price, Quantity | Mandatory | Numbers only, the price in pounds | No £ sign, no In stock |
| Main Product Image, Image of Variation 1, Product Image 2 to 9 | Main image only | Image URLs | Direct links, at least 800 × 800 pixels3 |
| Others (Size Chart/Material...) | Conditionally mandatory | Depends on the category | Follow the template’s prompts |
The last row changes with the category: those fields “will be conditionally mandatory according to your product category”, and the template’s prompts say which apply.1
TikTok’s April 2024 product guide adds two working rules: read the Instruction and Example sheets before filling in the Template sheet, and “Do not delete the original rows and columns in the template”.5
Above the 30-word floor, TikTok’s pages disagree on description length: the Bulk Listing Tool page recommends going over a character count that the newer guide to adding a product says to stay under.312
One row per variant, and what every row must share
Supplier files put colours in one cell, as Purple/Black/Sage, or on rows with names of their own. The template takes neither. “Each SKU should be placed on a separate row”, so three colours make three rows, and three colours in two sizes make six.1 Variation 1, read as colour by default, is mandatory once a product has variations; Variation 2 is for a second tier only, and values within one product “have to be different”.1
Then comes the rule that decides whether those rows become one product: “Except for variation information (variation name and variation image), retail price, quantity, and seller SKU, please ensure that the other product information is exactly the same. Otherwise, we cannot consider those items as different variants of the same product.”1 TikTok’s April 2024 guide names the columns that must be “totally the same”: category, brand, product name, product description, and the parcel’s weight, length, width and height.5
Listing each colour as its own product is no way round it: TikTok treats that as a duplicate listing, keeps one, and “The others may be removed, restricted, or hidden.”6 Variants: size and colour covers what counts as a variant.
| Variation 1 (Colour) | Product Name | Package Weight | Identifier Code | Retail Price | Quantity | Seller SKU |
|---|---|---|---|---|---|---|
| Purple | Fenwald 6 mm TPE Yoga Mat with Carry Strap | 1250 | 5012345678900 | 24.99 | 40 | FM-YM6-P |
| Black | Fenwald 6 mm TPE Yoga Mat with Carry Strap | 1250 | 5012345678917 | 24.99 | 25 | FM-YM6-B |
| Sage | Fenwald 6 mm TPE Yoga Mat with Carry Strap | 1250 | 5012345678924 | 26.99 | 12 | FM-YM6-S |
Where supplier spreadsheets break the template
Names that change from colour to colour. By TikTok’s rule, rows with different names cannot be variants of one product, so the colour moves into Variation 1 and one name goes on every row. TikTok asks for “more than 25 characters (including spaces) and ideally no more than 80 characters”, built from brand, details, use, type and main features.2 Promotions such as “x% off”, seller names, and symbols or special characters stay out.3 Writing product titles shows how to build one from the data.
The product’s weight and size, not the parcel’s. 1.1kg is the mat and 183 x 61 x 0.6cm is the mat unrolled, but the template asks for the package, in grams and centimetres, numbers only.1 TikTok means “the total package weight, which includes the product itself and any additional packaging materials”.2 Rolled and boxed, the mat is 1250, then 63, 15 and 15, each in its own cell. Convert pounds and inches first: TikTok’s developer documentation has an error for “imperial units on non-US local products”.19 Units and dimensions covers converting a whole column.
Barcodes nobody can read. Excel “converts large numbers to scientific notation”, so three different EANs can all show as 5.01235E+12, and on screen you cannot tell whether the supplier sent three codes or one.20 TikTok checks the format, “EAN: 8, 13, 14 digits, numbers only”, and each variation needs its own code.14 GTIN, EAN, UPC and MPN explained covers getting the digits back.
File names and page links where image links belong. FM-YM6-P.jpg names a file on the supplier’s computer, and a product page is not an image. The template’s image URL “must link directly to the image”, and images uploaded to TikTok’s Media Center come with a link to copy.1 Each must be at least 800 × 800 pixels.3 A link in the right form can still be dead: of the 12,015 image links on one musical instrument catalogue, 3,566 failed when we fetched them, nearly a third.
The distributor’s name as the brand. Ashby Row Trading Ltd in a Brand column names whoever sold the stock, not the brand on the pack. TikTok’s August 2026 policy update says “the brand field must show the actual brand on the product, packaging, and labelling”, and must not be left blank or set to No Brand for a branded product.7 The template marks Brand optional; TikTok’s guide to adding a product marks it “Required for Branded Products”.12
One supplier row, before and after
Here is the purple mat’s row as the supplier sent it; the black and sage rows differ only where a variant may.
| Template field | Supplier sent | After |
|---|---|---|
| Category | Fitness > Yoga | picked from TikTok’s drop-down |
| Brand | Ashby Row Trading Ltd | Fenwald |
| Product Name | FENWALD YOGA MAT 6MM PURPLE!! | Fenwald 6 mm TPE Yoga Mat with Carry Strap |
| Product Description | Best non slip mat. Eco friendly. 6mm | written from the specs: TPE, 6 mm thick, 183 × 61 cm unrolled, carry strap included |
| Package Weight | 1.1kg | 1250 |
| Package Length/Width/Height | 183 x 61 x 0.6cm, in one cell | 63, 15 and 15 |
| Identifier Code Type, Identifier Code | 5.01235E+12 | EAN, 5012345678900 |
| Variation 1 (Colour) | PUR | Purple |
| Image of Variation 1 | not supplied | a direct link to the purple mat’s photo |
| Retail Price | RRP £24.99 | 24.99 |
| Quantity | In stock | a count from your own stock |
| Main Product Image | FM-YM6-P.jpg | a direct link to the full-size photo, at least 800 × 800 |
The description loses “best” and “non slip”. TikTok’s claims guide allows absolute claims such as “best” only when they are “accurate, supportable and clearly scoped”, and asks for evidence behind every performance claim.9 The category stays amber because it comes from TikTok’s own tree, and a product in the wrong one is a listing violation.13 The brand on the pack was never in the supplier’s file, and each colour’s barcode has to be confirmed against the product. Finding values from the product itself is what product data enrichment means in practice.
Filling and uploading the template, step by step
- Settle brand authorisation first, in the Qualification Centre, for any brand that requires it; without it a listing “may not be approved or may be removed”.7
- Download the template for the category, selecting every brand the file will carry.1
- Give every variant its own row, with the shared details written once and copied exactly.1
- Convert every measure to grams and centimetres for the packed parcel, one number per cell.12
- Type barcodes into a column already formatted as Text, because the format “will only affect numbers that are entered after the format is applied”.20
- Paste a direct link for every image, and open each one before you upload.1
- Fill the category’s own fields, such as size chart or material.1
- Upload, check the preview of the first product and click Confirm to start import. Then fix whatever the Online Editor highlights and submit from the editor, without uploading again.1
What happens after the upload
Products that pass the upload still go to review before they are listed.52 A product that fails gets an email with the reason and can be corrected and resubmitted; a frozen one, for illegal, harmful or counterfeit goods, cannot.14 A product deleted for a listing violation must not be uploaded again.13
TikTok’s claims guide names four ways a listing goes wrong: it may be removed or suppressed when its information is “incomplete, unverifiable, exaggerated or inconsistent”.9 In a bulk upload, that means:
- Incomplete: titles made only of numbers and codes, or no image of the product being sold.10
- Inconsistent: a title and description that disagree, in TikTok’s example “red shoes” against “blue boots”.11
- Exaggerated: absolute terms without proof, such as “No.1 product, 100% Natural, 100% Organic”.12
- Duplicated or miscategorised: one product listed twice, or in a category that does not fit it.13
Repeated violations within 180 days can suspend new product uploads for two to seven calendar days.13 Edits go back through review, which TikTok aims to finish within 24 hours.15
When it is not obvious
A product with no barcode. TikTok’s 2023 identifier guide says “For all the UK categories, the product identifier code is optional”; its 2024 product guide says certain categories require it, and others need a valid reason for leaving it out.45 Follow what your category’s template asks. A code “should be registered with the GS1 database”, and without one, TikTok’s advice is to ask the manufacturer, or GS1 if you make the product yourself.4 A supplier’s stock code is never a barcode.
Sizes that ship in different boxes. Package weight and dimensions are shared fields, so a towel sold in hand and bath sizes declares one parcel for both.5 TikTok’s pages do not say which to declare. For orders shipped via the platform, its parcel guide of 2 July 2026 lets you edit each order’s parcel before printing the label, and charges a parcel heavier or bigger than declared at the correct rate plus a handling fee.18
A brand you are not yet authorised for. Brand authorisation is TikTok’s permission to list a brand. You apply in the Qualification Centre as the trademark owner, or as a seller authorised by the owner or by one of its authorised distributors; a proof of purchase route is open only to selected sellers. Once approved, the brand name cannot be changed.8
Where RefynData fits, and what to do next
All of this happens in the spreadsheet, before TikTok sees a row, and it is the part we prepare from supplier spreadsheets for TikTok Shop. Each SKU or barcode is matched to the real product, missing barcodes and full-size photos are filled in from its sources, and the brand is taken from the product’s own pages for you to confirm. Every image link is checked, every measure converted to one unit, and titles and descriptions are written from the values in the data, to enforced length limits. Every value keeps a link to its source; you copy the file into TikTok Shop’s template, and the upload and any brand authorisation stay with you.
Whichever way the file is built, upload one product in its three colours before three hundred, and keep each fix as a rule for that supplier: the next delivery will bring the same names, the same kilograms and the same 5.01235E+12. That preparation, for every supplier file, is RefynData’s product data enrichment service.
Questions
Where do I download the TikTok Shop bulk upload template?
In Seller Center, through the Bulk Listing Tool: TikTok’s help page gives Bulk action under Manage Products, or Bulk publish products under Batch Tool. You select a category and brands, then download the .xlsx file.
Do I need a barcode to list on TikTok Shop?
The template marks Identifier Code optional, but TikTok’s pages disagree on whether some categories require one, so follow your category’s template. Where you enter codes, each variant needs its own, and a submitted code cannot be changed, so never put a supplier’s stock code in its place.
How do I add variations in a TikTok Shop bulk upload?
Give each variant its own row, with the colour in Variation 1 and any second tier, such as size, in Variation 2. Everything except the variation’s image, price, quantity, SKU and barcode must be identical on every row, or TikTok cannot treat the rows as one product.
Why did my TikTok Shop bulk upload fail?
Rows that fail the upload are highlighted in the Online Editor, where you correct each cell and submit without uploading again. Products that pass can still fail review for incomplete or inconsistent information, unsupported claims, a wrong category or a duplicate listing.
What is brand authorisation on TikTok Shop?
It is TikTok’s permission to list a brand’s products, given once you prove you own the trademark or are authorised to sell it. You apply in the Qualification Centre, and TikTok’s guide says the brand’s products can only be listed once it has formally approved you.
Sources
- TikTok Shop Academy. Bulk Listing Tool.
- TikTok Shop Academy. How to Add a New Product.
- TikTok Shop Academy. Best Practices for Product Listings.
- TikTok Shop Academy. Understanding Product Identifier Codes.
- TikTok Shop Academy. All-in-one Guidance: Manage Your TikTok Shop Products Easily (video guide).
- TikTok Shop Academy. Duplicate Listing Guidelines.
- TikTok Shop Academy. Seller Policy Pulse (August 2026).
- TikTok Shop Academy. Guide to Brand Authorisation.
- TikTok Shop Academy. Guide to Making Accurate, Complete & Verifiable Product Claims in Your Listings.
- TikTok Shop Academy. How to prevent violation of Incomplete Information.
- TikTok Shop Academy. How to avoid inconsistent information on your product detail page.
- TikTok Shop Academy. Guidelines for Absolute Terms & Exaggerated Product Descriptions.
- TikTok Shop Academy. Prevent Product Listings Rejections.
- TikTok Shop Academy. Product Status.
- TikTok Shop Academy. Guidelines for Editing Listed Products.
- TikTok Shop Academy. Product Listing Overview.
- TikTok Shop Academy. Product Upload Accelerator.
- TikTok Shop Academy. How To Manage Parcel Weight & Size Before Shipping.
- TikTok Shop Partner Center. Create Product (API reference, version 202309).
- Microsoft Support. Keeping leading zeros and large numbers.