> ## 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.

# AI Packaging

> Use AI to help create packaging levels from product packaging text

# AI Packaging

AI packaging helps vendors create structured packaging levels from an existing product packaging description.

Use this feature when a product already has packaging text and you want Mathership to turn it into clear levels such as crate, carton, bottle, bag, kg, L, piece, or similar units.

## What it does

AI packaging reads the packaging information of a vendor product and tries to create packaging levels automatically.

Example:

| Packaging text        | Possible structure |
| --------------------- | ------------------ |
| Crate with 12 bottles | Crate → Bottle     |
| Carton with 6 packs   | Carton → Pack      |
| Bag 25 kg             | Bag → kg           |
| Box with 10 pieces    | Box → Piece        |

The result depends on how clear the packaging text is.

## Who can use it?

This feature is available to vendor users.

A vendor can only update packaging levels for products that belong to their own vendor company.

<Warning>
  Vendors cannot update packaging levels for products from another vendor company.
</Warning>

## When to use it

Use this feature when:

* The product already has a packaging description
* You want to create packaging levels faster
* You want Mathership to suggest a structured packaging setup
* The packaging text is simple and clear

It is useful for common product formats such as crates, cartons, bottles, bags, packs, cans, kilograms, liters, and pieces.

## How it works

Mathership checks that:

* The user is logged in
* The user owns the vendor company
* The product belongs to that vendor company
* The product exists
* Packaging information is available for the product

Then Mathership tries to read the packaging text and update the product packaging levels.

## Packaging levels

Packaging levels describe how a product is packaged and ordered.

| Level type  | Example              |
| ----------- | -------------------- |
| Top level   | Carton               |
| Inner level | Bottle               |
| Unit level  | kg, L, piece, bottle |

Example:

| Level | Name   | Meaning                    |
| ----- | ------ | -------------------------- |
| 1     | Crate  | Customer orders one crate  |
| 2     | Bottle | One crate contains bottles |

## Example: Crate with bottles

A vendor has a product with this packaging text:

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

Mathership may create:

| Level  | Quantity |
| ------ | -------: |
| Crate  |        1 |
| Bottle |       12 |

This helps customers understand how the product is packaged and ordered.

## Example: Bag with weight

A vendor has a product with this packaging text:

```txt theme={null}
Bag 25 kg
```

Mathership may create:

| Level | Quantity |
| ----- | -------: |
| Bag   |        1 |
| kg    |       25 |

This can be useful for products where the vendor sells a bag, but the content is measured in kilograms.

## After generation

If generation succeeds, the product receives updated packaging levels.

These levels can then be used in product views, ordering, exports, and other product-related features.

If Mathership cannot understand the packaging text, it does not create a valid packaging setup and returns an error.

## Common reasons generation fails

Generation may fail if:

* The product does not exist
* The product belongs to another vendor company
* The packaging text is missing
* The packaging text is unclear
* The packaging format cannot be parsed
* The user does not have access to the vendor company

## AI or manual setup?

| Method           | Best for                                             |
| ---------------- | ---------------------------------------------------- |
| AI packaging     | Quickly creating packaging levels from existing text |
| Manual packaging | Exact control over every packaging level             |

Use AI packaging when you want a fast suggestion.

Use manual packaging when the packaging structure is complex or must be entered very precisely.

## Best practices

### Use clear packaging descriptions

AI packaging works best when the packaging text is simple and specific.

Good examples:

* Crate with 12 bottles
* Box with 10 packs
* Bag 25 kg
* Carton with 6 cans

### Review the result

Always review the generated packaging levels before relying on them for ordering or exports.

### Use manual setup for complex products

If a product has several nested packaging levels, manual setup may be safer.

### Keep product data clean

Clear article names, packaging text, and units make product management easier for vendors and customers.

## Related pages

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

  <Card title="Edit Products" icon="pen-to-square" href="/en/vendors/products/edit-products">
    Update existing product information.
  </Card>

  <Card title="Packaging Levels" icon="boxes-stacked" href="/en/vendors/products/packaging-levels">
    Manage structured packaging levels manually.
  </Card>

  <Card title="Product Images" icon="image" href="/en/vendors/products/product-images">
    Manage product images and automatic image lookup.
  </Card>
</CardGroup>