For standard post meta (hand-coded fields):
- Go to WPSyncSheets → Order/Product Settings → Sheet Headers.
- In the “Add Custom Headers from Metadata” dropdown, select your meta key by its exact name (no prefix needed).
- Toggle it on in the headers list.
For ACF (Advanced Custom Fields): ACF-compatible fields are automatically inserted into the Sheet Headers section — they do not appear in the dropdown. Look for them directly in the headers list and toggle them on. Supported ACF field types: https://docs.wpsyncsheets.com/custom-fields-type-lists/#acf-field-type-lists
For MetaBox fields: Update the plugin to the latest version. Supported MetaBox field types: https://docs.wpsyncsheets.com/metabox-field-type-lists/
For Secure Custom Fields (SCF): Contact support — SCF coupon and order fields require a one-time compatibility update for your site, after which they appear in Sheet Headers normally.
For complex or array-indexed meta (e.g., variation-level data): Use the wpssw_custom_headers_for_product and wpssw_custom_values_for_product filters in your functions.php. Example:
php
// Register the custom header in the plugin UI
add_filter( 'wpssw_custom_headers_for_product', function( $headers ) {
$headers[] = 'My Custom Field';
return $headers;
} );
// Supply the value during sync
add_filter( 'wpssw_custom_values_for_product', function( $value, $product_id, $header_name ) {
if ( 'My Custom Field' !== $header_name ) {
return $value;
}
return get_post_meta( $product_id, '_my_meta_key', true );
}, 10, 3 );
Full filter reference: https://docs.wpsyncsheets.com/filters-hooks-snippets/