Documentation Portal

The Packaging Options feature enhances the checkout experience by offering customers a choice of packaging for their orders. This capability caters to diverse customer preferences, including eco-friendly and premium packaging options, while aligning with Merchant branding and values.

Merchants can strengthen their brand image by offering premium and sustainable packaging choices. Customers can select a packaging option that aligns with their preferences or gifting needs. Packaging options encourage eco-conscious decisions with an eco-friendly packaging option, appealing to environmentally aware shoppers.

Merchants can customize choices, configuring packaging titles, descriptions, and accompanying images for each option. Packaging options are free of charge in the current phase.

Availability can be localized. Merchants can enable or disable packaging options by country to meet regional requirements. Further, the packaging options are dynamically excluded if the order consists solely of virtual products. Packaging selections are captured in purchase event analytics, providing valuable data on customer preferences and adoption rates.

Customer Journey

Enablement

Merchants can activate this feature and define packaging options through a new configuration setting. Merchants can selectively disable the feature for specific countries where packaging options may not be relevant or feasible.

Examples

Sustainability Campaigns: Brands promoting eco-friendly initiatives can highlight the "Eco Packaging" option to align with their green goals.

Luxury Shopping Experience: Premium brands can offer "Signature Packaging" to enhance their high-end image.

Gift Wrapping

Customers can request gift wrapping for their orders on the Checkout page.

In the Gift Wrapping section is a checkbox that customers can select if they wish to have their order wrapped.

When the gift-wrapping option is selected, a text box appears, allowing customers to enter a personalized message.

Note

If the gift-wrapping option is selected, the customer comments text box is disabled and no longer available.

Sustainable Packaging Options in Classic Checkout

Note: I put the following original content in Preview in the event that somebody wants a "roll-back".

Merchants can offer customers the option to select between default or eco-friendly packaging for their order at checkout.

• The customer's packaging selection is confirmed in the billing summary and confirmation email.

• If the customer does not make any package selection, the first option is pre-selected as default.

• If an order only includes virtual products, the package option section is not displayed.

Merchants can strengthen their brand image by offering premium and sustainable packaging choices. Customers may select packaging options that align with their preferences or gifting needs, including eco-friendly packaging to appeal to environmentally conscious shoppers.

Merchants can offer customers the option to select between default or eco-friendly packaging for their order at checkout.

Selecting a Packaging Option in Checkout

Customers can choose their preferred packaging during checkout. The following steps describe how to view and select a packaging option before completing an order.

To select a packaging option in Checkout

1. Navigate to the checkout page.

   A new section titled Packaging Options appears under Shipping, unless the cart contains only virtual products.

2. Select one of the available packaging options:

   • Eco Packaging – Uses fewer materials and has less impact on the environment.

   • Signature Packaging – Delivered in the merchant’s signature packaging, reflecting the brand’s commitment to excellence.

3. Confirm your selection.

   The chosen packaging option is displayed in the billing summary, confirmation page, and confirmation email.

The default packaging option is pre-selected based on store configuration. If no default is defined, the first option is pre-selected.

Configuration and Availability

Merchants can configure which packaging options appear to customers and customize their presentation. The following details outline how the feature behaves and where it applies.

• Packaging options are configured at the merchant and country level.

• Option titles, descriptions, and images are customizable.

• The feature currently supports only free-of-charge packaging (charging for options is planned for a future phase).

• If all items in the order are virtual products, packaging options do not appear.

FAQ

The following common questions address display behavior and future enhancements related to packaging options.

• 1. Will a gift message be shown in the confirmation email or page?
• 2. Do we need to display the gift message or the selected package option in the confirmation page and emails?

1.	Will a gift message be shown in the confirmation email or page?
	Currently, only the packaging option is shown. Future releases may include gift message details.
2.	Do we need to display the gift message or the selected package option in the confirmation page and emails?
	Only the package option is displayed on the confirmation page. In the future, the presentation of the gift message on the confirmation page will be determined. — @Rajaa El Andalousi

Example Configuration

The following is an example configuration in JSON format:

{ "defaultOptionCode": "Eco", "titleTextResourceId": "Checkout.SustainablePackageOptions.Title", "options": [ { "code": "Eco", "sortOrder": 1, "titleTextResourceId": "Versace.Checkout.SustainablePackageOptions.Eco.Title", "descriptionTextResourceId": "Versace.Checkout.SustainablePackageOptions.Eco.Description", "imageUrl": "<eco-img-url>", "billingSummaryTextResourceId": "Checkout.SustainablePackageOptions.Eco.BillingSummaryText" }, { "code": "Signature", "sortOrder": 2, "titleTextResourceId": "Versace.Checkout.SustainablePackageOptions.Signature.Title", "descriptionTextResourceId": "Versace.Checkout.SustainablePackageOptions.Signature.Description", "imageUrl": "<signature-img-url>", "billingSummaryTextResourceId": "Checkout.SustainablePackageOptions.Signature.BillingSummaryText" } ] }