Commerce Core 3.1.0 is now available with 21 resolved issues, including improvements to the checkout completion page and a fix for a longstanding normalization bug that affected JSON:API integrations.

Checkout completion page improvements

We've updated the checkout completion page to provide customers with more detailed order information. Previously, the page displayed only a configurable message with the order number and a link to view the order.

The completion page now displays checkout pane summaries (the same information visible on the review page) and enables the sidebar by default, which shows the order summary including line items and pricing details. This provides customers with immediate confirmation of their order contents, eliminating the need for additional navigation.

Order adjustment serialization fix

We've resolved a long-standing issue where order adjustments couldn't be normalized and serialized. This issue affected developers building headless commerce implementations or working with API integrations. Orders can now be successfully retrieved through JSON:API endpoints without triggering serialization errors.

Administrative interface improvements

The checkout flow configuration form now displays the "Default step" property for checkout panes, allowing panes to provide admin descriptions. These descriptions appear directly in the configuration interface, enabling administrators to understand the purpose and configuration options of each pane.

Performance improvements

We've optimized several operations to reduce unnecessary database queries and calculations:

• Adding or removing included adjustments to orders and order items no longer triggers unnecessary recalculations of the order total.
• The Order Refresh service now skips reloading order items from the database when checking for modifications by order processors.

These changes primarily benefit stores with complex pricing logic or high order volumes, especially ones with VAT. Adding a new item to a large cart is now seconds faster than before. The difference between a successful order and an abandoned cart can sometimes be measured in under a second, so this improvement could lead to more revenue for some merchants.

Other notable improvements

• Added translation support for “Buy X, Get Y” promotions
• Added token support for receipt email copies
• Easier theming for the “Login or continue as guest” checkout pane
• Manual payments can now be negative

Upgrade information

Commerce Core 3.1.0 requires Drupal 10.3+ or Drupal 11. Be sure to test upgrades in development environments before updating your production sites. View the release notes for technical details on all resolved issues.

This release includes contributions from 34 community members. Thank you!