> ## Documentation Index
> Fetch the complete documentation index at: https://help.mathership.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Overview of vendor product features, adding products, editing products, uploads, availability, images, packaging levels, and AI packaging

# Product Management

The product management chapter explains how vendors create, update, upload, organize, and maintain products in Mathership.

For vendors, product management is built around one main workflow: create a clean product catalog, keep product information up to date, and make products available to connected customers.

## What vendors can manage

### Adding Products

Vendors can add products manually to their catalog.

A product can include:

* Product name
* Product number
* Packaging
* Stock
* Price
* Product description
* Product image

Products belong to one vendor company.

<Warning>
  Vendors can only add products to their own vendor company.
</Warning>

### Edit Products

Vendors can update product data after a product has been created.

Editable product information can include:

* Product name
* Product number
* Packaging
* Stock
* Price
* Product description
* Product image settings

Editing products helps keep the catalog correct when prices, stock values, descriptions, or packaging information change.

### Delete Products

Vendors can delete products from their catalog.

Deleted products are removed from the active product list and are no longer shown like normal available products.

Use this when a product should no longer be offered to customers.

<Note>
  If a product should only be temporarily hidden, changing availability may be better than deleting it.
</Note>

### Availability

Product availability controls whether a product can be treated as available or not available.

Available values are:

| Value          | Meaning                              |
| -------------- | ------------------------------------ |
| available      | Product can be shown as available    |
| not\_available | Product can be marked as unavailable |

This is useful when products are temporarily out of stock, discontinued, seasonal, or not currently orderable.

### Product Images

Vendors can manage product images.

A product image can come from:

* A manually uploaded image
* A stored image URL
* An automatically selected image
* An external product image source, if available

Product images help customers recognize products more easily in the catalog.

### Upload Products

Vendors can upload product data from a CSV file.

This helps vendors create or update products in larger quantities.

Uploaded product data can include:

* Product name
* Product number
* Packaging
* Stock
* Price
* Product description

The upload uses field mapping so Mathership knows which CSV column belongs to which product field.

### Bulk Product Upload

Bulk product upload is used when many products should be imported or updated at once.

The upload can create new products or update existing products when the product number matches an existing product in the vendor company.

The result can include:

* Number of successfully imported rows
* Rows with errors
* Error messages
* Failed row data

<Note>
  A bulk upload can partially succeed. Some rows may be imported while other rows contain errors.
</Note>

### Packaging Levels

Packaging levels describe how a product is packaged and ordered.

Examples:

| Level  | Meaning                                  |
| ------ | ---------------------------------------- |
| Crate  | Customer orders one crate                |
| Bottle | One crate contains bottles               |
| kg     | Product content is measured in kilograms |
| L      | Product content is measured in liters    |

Packaging levels help customers understand whether they are ordering a crate, carton, bottle, bag, piece, kilogram, or liter.

### AI Packaging

AI packaging can help create packaging levels from an existing packaging text.

Example packaging text:

```txt theme={null}
Crate with 12 bottles
```

AI packaging may identify:

| Packaging level | Quantity |
| --------------- | -------: |
| Crate           |        1 |
| Bottle          |       12 |

This can reduce manual work when product packaging is already written in a readable text format.

<Warning>
  AI packaging should be reviewed by the vendor before relying on it for ordering or inventory workflows.
</Warning>

## Typical vendor product workflow

1. Vendor opens the product management section
2. Vendor adds products manually or uploads a product file
3. Mathership creates or updates the product catalog
4. Vendor reviews product names, numbers, packaging, stock, and prices
5. Vendor adds or updates product images
6. Vendor checks availability
7. Vendor defines packaging levels if needed
8. Vendor uses AI packaging for suitable products if helpful
9. Connected customers can view and order products from the vendor catalog

## Accessing product features

To access product features:

1. Go to **Vendors**
2. Open the vendor company
3. Open the **Product Management** section
4. Choose the product feature you need

Depending on the interface, product features can include product lists, upload options, image settings, availability controls, and packaging tools.

## Why product management matters

### Better customer ordering

A clean catalog helps customers find and order the right products.

### Clear product information

Product numbers, names, packaging, prices, and descriptions reduce misunderstandings.

### Faster catalog updates

Uploads and bulk uploads help vendors update many products more quickly.

### Better availability control

Availability settings help prevent customers from ordering products that are currently not available.

### Better product recognition

Images help customers recognize products visually.

### More accurate packaging

Packaging levels make order units clearer and can support future inventory or integration workflows.

## Best practices

### Use stable product numbers

Product numbers help Mathership identify products during uploads and updates.

### Keep product names clean

Use clear and consistent product names so customers can find products easily.

### Maintain packaging information

Packaging should describe how the customer orders the product.

### Review uploaded products

After an upload, check that product names, numbers, packaging, stock, and prices were imported correctly.

### Use availability instead of deleting

If a product may return later, mark it as not available instead of deleting it.

### Review AI packaging

AI packaging can save time, but vendors should confirm the result before using it.

### Add product images where useful

Images can make the catalog easier to use, especially for similar products.

## Related pages

<CardGroup cols={2}>
  <Card title="Adding Products" icon="plus" href="/en/vendors/products/add-products">
    Add products manually to the vendor catalog.
  </Card>

  <Card title="Edit Products" icon="pen-to-square" href="/en/vendors/products/edit-products">
    Update product names, numbers, prices, stock, packaging, descriptions, and images.
  </Card>

  <Card title="Delete Products" icon="trash" href="/en/vendors/products/delete-products">
    Remove products from the active vendor catalog.
  </Card>

  <Card title="Upload Products" icon="file-arrow-up" href="/en/vendors/products/upload-products">
    Upload product data from a CSV file.
  </Card>

  <Card title="Bulk Product Upload" icon="upload" href="/en/vendors/products/bulk-upload">
    Import or update many products at once.
  </Card>

  <Card title="Availability" icon="toggle-on" href="/en/vendors/products/availability">
    Mark products as available or not available.
  </Card>

  <Card title="Product Images" icon="image" href="/en/vendors/products/product-images">
    Add, update, or manage product images.
  </Card>

  <Card title="Packaging Levels" icon="boxes-stacked" href="/en/vendors/products/packaging-levels">
    Define how products are packaged and ordered.
  </Card>

  <Card title="AI Packaging" icon="wand-magic-sparkles" href="/en/vendors/products/ai-packaging">
    Generate packaging levels from packaging text.
  </Card>
</CardGroup>
