Products

Overview

The Products section is the single source of truth for your entire catalog. Every SKU you sell across Amazon, eBay, Shopify, Walmart, Bol.com, Zalando, and Kaufland is stored once in NexusCommerce's products table. Marketplace-specific representations (ASINs, item IDs, EANs) are stored in the linked marketplace_listings table.

Editing a product's core attributes in NexusCommerce pushes changes to all connected marketplaces simultaneously, eliminating the need to update listings one marketplace at a time.

Key Concepts

SKU — Your internal product identifier. Must be unique within your tenant. If you already have SKUs in your warehouse management system (WMS) or ERP, import them as-is to maintain continuity.

Listing — A marketplace-specific representation of a SKU. One SKU can have multiple listings (e.g., one on Amazon US, one on Amazon UK, one on eBay DE). Each listing has its own price, stock level, and status.

Product Status — A product can be active, inactive, draft, or archived. Only active products are included in sync operations.

Listing Status — Independent of product status. A listing can be active, suppressed, inactive, or error. A suppressed listing means the marketplace has flagged it for a policy issue.

Getting Started

Navigate to Products in the left sidebar. If you have completed the initial catalog sync, your products are already imported.

To add a product manually:

1. Click New Product
2. Enter SKU, title, description, category, and GTIN/EAN/UPC
3. Upload images (JPEG or PNG, minimum 800x800px)
4. Set dimensions and weight (required for shipping rate calculation)
5. Click Save as Draft or Publish

Publishing creates listings on all connected marketplaces automatically.

Features

Product List View

The Products list supports:

• Search — Full-text search across title, SKU, GTIN, and description
• Filter — Filter by marketplace, status, category, price range, stock level
• Sort — Sort by title, SKU, price, stock, last-synced date
• Bulk select — Select multiple products for bulk actions

Product Detail Page

Each product detail page has three tabs:

Overview tab:

• Core attributes (title, description, category, brand, GTIN)
• Images (drag to reorder, click to replace)
• Dimensions and weight
• Cost price (used for margin calculations, never sent to marketplaces)

Listings tab:

• Per-marketplace listing status, price, and stock
• Last sync timestamp
• Link to the live listing on the marketplace website
• Override fields: marketplace-specific title, description, or images that differ from the master

History tab:

• Timeline of all changes (price changes, status changes, sync events)
• Who made each change (user or system)

Bulk Operations

Select multiple products from the list and use the Bulk Actions menu:

CSV Import / Export

Export — Click Export on the Products list to download a CSV of all products with all attributes. Use for bulk editing in Excel or for backup purposes.

Import — Click Import to upload a CSV. The import wizard maps your CSV columns to NexusCommerce fields. New SKUs are created; existing SKUs are updated. Required columns: sku, title, status.

Example CSV format:

sku,title,description,gtin,cost_price,weight_kg,status
SKU-001,Blue Widget 500ml,Premium blue widget in 500ml size,5901234123457,4.99,0.35,active
SKU-002,Red Widget 250ml,Compact red widget in 250ml size,5901234123464,2.99,0.18,active

Marketplace Listing Overrides

On the Listings tab of a product, you can set marketplace-specific overrides for:

• Title (max length varies by marketplace)
• Description / bullet points
• Images (use marketplace-optimized variants)
• Category (marketplace-native category tree)
• Attributes (marketplace-specific attributes like Amazon browse nodes)

Overrides are stored in marketplace_listings.override_data as JSON and take precedence over the master product data when syncing.

Image Management

Images are stored in Supabase Storage. Each product supports up to 9 images. Requirements:

• Minimum size: 800x800px (1000x1000px recommended)
• Format: JPEG or PNG
• Background: white recommended for Amazon compliance
• Max file size: 10MB per image

NexusCommerce does not resize or compress images — upload at your desired resolution.

Configuration