WPC Product Options Order Metadata Compatibility

An unofficial compatibility shim for WPC Product Options for WooCommerce.

WPC Product Options stores option data in its private order-item metadata, including _wpcpo_options_v2. That is fine for WPCPO's own rendering, but it can leave third-party integrations that expect standard WooCommerce line-item metadata unable to read customer-selected options.

This plugin fixes that by copying recognized non-file WPCPO options into ordinary WooCommerce order-item metadata on newly created orders. It keeps _wpcpo_options_v2 untouched, so WPCPO's own internals and renderers can continue to use it.

The original WordPress support thread documenting the regression is here: Product options not being saved in order metadata from 2.1.0. The current upstream plugin version is 4.0.3, which still does not announce a fix for this metadata behavior.

What it does

• Adds public WooCommerce order-item metadata for recognized WPCPO option values.
• Leaves WPCPO's private _wpcpo_options_v2 data unchanged.
• Skips unknown option structures instead of guessing.
• Keeps file-upload options under WPCPO's own handling.
• Avoids exact duplicate public metadata.
• Suppresses duplicate rendering when public metadata already exists.

Installation

1. Back up your site first and test on staging before using this on production.
2. Upload the wpcpo-order-metadata-compatibility folder to wp-content/plugins/.
3. Or install the ZIP through WordPress Admin > Plugins > Add New Plugin > Upload Plugin.
4. Activate the plugin.
5. Create a new test order and confirm the selected options appear as normal WooCommerce metadata.

Notes

• This affects only new orders created after activation.
• Existing orders are not migrated.
• This is an unofficial compatibility plugin, not an official WPC Product Options release.
• The original investigation and implementation were developed with substantial assistance from ChatGPT / AI.
• Tested with WPC Product Options 4.0.3.

Release

Version: 1.0.0