Skip to main content

Bulk Add Products and Variants

Last Updated: 14/09/2026

The Bulk Add action in ARShades Studio imports many products and their variants into a catalogue in one operation, starting from a list of codes you already have. It is the fastest way to populate a catalogue when you are working from a price list, an ERP export, or a seasonal collection sheet.

What This Action Does​

By using the bulk add option, you can:

  • Upload a CSV or XLSX file containing SKU codes, EANs, or UPCs.
  • Automatically match your codes with available assets in the ARShades Library.
  • Add multiple products and variants in a single operation.
  • See, in the same pass, which of your codes are not yet in the Library but can be ordered.

How to Bulk Add Products and Variants​

1. Open the Bulk Add Tool​

  1. Go to the My Catalogues section.
  2. Open the catalogue where you want to add products by clicking Assets List on its card.
  3. In the toolbar at the top of the Assets List, click Bulk Add 3D Assets.

The dialog that opens is titled Search SKUs from a List and runs in three steps.

If you cannot see the button

Bulk Add 3D Assets is hidden on mobile screens, and it is only shown to roles that are allowed to modify a catalogue. On a phone or tablet, or with a read-only role, the Assets List is available but this action is not.

2. Upload File​

  • The file must be in CSV or XLSX format.
  • Each row must contain at least one of the following identifiers: SKU, EAN, or UPC. Column names are matched case-insensitively.
  • An optional priority column sets the display order of the imported items.
  • Maximum: 1000 rows per file.

Two ready-made templates are linked in this first step — one CSV and one XLSX. Download either and fill it in: it already carries the column names Studio expects.

Example format:

SKU,EAN,UPC
SKU123,1234567890123,012345678905
SKU124,1234567890124,012345678906
SKU125,1234567890125,012345678907

Drag and drop your file into the upload area, or click to browse, then click Process File. A progress bar shows the status while Studio matches every row against the Library.

Two errors stop the upload:

  • “File contains N rows. Maximum allowed is 1000 rows. Please reduce the number of items in your file.”
  • “No valid codes found in the file. Please ensure the file contains SKU, EAN or UPC columns.”

Individual rows carrying none of the three codes are skipped without stopping the import; the file as a whole is refused only when no row carries any usable code.

3. Review Summary​

After processing, the results are grouped into four categories:

CategoryMeaningWhat you can do
AvailableThe code was matched with an asset already in the ARShades Library.Add it to the catalogue now, in step 3.
OrderableThe product exists but is not yet in your Library.It cannot be added here — it has to be ordered. See the end of this page.
ErrorInvalid code, or no product found for it.Correct the code in your file and upload again.
OtherAny result that falls outside the three categories above.Review case by case.

Expand each category to see the individual rows. Available, Error and Other list SKU, EAN, UPC, Product Name and Status; Orderable shows the Priority in place of the product name, because those items are destined for an order rather than for the catalogue.

Click Next when you are done reviewing.

4. Select & Add to Catalogue​

  1. Select the destination Catalogue.
  2. Review the products marked Available — they are pre-selected by default. Use the checkboxes to deselect anything you do not want.
  3. Only products marked Available can be added, and at least one must stay selected for the button to work.
  4. Click Add to Catalogue.

5. Confirm Addition​

A modal titled Confirm Addition summarises how many products will be added, and to which catalogue. Confirm to start the import.

Result​

The success screen reads Products Added Successfully! and tells you how many products were added.

Import runs in the background. The Assets List does not fill in instantly:

“You will receive a notification when the processing is completed. Please return later to see the updated list in the catalogue.”

Once processing is complete:

  • All imported products and variants appear in the catalogue's Assets List.
  • Each SKU added counts towards your subscription tier limits.
  • Imported items can be rearranged, paused, or deleted like any other catalogue asset.

Products You Can Order​

If the file contained codes classified as Orderable, the same success screen offers them to you:

“There are N products available to order. Would you like to proceed with placing the order now? If you don't do it now, you'll need to go to the orders section and restart the order creation process.”

Click Order Products to move straight to the order, or Close to skip. Skipping loses no data, but the order has to be rebuilt from the orders section later — so placing it now is usually the shorter path.

Best Practice​

  • Start from the CSV or XLSX template offered in step 1 rather than building a file from scratch.
  • Keep each upload within the 1000-row limit; split larger collections into several files.
  • Read the Orderable group, not only the errors: those are real products you simply do not own yet.
  • Correct the codes in the Error group in your source file and re-upload, rather than adding them by hand afterwards.
  • Use bulk add when importing large seasonal collections or migrating from an external product database; use Add Product or Variant for a handful of curated SKUs.