Curosa
Supplier Portal API Reference New

Products

Product Catalog

Learn how to create and manage product listings on the Curosa platform

Overview

Product listings are the foundation of your catalog on Curosa. This guide will walk you through creating new products, managing product information, setting up variants, and preparing your products for publication on the platform's various websites.

Create a single product

To create a new product:

  1. Navigate to the Products section in the sidebar navigation

  2. Click on New Product

  3. A modal window will appear requesting the following information:

    • SKU (Stock Keeping Unit) - Your unique product identifier
    • Product Name - The name of your product
  4. Click Create Product

If you already have a product with the same sku, it will show you an error.

You can add this information in any language you wish, this is used only for yourselves and isn't changed by the Cuorsa marketing team.

After creating Create Product, you will be redirected to the product page to add additional information.


Importing Products

The product import feature allows you to quickly create or update multiple products in bulk using a CSV file. This is the recommended method for adding large numbers of products or keeping existing product data up to date.

Product imports are processed in the background, allowing you to continue using the platform while the import completes.

Accessing the Product Import Tool

  1. Navigate to the Products listing page.
  2. In the top-right corner, click Import Products.
  3. A modal window will open with information and import options.

At the top of the import modal, click Download Example CSV.

This file:

  • Contains all available product fields
  • Includes attribute fields such as height, width, and length
  • Uses the correct column structure for importing

It is strongly recommended that you use this file as your starting point.

Required Fields

The following fields are required for a successful import:

  • MPN – Manufacturer Part Number (your SKU)
  • Product Name – The name you use to identify the product. This can be in any language you wish to use.

While not strictly required, a Supplier Description is strongly recommended. Products cannot be reviewed for listing on the sites without a description.

Import Options

When importing products, you can control how the system behaves:

Create New Products

  • When enabled, new products will be created if they do not already exist.
  • When disabled, only existing products will be updated.

If you are creating new products, by default their status will be set to draft and will require review before being accepted onto the platform.

Update Existing Products

  • When enabled, existing products will be updated using the CSV data.
  • When disabled, existing products will be ignored, preventing accidental overwrites.

If you are updating products, such as product descriptions, you will need to request a review for these changes to be relected on the websites

These options allow you to safely manage updates depending on your use case.

Uploading and Matching Your File

When you are ready to import you products:

  1. Select your completed CSV file.
  2. Click Import.
  3. The system will display a field-matching screen. This allows you to confirm column mappings if you did not use the example template.
  4. Scroll to the bottom and confirm the import.

Import Processing and Notifications

  • Imports run in the background, it can take anywhere from a few seconds to a few minutes to complete depending on the number of products being imported.
  • When finished, you will be notified via the notification bell in the top-right corner.

Import Errors

If any rows fail validation:

  • The import will still complete for valid rows.
  • An error file will be provided for download.
  • This file explains what went wrong (for example, missing product names).

Viewing Imported Products

Once imported:

  • Products will appear in your Products list.
  • You can edit and prepare for review the product information at any time.

Managing Your Product Catalog

Searching and filtering products

The product catalog includes search and filter tools to help you quickly find the products you need to manage. You can use search and filters together to narrow down your product list effectively.

Searching for products

The search box at the top of the product list allows you to quickly find products by entering text that matches:

  • SKU - Search by your product's Stock Keeping Unit (e.g., "ABC-123")
  • Product Name - Search by the product name (e.g., "wooden chair")
  • Category Type - Search by category name (e.g., "furniture")

Simply type your search term into the search box and the results will update automatically as you type. The search looks for matches across all three fields, so you don't need to specify which field you're searching.

Example: If you type "chair", you'll see all products with "chair" in their name, SKU, or category type.

Filtering products

Filters allow you to narrow down your product list based on specific criteria. You can filter products by:

  • Distribution Centres - Show only products assigned to specific distribution centres
  • Sites - Display products that are available (or not available) on specific Curosa websites
  • Category Type - Filter by product category
  • Your Status - Filter by your workflow status (Draft, Ready for Review, etc.)
  • Platform Status - Filter by platform status (Inactive, Active, Declined)
  • Images - Show products that have images uploaded or products that are missing images

To apply filters:

  1. Click on the filter icon or filter dropdown (usually located near the search box)
  2. Select the filter criteria you want to apply
  3. The product list will update to show only products matching your selected filters
  4. You can apply multiple filters at once to further narrow your results

Tip: Use filters to quickly find products that need attention. For example, filter by "No Images" to see which products still need images uploaded, or filter by "Draft" status to see products you're still working on.

Combining search and filters

Search and filters work together seamlessly. You can:

  • Search for a specific product name, then apply filters to narrow down the results
  • Apply filters first to show a subset of products, then use search to find specific items within that filtered list
  • Clear individual filters or reset all filters to start fresh

This combination makes it easy to manage large product catalogs efficiently.

Creating custom views

Custom views allow you to save your favorite search and filter combinations, making it quick and easy to return to specific product lists without recreating your filters each time. This is especially useful for frequently accessed product sets or specific workflows.

Predefined views

The product catalog comes with four predefined views that you can use immediately:

  • All Products - Shows your complete product catalog
  • Active - Displays only products with Active platform status
  • Pending Approval - Shows products that are ready for review or awaiting approval
  • Not Active - Displays products that are currently inactive

Creating a custom view

