Module
Products
Products are the foundation of PassportBox. Every Digital Product Passport must be attached to a product record. This page explains how to create, manage, and search your product catalog, and covers field requirements, plan limits, and common issues.
Purpose
A product record represents a single SKU in your catalog. It stores the core identity information — name, SKU, category, description — and acts as the anchor for all compliance data exposed through passports. Think of it as the source-of-truth row that passports, labels, and scan analytics all reference.
When to Use
You are onboarding a new SKU that will receive a Digital Product Passport.
You need to update the name, category, or description of an existing item.
You want to associate a supplier or materials list with a catalog entry.
You are preparing a product for CSV or Shopify import.
You need to delete a discontinued product that has no active passports.
Prerequisites
An active PassportBox subscription (Starter plan or above).
The SKU you intend to create must be unique within your account.
To associate a supplier, that supplier must already exist in the Suppliers module.
Creating a Product
Route: /dashboard/products/new
- 1.Navigate to Products in the left sidebar, then click "New Product".
- 2.Enter a product name. This is a required field and will appear in passport headers and labels.
- 3.Enter a unique SKU. SKUs cannot be reused within the same account, even after deletion.
- 4.Select a category from the dropdown (e.g. Apparel, Electronics, Furniture).
- 5.Add a product description. This is optional but recommended for compliance completeness.
- 6.Optionally attach a supplier by selecting from the Supplier dropdown. Only saved suppliers appear here.
- 7.Optionally add a materials list and sustainability attributes in the expanded fields.
- 8.Click "Create Product". You will be redirected to the product detail page.
Editing a Product
Route: /dashboard/products/[id]
- 1.Open the product by clicking its name in the Products list.
- 2.Click "Edit" in the top-right corner of the product detail view.
- 3.Modify any fields: name, category, description, supplier, materials, or sustainability attributes.
- 4.Click "Save Changes". All associated passports will reflect updated product data on their next view.
Changing a product's SKU after passports have been published is not recommended. Existing GS1 Digital Links reference the SKU. If you must change it, contact support.
Deleting a Product
- 1.Open the product detail page.
- 2.Click the "..." menu in the top-right corner and select "Delete Product".
- 3.A confirmation dialog will appear listing any passports associated with this product.
- 4.Type the product name to confirm, then click "Delete".
Deleting a product permanently removes it and breaks the association with any attached passports. Associated passports are not deleted automatically but will show a missing-product warning. Published passports with an active GS1 Digital Link cannot be deleted until they are unpublished first.
Fields Reference
| Field | Required | Notes |
|---|---|---|
| Name | Yes | Display name shown in passports and labels. Max 255 characters. |
| SKU | Yes | Must be unique per account. Alphanumeric, hyphens, and underscores allowed. |
| Category | No | Predefined list (Apparel, Electronics, Furniture, etc.). Used for filtering. |
| Description | No | Free-text description shown on the public passport page. Recommended for compliance. |
| Supplier | No | Associates a saved supplier record. Required for passports that include supply chain data. |
| Materials | No | Structured list of material name and percentage. Values must sum to 100% if provided. |
| Sustainability attributes | No | Key-value pairs (e.g. Recycled content: 40%). Contributes to passport compliance score. |
Plan Limits
| Plan | Product Limit | Notes |
|---|---|---|
| Starter | 10 products | Suitable for small collections. Upgrade to add more. |
| Growth | 100 products | Covers most growing brands. CSV import available. |
| Enterprise | Unlimited | Full catalog support with Shopify sync and bulk operations. |
To check your current usage, go to Billing. To upgrade, visit your plan settings.
Product Catalog and Search
Route: /dashboard/products
The product catalog lists all products in your account. You can search by name or SKU using the search bar at the top of the list. Search is case-insensitive and matches partial values.
The list shows each product's name, SKU, category, associated supplier (if any), and the number of passports attached. Click any row to open the product detail view.
To filter by category, use the category dropdown next to the search bar. Filters and search can be combined.
Validation Rules and Edge Cases
| Rule | Behavior |
|---|---|
| Duplicate SKU | The form will block submission with an inline error: "SKU already exists". Each SKU must be unique per account. |
| Name required | Submitting without a name returns a validation error. The field is highlighted in red. |
| Materials must sum to 100% | If a materials list is provided, the percentage values must total exactly 100%. A running total is shown as you type. |
| SKU characters | Only alphanumeric characters, hyphens, and underscores are accepted. Spaces and special characters are rejected. |
| Plan limit reached | The "New Product" button is disabled when the plan limit is reached. A banner links to the upgrade page. |
| Delete with active passports | The delete confirmation dialog lists all attached passports. You must unpublish any published passports before the delete is allowed. |
What Success Looks Like
The product appears in the catalog list with its name, SKU, and category visible.
No validation errors are shown on the product detail page.
The product is selectable when creating a new passport.
If a supplier was attached, the supplier name appears on the product detail page with its verification status.
The product count in the plan usage meter increments by one.
Troubleshooting
I see "SKU already exists" but I cannot find the duplicate.
SKUs from previously imported or deleted products may be cached. Use the search bar to search for the exact SKU string. If no result appears, contact support — the SKU may exist in a soft-deleted state.
I cannot delete a product.
Products with one or more published passports cannot be deleted until those passports are unpublished. Open each passport from the product detail page, unpublish it, then retry the delete.
The "New Product" button is greyed out.
You have reached your plan's product limit. Upgrade your plan or delete unused products to free up capacity. See the Plan Limits section above.
My supplier does not appear in the supplier dropdown.
Only suppliers that have been saved in the Suppliers module appear in the dropdown. Go to Suppliers, create the supplier, then return to the product form and refresh the page.
A product I edited does not reflect the new data in the passport.
Passport pages pull the latest product data on load. Hard-refresh the passport page (Ctrl+Shift+R or Cmd+Shift+R). If the data is still stale, wait up to 60 seconds for the cache to expire, then reload.