Docs & Guide

Everything you need to get Crosslist Assist set up and running. Works alongside your existing Zipsale account — no extra logins or setup required.

Installation

Crosslist Assist is a Chrome extension. You install it once and it's available every time you open Zipsale.

1
Download the extension
Get the latest version from the Chrome Web Store or from your account dashboard.
2
Open Chrome Extensions
Go to chrome://extensions in your browser and turn on Developer Mode (top right toggle).
3
Load the extension
Click "Load unpacked" and select the unzipped Crosslist Assist folder. The extension icon will appear in your Chrome toolbar.
4
Pin the extension
Click the puzzle piece icon in Chrome's toolbar and pin Crosslist Assist so it's always visible.

Requirements

Your first run

Before running on a full batch, we recommend doing a Test Run on 3–5 items to verify the AI is categorising your stock correctly.

1
Open your Zipsale dashboard
Navigate to web.zipsale.co.uk and make sure your unlisted items are visible.
2
Click the extension icon
The Crosslist Assist popup opens. Select your platform (Vinted, Depop, or Both) and set the quantity to 3–5.
3
Click Test Run
The extension fills every field and saves the listings without making them live. Check the results in Zipsale before committing to a full run.
4
Click List when ready
When you're happy with accuracy, click List. The extension processes your queue and lists everything automatically.
Tip: Set up your mapping rules before your first run — even a few category and colour rules make a big difference to accuracy. See the Mapping section below.

Choosing a platform

Use the platform buttons at the top of the Run tab to choose where items are listed.

OptionWhat it does
VintedLists items to Vinted only. Fills category, colour, size and price.
DepopLists items to Depop only. Also trims photos, removes hashtags, fills brand.
BothProcesses each item for Depop then automatically continues to Vinted in a single run.

List vs Test mode

List — fills all fields and publishes the listing live on the platform.

Test Run — fills all fields and saves the listing without publishing. Use this to verify accuracy before going live.

Setting quantity

The quantity field sets the maximum number of items to process in one run. The extension starts from the top of your unlisted queue and works down. If you have fewer unlisted items than the quantity you set, it will process all available items and stop.

Note: In Both mode, 50 items means 50 Zipsale items listed to both platforms — not 25 per platform.

What is mapping?

Mapping lets you set custom rules that override the AI's decisions. When a keyword in an item's description matches one of your rules, the mapped value is used instead of what the AI extracted.

Mapping rules are set separately for Vinted and Depop — rules on one platform don't affect the other. Use the Vinted/Depop toggle at the top of the Mapping tab to switch between them.

Category rules

Set a keyword and a category. When that keyword appears in any item's description, the category is set to your mapped value.

Examples

Tip: Category rules have a built-in protection — items that are clearly bags, jackets or clothing will never be mapped to Caps regardless of your rules, preventing accidental miscategorisation.

Colour rules

Set a keyword and one or two colours. Useful for patterns and prints that the AI might misread from photos.

Examples

Size rules

Set a keyword and a size. Useful for branded sizing that doesn't follow standard conventions.

Price reduction

Set an amount to automatically deduct from the Zipsale price when listing. For example, if your Depop price is £15 and you set a £3 deduction, Vinted will be listed at £12.

The price toggle can be turned off entirely if you want to keep prices identical across platforms. When off, no deduction is applied regardless of the amount set.

Vinted

Vinted support includes full subcategory mapping across all main and sub categories, up to 2 colours per item, men's waist sizing (28"–39" as exact number, 40–42" as XL, 43"+ as XXL), and women's UK sizing converted from waist measurements.

If the size field is already filled in Zipsale, the extension leaves it untouched.

Depop

Depop support includes everything in Vinted plus:

Both mode

Both mode processes each item for Depop first, then automatically continues to the Vinted form for the same item — all in one run. No extra clicks needed. Item quantity refers to Zipsale items, not platform submissions.

Error log

Any items that failed during a run are logged in the Errors tab. Each entry shows the item ID, its position in the run, and the error message. Use this to identify and manually fix any items that didn't process correctly.

Click "Clear error log" to reset it after you've reviewed the failures.

Troubleshooting

Extension reloads but does nothing

There's likely a syntax error in the content script. Open the Chrome console (Cmd+Option+J on Mac, F12 on Windows) on your Zipsale dashboard and look for a red error message from content.js. Send this to support.

Category shows "No results found"

The AI returned a category name that doesn't match what Zipsale's search expects. Add a mapping rule to override it — set the keyword to something unique in that item type's description and map it to the correct category.

Items listed in wrong gender category

The extension reads gender from the description. Make sure the description includes "Women's" or "Men's" explicitly. If it doesn't, add a category mapping rule for a keyword that's specific to that item type.

Size not being set

If the size field is already populated in Zipsale, the extension skips it intentionally. If the field is empty and size still isn't being set, check that the description contains an explicit size (tagged size, labelled size, or waist measurement).

Contact support

Email: [email protected]

We aim to respond within 24 hours. When contacting support about a bug, it helps