Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ship-around.com/llms.txt

Use this file to discover all available pages before exploring further.

Open Import Products. The page explains that you will select one or more product subcategories, choose the details you want to include, download a workbook template, and upload it to publish your listings. Use ← Back to Dashboard to leave the wizard.

​
Step 1: Select Product Categories

Section heading: Step 1: Select Product Categories. When this step is done, a Complete pill can appear next to the heading.
  • Under Product family and subcategory, use Search categories or browse Product family and Subcategory like on the single-product form.
  • You can select multiple subcategories. They appear under Selected subcategories as chips you can remove.
  • Choose Continue with selected categories (enabled only after at least one subcategory is selected).

​
Step 2: Add Product Details

Section heading: Step 2: Add Product Details.
Do not use Add product to add sizes, finishes, or other options for the same listing. In this flow, Add product means “start another separate listing” in the subcategory you chose—not “add another row of options” for the listing you are already setting up.The listing you configure here is the main offer buyers see (title, description, brand, where stock sits, and which columns appear in your file). Each different size, specification, or price line for that same offer belongs in the workbook, as extra rows copied under the same draft reference—not as extra clicks on Add product in this step.Example — one listing, many rows in the file: You might set up a listing called Yokohama Pneumatic Fenders. That name and its shared details are defined once in the wizard. When you download the workbook, you add one row per size or configuration you sell; buyers pick among those rows. You are not meant to click Add product again just to get another size.Example — two genuinely different listings: You sell Yokohama Pneumatic Fenders and also IRM Pneumatic Fenders. Buyers would treat those as two different products. Use Add product a second time for the IRM line, then fill each listing’s rows in the workbook.Example — same product, two places you stock it: Stock location (country and city on the product card) is set once per product—it covers that whole listing and every row you add for it in the workbook, not each variation line separately. If the same item is stocked in two different locations, you need two products: use Add product for the first site and set its location, then Add product again for the second site with the other location, and complete the workbook rows for each draft.If you are unsure, remember: Add product means another listing title in this category. More rows in the workbook means more purchasable lines under a listing you already started.
This step uses the same listing strength idea as Create a single product listing: a note that more complete listings rank higher in search results, a listing strength bar that updates as you choose SKU-defining fields and enter data, and guidance to select the data you can provide with at least one SKU item required. Open Learn more on the page to see what the badges mean:
  • SKU — Defines separate product variations.
  • Variant — Additional detail for each variation.
  • Shared — Applies to all variations equally.
  • For each selected subcategory, an accordion section opens so you can set titles, descriptions, brand, stock location, and which columns to include in the Excel workbook (SKU-defining columns, per-variation detail columns, and so on—labels match your subcategory).
  • You can use Add product whenever you need another listing in that subcategory—as in the examples above. Each listing you add must end up with at least one row in the workbook after download (that is where the purchasable lines are defined).
  • When everything required is filled, choose Create Drafts & Download Workbook.
A note on the page: If a cell is locked in Excel, you cannot change or add anything there. Do not try to edit locked columns in the downloaded file.

​
Step 3: Download Workbook

Section heading: Step 3: Download Workbook.
  • Text explains that drafts are created and you should download the workbook, fill it in, then proceed to upload.
  • Use Download Workbook to get the .xlsx file. There is one sheet per subcategory you selected.

​
How the workbook is organized

The first three rows of each sheet are instructions (row 1–3):
  1. Numeric values: Use a dot for decimals (up to two decimal places) and no thousand separators (for example 12.50 or 10250.32). If a column has a unit of measure (UoM) next to it, pick the right value from the dropdown and enter only the number in the cell. Enter prices in USD and stock as whole numbers (integers).
  2. Draft ID and title: Those columns are pre-filled—do not change them. To add another size, specification, or price line for the same listing, copy the draft ID and title onto every new row you fill in. That is the right way to expand a listing; going back to the wizard and clicking Add product again would start a second listing instead.
  3. Scope: The workbook applies only to your current pending drafts. Delete or discard it when you are done.
  • Locked columns (often including draft reference and title) must stay as provided, consistent with the sheet instructions above.
  • SKU-defining columns (blue-tinted in the file) are the combinations that create separate variations.
  • Per-variation detail columns (purple-tinted) add extra information per row.
  • Required columns (yellow-tinted, often marked with *) include Price, Stock, and Lead Time. Values must follow the rules shown in the sheet (for example: positive price with up to two decimal places using a dot, whole-number stock, Lead Time exactly matching one of the allowed options).

​
Take your time: leave, work offline, come back

As soon as Create Drafts & Download Workbook finishes, your batch is saved. You can download the file, step away, fill it in on your own schedule—even fully offline—and return to Import Products later. The screen picks up where you left off: you still see Download Workbook, Upload Workbook, and under Step 5: Review & Confirm a separate row for each listing with a status such as ready to publish, has errors, no rows yet, or already published. Nothing forces you to finish every listing in one sitting. Progress is tracked per listing (each title you set up in the wizard gets its own draft reference in the file), not per subcategory sheet. If two listings share the same subcategory, they appear on the same sheet but with different draft IDs and titles. You can upload and publish one of them whenever it is ready and leave the other until later—the choice is always listing by listing, including when you use Confirm & Publish this product for a single name or Confirm & Publish all ready products for every listing that is currently ready. You may upload the workbook as many times as you need while you correct mistakes or add rows. If your file still contains rows for a listing you already confirmed and published, those rows are left alone—the system does not try to publish that listing again or treat them as an error. Only rows for listings that are still drafts in this batch are read for that upload. In short: Confirm & Publish (for one listing or for all ready) only turns draft listings from this batch into live listings; it never re-runs a listing that is already published from this flow.

​
Step 4: Upload Product File

Section heading: Step 4: Upload Product File.
  • The page states that error-free upload only stages data and publishing requires explicit confirmation per product.
  • Under Workbook, choose your filled .xlsx file, then Upload Workbook. You can upload again later with an updated file as often as you need while this batch is active (see Take your time under Step 3).
  • If the upload reports problems, use Download Errors (when shown) to see what to fix, correct the workbook, and upload again.

​
Step 5: Review & Confirm

Section heading: Step 5: Review & Confirm.
  • Ready items have at least one valid variation row and no blocking errors.
  • Use Confirm & Publish all ready products when you want to publish everything that is ready, or publish one product at a time from the list (buttons or actions shown per draft).
  • Each draft shows status such as ready, errors, no rows, or published, depending on your batch.

​
Danger Zone

At the bottom, open Danger Zone if you need to delete all draft products created by the current active bulk batch and reset this flow.
  • In Type DELETE to enable reset, enter the word DELETE exactly.
  • Then Delete All Batch Drafts & Reset becomes available. Use this only when you intend to start over; it removes that batch’s drafts.
Related: Create a single product listing · Update multiple listings at once