Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

Packages and bundles (UI)

Create and manage packages, dynamic packages, and bundles in a catalog.

In Optimizely Commerce Connect, a package is a fixed bundle. It contains one or more variants, other packages, or both, sold as a single unit. The contents are pre-configured and the customer has no choice over the components.

  • Has a unique SKU and a single price.
  • Displays as a single line item in the shopping cart.
  • The Package Entries page shows the specific variants and packages that make it up. Example: a shirt and hat combination wrapped and sold as one unit.

A dynamic package (beta) is a content type extended from a package, but with one key difference: it contains products (each with one or more variants), letting you select which variant you want for each product included in the package.

  • Also has a unique SKU and a single price.
  • Also displays as a single line item in the shopping cart.
  • The Package Entries page shows the products and their available variants. When adding a dynamic package to an order, change the selected variant through a drop-down list. Example: a package containing a shirt and a hat where the customer can choose their preferred size or color for each item.

A bundle is a collection of packages, products, and variants priced individually, letting customers purchase several items at once. Each item in a bundle is a separate line item in a shopping cart. When added to a cart, a bundle item is treated like any other cart item.

View packages and bundles on the catalog list page.

Screenshot of packages and bundles in the Commerce Connect catalog list page.

Create a package

A package is a catalog entry that groups multiple products or variants together for sale as a single unit. Use packages to sell curated sets, bundled accessories, or multi-item promotions without creating a separate product record for the combination.

  1. In the Catalogs tree, go to the category where you want to create the package. Click the context menu next to the category name, then click New > Package.

    Screenshot of the category context menu showing the New Package option in the Catalogs tree.
  2. In the Please Note window, enter a descriptive name for the package in the Name field (for example, Shirt package) and click OK.

    Screenshot of the Please Note naming window for a new package in Commerce Connect.

    The package opens in the editor, showing an empty Package Entries table.

  3. Select Group > Package Entries to focus on those properties.

    📘

    Note

    Like other catalog entries, packages have properties. Because packages have an SKU and price, they also have Pricing and Inventory sections.

    Screenshot of the Package Entries group selected in the editor showing package properties.
  4. Click Edit entries. The Edit Package page opens.

    Screenshot of the Edit Package page in Commerce Connect.
  5. Click + Add Entry. The Add Entry window opens, displaying products and variants from the catalog.

  6. Select the variants or products to include in the package. In this example, select one or more Short Sleeve Polo variants, then click Add.

    Screenshot of the Add Entry window showing Short Sleeve Polo variants selected for inclusion in a package.

  7. Repeat steps to add additional entries. In this example, Graphic Tee and Beefy-T Short Sleeve Tee were added.

  8. To remove an entry, click the Delete icon (🗑) in that row.

  9. When all entries are added and quantities are set, click Back to return to the package. Changes are published immediately as you edit.

The banner at the top of the Edit Package page reads Changes made here will be published immediately while you edit. Review all entries and quantities before making changes on a live storefront.

Create a dynamic package (beta)

When creating a dynamic package, add the following:

  • Add a product, including all product variant relations.
  • Add a variant and any product relations to that variant.
📘

Note

An administrator can remove an entire product or a variant from the Package Entries list. A product cannot exist without a variant inside.

When adding a dynamic package to an order, change the selected variant using the drop-down list.

When you place an order, Commerce Connect recalculates the quantity of dynamic packages and variants. Commerce Connect also lists a dynamic package as a single line item for returns.

Screenshot of a dynamic package showing variant selection in a drop-down list.

Create a bundle

A bundle is a catalog entry that groups products together for sale as a set, where the customer receives all included items as part of a single purchase. Unlike a package, a bundle typically presents its contents as a curated collection where each item retains its individual identity. Use bundles to offer complementary products together, such as a clothing outfit or a coordinated accessories set.

Because bundles do not have an SKU or price, they do not have sections for pricing and inventory. Associate bundle entries with entry groups as you can with packages.

  1. In the Catalogs tree, go to the category where you want to create the bundle. Click + in the toolbar, then click Bundle.

    Screenshot of the toolbar Bundle option when creating a new catalog entry.
  2. In the Please Note window, enter a descriptive name for the bundle in the Name field (for example, Clothing Bundle) and click OK.

    Screenshot of the Please Note naming window for a new bundle in Commerce Connect.

    The bundle opens in the editor. If entries have already been added, they display in the Bundle Entries table.

    Screenshot of the Bundle Entries table in the Commerce Connect editor.
  3. Click Edit entries. The Edit Bundle window displays.

    Screenshot of the Edit Bundle window in Commerce Connect.
  4. Click + Add Entry. The Add Entry window opens, displaying products and variants from the catalog organized by category.

    Screenshot of the Add Entry window displaying products and variants grouped by category.

  5. Expand a category to browse its products and variants. Select the item to include in the bundle (for example, Aurielle-Carryland Mariposa Tote), then click Add.

  6. Repeat steps 4 and 5 to add additional entries until the bundle contains all required items.

  7. To remove an entry, click the Delete icon (🗑) in that row.

  8. When all entries are added and quantities are set, click Back to return to the bundle. Changes are published immediately as you edit.

    Screenshot of a completed bundle showing all added entries in Commerce Connect.

Delete a package or bundle

❗️

Warning

If you delete a package or bundle, all links to it from related products and variants are removed. You cannot recover a package or bundle after it is deleted.

  1. Open the item's context menu.
  2. Click Delete.
  3. Click Delete to confirm.

To delete multiple catalog entries at once, select them from the item list, and click Delete from the toolbar.

How the Campaigns feature considers packages and bundles

The Campaigns feature treats a package like any other SKU. Because a package has its own price and quantity, any reductions are made to the package. The Campaigns feature ignores the individual items in a package.

The Campaigns feature does not recognize bundles. It only recognizes the individual SKUs that make up a bundle.