Beginning with WooCommerce 10.2, the Cart Cross-Sells block will be soft-deprecated in favor of the Product Collection block’s Cross-Sells collection. The legacy block offered limited customization and inconsistent styling, while the Product Collection block provides greater flexibility, modern design options, and long-term support. Although existing stores can continue using Cart Cross-sells, the block will no longer appear in the inserter, and new stores will default to the Product Collection Cross-sells.
The details
The Cart Cross-sells block was limited in scope: merchants could only adjust the number of products shown, styling options were restricted, and layouts often didn’t behave as expected. In contrast, the Product Collection Cross-sells block allows for inner blocks, more consistent design, and alignment with WooCommerce’s newer Interactivity API architecture. This move ensures a more cohesive and modern block experience across the platform.
Existing Cart Cross-sells implementations are not being removed. Instead, store owners and developers will see an option to transform them into the new Product Collection version. For new stores or whenever the Cart block is added, the Cross-Sells collection will automatically be powered by Product Collection.
How can I tell if this affects me?
You may be affected if you’ve added a Cart Cross-sells block to the Cart. In the editor, this appears as a standalone “Cart Cross-sells” block. Starting with WooCommerce 10.2, that block will not appear in the inserter for new usage, though existing implementations will continue to function. If you insert a new Cart block, you’ll notice that Cross-sells are provided by the Product Collection block instead.
What action should I take?
No immediate action is required. Current stores using Cart Cross-sells will keep working. However, we recommend migrating to the Product Collection Cross-sells block, either by using the built-in transform option or by replacing the block directly. Developers maintaining custom themes or extensions that reference Cart Cross-sells should also update their code to work with Product Collection going forward.
The soft deprecation begins in WooCommerce 10.2. A final removal date will be shared in a future release cycle.
Leave a Reply