Skip to main content

Package editor

Routes: /org/ecom/packages/new and /org/ecom/packages/:packageId/edit Permissions: Create new Product Packages records · Edit existing Product Packages records


1. What the editor does​

Defines what a package contains, what it costs, and how it appears on the storefront. It is the largest authoring screen in the category.


2. What a package pulls together​


3. The editor​

Figure 1 — Creating a package.

4. Field reference​

The editor collects the package's identity, its contents drawn from Inventory products, pricing, and the media and copy its storefront page renders.

Contents are references, not copies

A package points at products. Change a product in Inventory and every package containing it reflects that — which is the point, and the reason a product's availability decides a package's.


5. The admin contract​

PrerequisiteWithout it
Create new Product Packages records / .editThe routes are not reachable
ProductsNothing to add
A currencyNo price

6. Downstream​

A saved package is immediately sellable wherever packages appear.


7. Don't confuse this with…​

ThingWhy it differs
Package editor (this page)The bundle definition
Package detail pageIts storefront page
Product editorInventory

8. Troubleshooting​

SymptomCause
Cannot open the editorMissing create or edit permission
A product is missingCheck it exists and is sellable in Inventory
Price looks wrongPackage pricing is its own, not the sum of parts