Fix missing field shippingDetails & hasMerchantReturnPolicy

In April 2023, Google announced an update regarding the “shippingDetails” and “hasMerchantReturnPolicy” fields on the Google Search Console, focusing on shipping information and return policy.

If you are receiving warning errors like ‘Missing field “hasMerchantReturnPolicy” (in “offers”)’ or ‘Missing field shippingDetails (under “offers”)’, then this article from ItsmeIT will guide you on how to fix shippingDetails and deliveryTime errors, as well as hasMerchantReturnPolicy for sites using WordPress.

How to fix missing field shippingDetails, deliveryTime and hasMerchantReturnPolicy Wordpress

Warning error information (Rich snippet product)

The warning regarding the “shippingDetails” field applies to sellers in the US region. If you are verified as a seller in the US region or do not sell in the US, you can ignore this warning. ( Reference ).

How to fix errors with Rankmath SEO

If you are using the Rankmath SEO plugin, you can add the following code to your functions.php file in order to fix missing field shippingDetails or “hasMerchantReturnPolicy” are missing under “offers”.

add_filter( "rank_math/snippet/rich_snippet_product_entity", function( $entity ) {
    // Return policy
    $entity['offers']['hasMerchantReturnPolicy']['@type'] = 'MerchantReturnPolicy';
    $entity['offers']['hasMerchantReturnPolicy']['applicableCountry'] = 'VN';
    $entity['offers']['hasMerchantReturnPolicy']['returnPolicyCategory'] = 'https://schema.org/MerchantReturnFiniteReturnWindow';
    $entity['offers']['hasMerchantReturnPolicy']['merchantReturnDays'] = 30;
    $entity['offers']['hasMerchantReturnPolicy']['returnMethod'] = 'https://schema.org/ReturnByMail';
    $entity['offers']['hasMerchantReturnPolicy']['returnFees'] = 'https://schema.org/FreeReturn';

    // Shipping details
    $entity['offers']['shippingDetails']['@type'] = 'OfferShippingDetails';
    $entity['offers']['shippingDetails']['shippingRate']['@type'] = 'MonetaryAmount';
    $entity['offers']['shippingDetails']['shippingRate']['value'] = 5;
    $entity['offers']['shippingDetails']['shippingRate']['currency'] = 'VND'; //You currency
    $entity['offers']['shippingDetails']['shippingDestination']['@type'] = 'DefinedRegion';
    $entity['offers']['shippingDetails']['shippingDestination']['addressCountry'] = 'VN';

    //deliveryTime
    $entity['offers']['shippingDetails']['deliveryTime']['@type'] = 'ShippingDeliveryTime';
    $entity['offers']['shippingDetails']['deliveryTime']['handlingTime']['@type'] = 'QuantitativeValue';
    $entity['offers']['shippingDetails']['deliveryTime']['handlingTime']['minValue'] = '0';
    $entity['offers']['shippingDetails']['deliveryTime']['handlingTime']['maxValue'] = '1';
    $entity['offers']['shippingDetails']['deliveryTime']['handlingTime']['unitCode'] = 'DAY';

    $entity['offers']['shippingDetails']['deliveryTime']['transitTime']['@type'] = 'QuantitativeValue';
    $entity['offers']['shippingDetails']['deliveryTime']['transitTime']['minValue'] = '0';
    $entity['offers']['shippingDetails']['deliveryTime']['transitTime']['maxValue'] = '5';
    $entity['offers']['shippingDetails']['deliveryTime']['transitTime']['unitCode'] = 'DAY';

    return $entity;
});

How to fix warning errors with Yoast SEO

Similar to Rankmath, if you are using the Yoast SEO plugin, you can add the following code to your functions.php file to fix the warning errors that the fields “hasMerchantReturnPolicy” or “shippingDetails” are missing under “offers”.

add_filter('wpseo_schema_product', function ($entity) {
            // Return policy
            $entity['offers']['hasMerchantReturnPolicy']['@type'] = 'MerchantReturnPolicy';
            $entity['offers']['hasMerchantReturnPolicy']['applicableCountry'] = 'VN';
            $entity['offers']['hasMerchantReturnPolicy']['returnPolicyCategory'] = 'https://schema.org/MerchantReturnFiniteReturnWindow';
            $entity['offers']['hasMerchantReturnPolicy']['merchantReturnDays'] = 30;
            $entity['offers']['hasMerchantReturnPolicy']['returnMethod'] = 'https://schema.org/ReturnByMail';
            $entity['offers']['hasMerchantReturnPolicy']['returnFees'] = 'https://schema.org/FreeReturn';

            // Shipping details
            $entity['offers']['shippingDetails']['@type'] = 'OfferShippingDetails';
            $entity['offers']['shippingDetails']['shippingRate']['@type'] = 'MonetaryAmount';
            $entity['offers']['shippingDetails']['shippingRate']['value'] = 5;
            $entity['offers']['shippingDetails']['shippingRate']['currency'] = 'VND'; //You currency
            $entity['offers']['shippingDetails']['shippingDestination']['@type'] = 'DefinedRegion';
            $entity['offers']['shippingDetails']['shippingDestination']['addressCountry'] = 'VN';

            //deliveryTime
            $entity['offers']['shippingDetails']['deliveryTime']['@type'] = 'ShippingDeliveryTime';
            $entity['offers']['shippingDetails']['deliveryTime']['handlingTime']['@type'] = 'QuantitativeValue';
            $entity['offers']['shippingDetails']['deliveryTime']['handlingTime']['minValue'] = '0';
            $entity['offers']['shippingDetails']['deliveryTime']['handlingTime']['maxValue'] = '1';
            $entity['offers']['shippingDetails']['deliveryTime']['handlingTime']['unitCode'] = 'DAY';

            $entity['offers']['shippingDetails']['deliveryTime']['transitTime']['@type'] = 'QuantitativeValue';
            $entity['offers']['shippingDetails']['deliveryTime']['transitTime']['minValue'] = '0';
            $entity['offers']['shippingDetails']['deliveryTime']['transitTime']['maxValue'] = '5';
            $entity['offers']['shippingDetails']['deliveryTime']['transitTime']['unitCode'] = 'DAY';

            return $entity;
        });

Note: Please replace the country code ‘VN’ and the currency ‘VND’ with the appropriate codes for your website. After making the changes, you can check ‘Testing live URL’ on Google Search Console to verify if the issues have been fixed.

shippingDetails and hasMerchantReturnPolicy are two e-commerce related options in WooCommerce. If you receive a warning about this error, you can ignore it if the site doesn’t sell and doesn’t have shipping in the US. If you want to disable and fix the warning error, please refer to the instructions above.