Skip to main content

Add Product or Variant

Last Updated: 14/09/2026

The ARShades Library is the shared archive of every 3D eyewear asset available to your organisation. Adding a product from the Library into one of your catalogues is the manual alternative to a bulk import: you pick the exact model and the exact variants you want, one product at a time.

What This Feature Does​

By adding a product manually from the ARShades Library, you:

  • Select the exact product model and variants to include in a catalogue.
  • Ensure only approved products are visible in your published experiences.
  • Keep full control over which SKUs contribute to your subscription tier limits.

How to Add a Product Manually​

1. Open the ARShades Library​

Click ARShades Library in the left-hand menu. The Library opens on its own page and lists every product available to your organisation.

Where the Library lives

The Library is a section of its own, not a button inside a catalogue. You choose the destination catalogue later, inside the add dialog — so you can start from the Library at any time, without opening a catalogue first.

2. Search and Filter Products​

Use the Filters panel on the left to narrow down the Library. The panel is split into three areas:

Placeholder: “Search by model name, variant name, SKU, EAN or UPC code…”. The search runs on both products and individual variants — matching variants are highlighted inside their parent product row.

Product-level filters​

These narrow the list by characteristics of the product family:

  • Select Brand — filter by one or more brands.
  • Select Manufacturer — filter by the parent company that owns one or more brands. Selecting a Manufacturer automatically restricts the Brand dropdown to the brands belonging to that Manufacturer, and clears any previously selected Brand and Line. Use this when you want to browse the entire portfolio of a group without picking brands one by one.
  • Select Line — collection within a brand. The dropdown is automatically restricted to the lines that exist for the currently selected Brand(s).
  • Select Type — model type (e.g. sunglasses, optical frame).
  • Select Gender — target audience.
  • Select Frame Shape — geometric shape of the front (round, square, aviator, …).

Variant-level filters​

These look inside each product's variants (SKUs) and only show products that have at least one variant matching the selection:

  • Select Size — switch between Calibre (numeric, e.g. 52) and Simple (S/M/L) using the toggle above the dropdown.
  • Select Frame Color — colour of the front.
  • Select Lenses Color — colour of the lenses.
  • Select Material — material of the frame.
  • Select Treatment — surface treatment applied to the lenses.
  • Select Hinge Type — type of hinge.

Other controls​

  • Show new assets (toggle) — displays only products and variants published in the last 30 days. Its tooltip reads: “Show products and variants published in the last 30 days.”
  • Apply Filters — applies all current selections and refreshes the table. The button stays disabled until you change at least one selection; until you click it, the filters are pending and the table keeps the previous result.
  • Reset Filters — clears every selection (including the search box) in one click.
Faceted dropdowns

The Filters panel hides options that would produce no result given your current selection. For example, after picking a Manufacturer you will only see Brands, Lines, Sizes and colours that exist within that Manufacturer's catalogue. Values you have already selected stay visible even if they fall outside the available set, so you can always remove them.

3. Select Variants​

  1. Find the product you want to add and click the plus (+) button in the Add To Catalog column, on the right edge of the table. The column stays visible while you scroll the table sideways.
  2. The Select Variants step opens on a table titled Available Variants, listing every published variant of that product. Variants that are not published do not appear at all.
  3. Tick the variants you want. The checkbox in the column header selects or clears them all at once.
  4. If the product already belongs to one of your catalogues, a blue banner says so at the top of the step — useful, but it does not yet tell you anything about the single variants.

4. Select Catalogue​

  1. Choose the Subscription (radio buttons).
  2. Choose the destination Catalogue from the dropdown.

5. Review & Confirm​

This is the step that compares your selection against the catalogue you have just chosen — duplicates can only surface here, because until step 4 the destination was unknown.

  1. The Selected Variants Review table summarises your choice with five columns: Image, Product Name, SKU, Frame Colour and Status.
  2. Each row is marked either Will be Added or Already in Catalogue. Rows already in the catalogue are greyed out and struck through, and an alert spells out the rule: “Variants marked as 'Already in Catalogue' are already present in the selected catalogue and will not be processed. Only variants marked as 'Will be Added' will be added to your catalogue.”
  3. Confirm by clicking Confirm. The button reads Adding… while the operation runs.

A success message closes the flow. Its title depends on what actually happened:

  • Product Added to Catalogue — the product was not in the catalogue and has been created with the selected variants.
  • Variants Added to Catalogue — the product was already in the catalogue and only the new variants were appended.

If you selected a mix of new and existing variants, the message reports both counts — for example “3 variants added successfully. 2 variants were already present in the catalogue.” If every selected variant was already there, nothing is added and Studio answers: “All selected variants are already present in the catalogue.”

While the 3D viewer is being configured in the background, the message ends with “Configuring 3D viewer…”.

Result​

  • The product and its selected variants are now visible in the Assets List of the chosen catalogue.
  • Each added SKU contributes to the subscription tier limits.
  • Added assets can later be rearranged, paused, or deleted like any other catalogue asset.

Best Practice​

  • Use Select Manufacturer as the first filter when you want to browse an entire group's portfolio — it narrows Brands and Lines automatically and avoids the need to remember each brand name.
  • Combine Select Frame Shape with Select Frame Color to scout assets that match a campaign mood quickly.
  • Toggle Show new assets before a catalogue refresh to spot recent additions you may want to publish.
  • Read the Status column in the Review & Confirm step before confirming: it is the only place where Studio tells you which of your variants are duplicates, because it is the only step that knows the destination catalogue.
  • Add products one at a time for precise catalogue control, especially for curated or campaign-specific catalogues. For long lists of SKUs, use Bulk Add Products and Variants instead.