Packaging Levels Packaging levels describe how a product is packaged.
They help customers understand what they are ordering and how many units are inside a larger package.
What they are A packaging level is one layer of a product package.
Examples:
Product Structure Crate of bottles Crate → Bottle Box of tomatoes Box → kg Carton of cans Carton → Can Bag of flour Bag → kg
These structures make product quantities clearer.
Why they matter Customers often order one large package, but the product may contain smaller units.
Example:
Ordered unit Contains 1 crate 12 bottles 1 box 10 kg 1 carton 24 cans
This helps avoid misunderstandings between vendor and customer.
Typical structure A product can have one or more levels.
Level Meaning Top level Main package the customer orders Inner level Smaller unit inside the main package Unit level Base unit such as kg, L, piece, bottle, or can
Example:
Level Name Meaning 1 Crate Customer orders one crate 2 Bottle One crate contains bottles
Example: Crate with bottles A vendor sells water as a crate with 12 bottles.
Level Quantity Crate 1 Bottle 12
The customer sees that one ordered crate contains bottles.
Example: Bag with weight A vendor sells flour as a 25 kg bag.
This is useful when the product is ordered as a bag, but the content is measured in kilograms.
Manual setup Vendors can define the structure manually.
Manual setup is useful when:
The product packaging is special
The automatic result is not correct
The product has several package layers
The package contains a fixed number of units
The product should be shown more clearly to customers
AI packaging Mathership can also try to create the structure automatically from the packaging text.
Example packaging text:
Mathership may detect:
Level Quantity Crate 1 Bottle 12
AI packaging can help create packaging levels faster, but vendors should review the result.
Fields Packaging setup can include information such as:
Field Meaning Name Name of the level Quantity per parent How many units are inside the parent level Order Position of the level Unit code Optional unit such as kg, L, piece, or bottle
The exact fields shown can depend on the user interface.
Quantity per parent Quantity per parent describes how many smaller units belong to the level above.
Example:
Parent level Child level Quantity per parent Crate Bottle 12 Box kg 10 Carton Can 24
This means one parent package contains the given number of child units.
Order of levels The order defines the hierarchy.
The top level normally has the first position.
Example:
This means the product is ordered as a crate, and bottles are inside the crate.
When to use them Use packaging levels when:
Customers need to understand package contents
Products are sold in crates, boxes, cartons, bags, or cases
A package contains smaller units
The product should later be mapped to inventory
Order exports should include clearer packaging information
In orders When customers order products, the structure helps explain what the ordered quantity means.
Example:
Customer orders Meaning 2 crates 2 main packages 2 crates with 12 bottles each 24 bottles total
This can reduce errors during order processing.
Bulk uploads Bulk uploads can include packaging text.
After upload, package details can be added manually or generated with AI packaging.
This allows vendors to upload products first and refine packaging details later.
Inventory mapping Packaging levels can support product-to-ingredient mapping.
Example:
Vendor product Package content Internal ingredient 1 box tomatoes 10 kg Tomatoes 1 crate milk bottles 12 bottles Milk
This helps convert vendor products into internal stock units.
Typical workflow
Open your vendor company
Go to Products
Open a product
Review the packaging text
Add or update the package structure
Save the product
Check how the product appears to customers
Example: Add levels manually Step Action 1 Open the product 2 Add top level, such as crate or box 3 Add inner level, such as bottle or kg 4 Enter the quantity per parent 5 Save the setup
Example: Use AI first, then review Step Action 1 Open the product 2 Run AI packaging 3 Review the detected levels 4 Correct names or quantities if needed 5 Save the final setup
Common problems Structure looks wrong Check that:
The level names are correct
The quantity per parent is correct
The order of levels is correct
The packaging text is not misleading
Customer does not understand the product Add clearer package details or improve the product packaging text.
Example:
Unclear Clearer Box Box, 10 kg Crate Crate, 12 bottles
AI created the wrong result Edit the levels manually.
AI results should be reviewed before relying on them.
Quantity is unclear Check whether the quantity describes:
The number of ordered packages
The number of units inside a package
A weight or volume
A piece count
Best practices Keep names simple Use names customers understand, such as crate, box, bottle, can, bag, kg, or L.
Use consistent units Avoid mixing different unit names for the same meaning.
Example:
Less consistent More consistent kilogram, kilo, kg kg liter, litre, L L
Review AI results AI packaging can save time, but it should not replace a final vendor check.
Match real ordering The top level should match what the customer actually orders.
Keep product text and structure aligned If the product says “crate with 12 bottles”, the levels should show the same structure.
Related pages
AI Packaging Generate packaging levels from product packaging text.
Adding Products Add new products to the vendor catalog.
Edit Products Update product names, prices, stock, packaging, and images.
Bulk Product Upload Upload or update many products at once.
Product Images Manage product images and image sources.
Product Mapping Connect vendor products to internal ingredients.