To create a custom view based on your current search and filter settings:

  1. Apply your desired search terms and filters to the product list

  2. Once you have the product list showing what you want, click the + (plus) icon above the filter options

  3. A dialog will appear where you can configure your custom view:

    • Name - Give your custom view a descriptive name (e.g., "Furniture Without Images" or "Ready for Site A")
    • Icon (optional) - Choose an icon to display on the view tab for quick visual identification
    • Color (optional) - Select a color for the view tab to help organize your views
    • Add to Favorites - When enabled, this view will appear in the main view selector alongside the predefined views for quick access
    • Make Public - When enabled, this custom view will be visible to all users in your company, allowing team members to use your saved views
  4. Click Save to create your custom view

Using custom views

Once created, custom views appear as tabs or options in the view selector:

  • Favorite views appear alongside the predefined views for quick access
  • Non-favorite views are available in your personal views section
  • Public views are accessible to all team members and appear in their view options

You can switch between views at any time by selecting them from the view selector. Each view remembers its search terms, filters, and any other settings you had configured.

Tip: Create custom views for common workflows. For example:

  • "Products Needing Images" - Filter by "No Images" status
  • "Draft Products" - Filter by "Draft" status
  • "Products on Site A" - Filter by a specific site
  • "High Priority Reviews" - Combine multiple filters for products that need immediate attention

This saves time and ensures consistency when working with your product catalog.

Bulk actions

Bulk actions allow you to manage multiple products at once, saving time when you need to make the same change to many products. This is especially useful when setting up new products or updating existing ones across your catalog.

How to use bulk actions

  1. Navigate to the Products listing page
  2. Select the products you want to manage by clicking the checkbox next to each product
    • Use the checkbox in the table header to select all products on the current page
    • You can select products across multiple pages if needed
  3. A toolbar will appear at the top of the product list showing available bulk actions
  4. Click on the action you want to perform
  5. Follow the prompts to complete the action

Available bulk actions

Distribution Centre Management

  • Add to distribution centre - Assign selected products to a specific distribution centre for stock management
  • Remove from distribution centre - Remove selected products from a distribution centre

Site Management

  • Add to site(s) - Make selected products available on one or more Curosa websites. You'll be able to choose which sites to add them to
  • Remove from site(s) - Remove selected products from one or more websites. This will hide them from those sites

Status Updates

  • Update status - Change the status (Draft, Ready for Review, etc.) for all selected products at once

Variants

  • Group as Variants - Allows you to group the selected products together as variants of each other. You select the group type.

Tip: Bulk actions are processed immediately. If you need to undo a bulk action, you'll need to select the same products again and perform the opposite action. For example, if you accidentally added products to a site, select them again and use "Remove from site(s)" to undo it.

Adding products to a site individually

Once you've created a product, you'll want to choose which Curosa websites it should appear on. You can manage product sites in two ways:

  • Individual management - Add or remove products from sites one at a time from the product details page
  • Bulk management - Manage multiple products across sites at once from the product catalog page (see the bulk actions guide above)

Managing sites for a single product

To add or remove a product from specific websites:

  1. Open the product details page for the product you want to manage
  2. Navigate to the Sites section
  3. You'll see a list of all available Curosa websites

For each site, you can:

  • Add the product - Click the green tick (✓) icon to add the product to that website
  • Remove the product - Click the red cross (✗) icon to remove the product from that website
  • Check status - View the current status (e.g., Inactive, Active) displayed next to each site name

Tip: Products must be added to at least one site before they can be reviewed and published. Make sure to add your product to all relevant websites where you want it to appear.

Product Status

Products have two independent status systems that work together to control visibility and workflow: Platform Status (managed by the review process) and Your Status (managed by you). Understanding how these work together helps you manage your products effectively.

Platform Status

Platform Status is controlled by the content review process and determines whether your product can appear on Curosa websites. This status is managed by the platform and changes automatically based on the review workflow.

Status options:

  • Inactive (default for new products) - Product will not appear on any website. This is the starting status for all new products until they go through the review process.
  • Pending - Product has been submitted for review but will not appear on any website until the review process has completed. The product is waiting for content review by the marketing team.
  • Active (Pending Review) - Product is awaiting content review but is still available for sale. This status allows the product to be sold while the review is in progress.
  • Active - Product has passed content review and is fully published. The product is live and visible on the websites where it's been added.
  • Declined - Product did not pass content review. You'll need to address the feedback and resubmit for review.

How Platform Status works:

  • New products start as Inactive by default
  • When you change your status to "Ready for Review" and submit, the Platform Status changes to Pending
  • After review, products move to Active or Declined based on the review outcome
  • See the content review process documentation for detailed information about the review workflow

Your Status

Your Status is controlled by you and reflects your own workflow and readiness. This is your way of managing products independently of the review process.

Status options:

  • Draft (default for new products) - You're still working on product content. The product isn't ready for review by the marketing team. Use this status while you're adding images, descriptions, pricing, and other details.
  • Active - You are satisfied with the product and ready for it to be sold. When set to Active, the product can proceed through the review process (if needed) and become available for sale.
  • Inactive - Temporarily takes the product offline. This is useful when you need to pause sales temporarily (e.g., out of stock, seasonal products, or temporary issues). You can change it back to Active without requiring a new review process if the product was previously live.
  • Discontinued - Marks the product for permanent removal. The product will be removed from websites after there is no further stock available in the distribution centres for that site. Use this when a product is being permanently phased out.

How Your Status works:

  • Set products to Draft while you're still working on them
  • Change to Active when you're ready for the product to go through review and be sold
  • Use Inactive to temporarily pause sales without going through review again
  • Set to Discontinued when permanently removing a product from your catalog

Tip: Your Status and Platform Status work independently. For example, you can have a product with "Your Status: Active" but "Platform Status: Declined" if it needs content changes. Or "Your Status: Inactive" but "Platform Status: Active" if you temporarily pause a live product.