Return Policy Schema Framework

Return policy markup tells Google your store's default return window, cost and method. This framework builds it from the page's own data, and 7 checks can each stop it before anything is printed.

  • Google last changed this documentation .
  • This framework was last updated .
MCP connectorBuild it in a chat

What It Earns

The search result this markup makes a page eligible for, drawn from the framework's own output. Each outlined part is there because of the property listed beside it. Point at a part, or tap it, to see which. Google decides whether to show it.

Search result

Trailhead Outfitters

Return policy

30-day returns

Return by mail or in store

Return shipping $6.95

Full refund or store credit

  • The return windowhasMerchantReturnPolicy.merchantReturnDays
  • How to returnhasMerchantReturnPolicy.returnMethod
  • What a return costshasMerchantReturnPolicy.returnFees
  • How the refund is paidhasMerchantReturnPolicy.refundType

When To Use It

Place return information on a single page that describes the return policy of your business, nested under Organization via hasMerchantReturnPolicy. It acts as the default for your products.

Key Implementation Documentation Highlights

Google's rules for this feature that are not about one property alone, in plain words. Which properties Google requires and recommends, and what it expects of each, is in the Property Reference.

  • Required option: give applicableCountry and returnPolicyCategory together, or merchantReturnLink on its own (the URL of the page that describes the policy to customers).
  • returnPolicyCategory: MerchantReturnFiniteReturnWindow, MerchantReturnNotPermitted or MerchantReturnUnlimitedWindow. A finite window requires merchantReturnDays, counted from the delivery date.
  • Fees: specify returnShippingFeesAmount (a MonetaryAmount with an ISO 4217 currency) only when returnFees is ReturnShippingFees. restockingFee as a Number is a percentage of the price paid; as a MonetaryAmount it is a fixed fee.
  • Remorse and defect returns: customerRemorseReturnFees, customerRemorseReturnLabelSource and itemDefectReturnFees, itemDefectReturnLabelSource take the same values; their ShippingFeesAmount properties are only needed when that return carries a non-zero shipping fee.
  • returnPolicySeasonalOverride: a MerchantReturnPolicySeasonalOverride for holiday or seasonal exceptions. It requires returnPolicyCategory, needs merchantReturnDays for a finite window, and takes startDate and endDate.
  • MerchantReturnNotPermitted: return fee, method and day properties are not meaningful, so leave them out.
  • Offer-level override: hasMerchantReturnPolicy on a product's Offer overrides the organization-level policy and supports a more limited set of properties (see the merchant listing documentation).
  • Precedence: Content API for Shopping, then Merchant Center or Search Console settings, then product-level markup, then organization-level markup.
  • Google expects content parity: every marked-up value must match the policy text users can read on the page.

Template Approach

The usual starting point: a static template that prints every property, whether or not the page has the data for it. Under the code is what goes wrong with it.

const pageData = {
  storeName: "Trailhead Outfitters",
  homeUrl: "https://www.example.com/",
  country: "US",
  returnDays: 30
};

const staticTemplate = {
  "@context": "https://schema.org",
  "@type": "OnlineStore",
  "name": pageData.storeName,
  "url": pageData.homeUrl,
  "hasMerchantReturnPolicy": {
    "@type": "MerchantReturnPolicy",
    "applicableCountry": pageData.country,
    "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
    "merchantReturnDays": pageData.returnDays,
    "returnMethod": "https://schema.org/ReturnByMail",
    "returnFees": "https://schema.org/FreeReturn"
  }
};

Where It Breaks

What this template printed when it was run with one field of its page data taken away, and what it never asks.

  • With no country in the page data, it still prints hasMerchantReturnPolicy, without its applicableCountry.
  • With no storeName, it prints the block without name.
  • With no returnDays, it still prints hasMerchantReturnPolicy, without its merchantReturnDays.
  • It asks nothing before it prints. The framework below asks 7 questions first, such as "Organization has a name?" and "Organization has a full home URL?", and prints nothing when an answer is no.

Conditional-logic Framework

The same markup, built by code. It checks the page and the data first, adds a property only when the data for it exists, and outputs nothing when a check fails. The tabs hold the JavaScript builder, the Python version and the output.

const ISO_DATE_TIME = /^(\d{4})-(\d{2})-(\d{2})(?:T(\d{2}):(\d{2})(?::(\d{2}))?(Z|[+-]\d{2}:\d{2})?)?$/;

function isAbsoluteUrl(value) {
  return typeof value === "string" && /^https?:\/\/[^\s/?#]+\.[^\s/?#]+(?:[/?#]\S*)?$/i.test(value);
}

// Returns the ISO 8601 string unchanged (timezone offset kept), or null if unparseable.
function toIsoDateTime(value) {
  if (typeof value !== "string") return null;
  const text = value.trim();
  const m = text.match(ISO_DATE_TIME);
  if (!m) return null;
  const [, y, mo, d, h = "00", mi = "00", s = "00"] = m;
  const date = new Date(Date.UTC(+y, +mo - 1, +d));
  if (date.getUTCMonth() !== +mo - 1 || date.getUTCDate() !== +d) return null;
  if (+h > 23 || +mi > 59 || +s > 59) return null;
  return text;
}

function toIsoDate(value) {
  const iso = toIsoDateTime(value);
  return iso ? iso.slice(0, 10) : null;
}

// Drops null, undefined, "", [] and {} recursively.
function compact(value) {
  if (Array.isArray(value)) {
    const items = value.map(compact).filter((v) => v !== undefined);
    return items.length ? items : undefined;
  }
  if (value && typeof value === "object") {
    const out = {};
    for (const [key, v] of Object.entries(value)) {
      const c = compact(v);
      if (c !== undefined) out[key] = c;
    }
    return Object.keys(out).length ? out : undefined;
  }
  return value === null || value === undefined || value === "" ? undefined : value;
}

function passesPageGates(source) {
  if (source.indexable === false) return false;
  if (source.canonicalUrl && source.url && source.canonicalUrl !== source.url) return false;
  return source.contentVisible !== false;
}


const S = "https://schema.org/";
const ORGANIZATION_TYPES = { online_store: "OnlineStore", online_business: "OnlineBusiness", corporation: "Corporation" };
const RETURN_CATEGORY = {
  finite: S + "MerchantReturnFiniteReturnWindow",
  not_permitted: S + "MerchantReturnNotPermitted",
  unlimited: S + "MerchantReturnUnlimitedWindow"
};
const RETURN_FEES = { free: S + "FreeReturn", customer_pays: S + "ReturnFeesCustomerResponsibility", shipping_fee: S + "ReturnShippingFees" };
const RETURN_METHOD = { kiosk: S + "ReturnAtKiosk", mail: S + "ReturnByMail", in_store: S + "ReturnInStore" };
const RETURN_LABEL = { customer: S + "ReturnLabelCustomerResponsibility", download: S + "ReturnLabelDownloadAndPrint", in_box: S + "ReturnLabelInBox" };
const REFUND_TYPE = { exchange: S + "ExchangeRefund", full: S + "FullRefund", store_credit: S + "StoreCreditRefund" };
const ITEM_CONDITION = { new: S + "NewCondition", refurbished: S + "RefurbishedCondition", used: S + "UsedCondition", damaged: S + "DamagedCondition" };

function chooseOrganizationType(org) {
  return ORGANIZATION_TYPES[org.kind] || "Organization";
}

function toCountryCode(value) {
  const code = String(value || "").toUpperCase();
  return /^[A-Z]{2}$/.test(code) ? code : null;
}

// ISO 3166-1 alpha-2 codes, at most 50; null when any code is invalid or the list is too long.
function toCountryList(values) {
  const codes = (values || []).map(toCountryCode);
  if (codes.includes(null) || codes.length > 50) return null;
  return [...new Set(codes)];
}

function toWholeNumber(value) {
  return Number.isInteger(value) && value >= 0 ? value : null;
}

function mapEnum(keys, table) {
  return (keys || []).map((k) => table[k]).filter(Boolean);
}

function buildMoney(amount) {
  const currency = String((amount && amount.currency) || "").toUpperCase();
  if (!amount || typeof amount.value !== "number" || amount.value < 0 || !/^[A-Z]{3}$/.test(currency)) return null;
  return { "@type": "MonetaryAmount", value: amount.value, currency };
}

// restockingFee: a Number is a percentage of the price paid, a MonetaryAmount is a fixed fee.
function buildRestockingFee(fee) {
  if (!fee) return null;
  if (typeof fee.percent === "number") return fee.percent >= 0 && fee.percent <= 100 ? fee.percent : null;
  return buildMoney(fee);
}

// Fee type and label source; the shipping fee amount only (and always) with ReturnShippingFees.
function buildFees(group) {
  if (!group) return {};
  const amount = buildMoney(group.shippingFee);
  let fees = RETURN_FEES[group.fees] || null;
  if (fees === RETURN_FEES.shipping_fee && !amount) fees = null;
  return { fees, label: RETURN_LABEL[group.label] || null, amount: fees === RETURN_FEES.shipping_fee ? amount : null };
}

function buildSeasonalOverride(season) {
  const category = RETURN_CATEGORY[season.category];
  if (!category) return null; // returnPolicyCategory is required in an override
  const days = toWholeNumber(season.days);
  if (category === RETURN_CATEGORY.finite && days === null) return null;
  const startDate = toIsoDate(season.start);
  const endDate = toIsoDate(season.end);
  if (!startDate || !endDate || endDate < startDate) return null; // a dated window, end on or after start
  return {
    "@type": "MerchantReturnPolicySeasonalOverride",
    startDate,
    endDate,
    returnPolicyCategory: category,
    merchantReturnDays: category === RETURN_CATEGORY.finite ? days : null
  };
}

function buildReturnPolicy(policy) {
  const link = isAbsoluteUrl(policy.link) ? policy.link : null;
  const countries = toCountryList(policy.countries);
  const category = RETURN_CATEGORY[policy.category] || null;
  if (countries === null) return null; // invalid code or more than 50 countries

  // Required option: applicableCountry + returnPolicyCategory, or merchantReturnLink alone.
  if (!(countries.length && category)) {
    return link ? { "@type": "MerchantReturnPolicy", merchantReturnLink: link } : null;
  }
  const days = toWholeNumber(policy.days);
  if (category === RETURN_CATEGORY.finite && days === null) return null; // finite window needs merchantReturnDays

  const base = { "@type": "MerchantReturnPolicy", applicableCountry: countries, returnPolicyCategory: category, merchantReturnLink: link };
  // No returns: fees, methods and days are not meaningful.
  if (category === RETURN_CATEGORY.not_permitted) return base;

  const main = buildFees(policy);
  const remorse = buildFees(policy.customerRemorse);
  const defect = buildFees(policy.itemDefect);
  return {
    ...base,
    merchantReturnDays: category === RETURN_CATEGORY.finite ? days : null,
    returnPolicyCountry: toCountryList(policy.returnToCountries),
    returnMethod: mapEnum(policy.methods, RETURN_METHOD),
    returnFees: main.fees,
    returnShippingFeesAmount: main.amount,
    returnLabelSource: main.label,
    refundType: mapEnum(policy.refundTypes, REFUND_TYPE),
    itemCondition: mapEnum(policy.conditions, ITEM_CONDITION),
    restockingFee: buildRestockingFee(policy.restockingFee),
    customerRemorseReturnFees: remorse.fees,
    customerRemorseReturnShippingFeesAmount: remorse.amount,
    customerRemorseReturnLabelSource: remorse.label,
    itemDefectReturnFees: defect.fees,
    itemDefectReturnShippingFeesAmount: defect.amount,
    itemDefectReturnLabelSource: defect.label,
    returnPolicySeasonalOverride: (policy.seasonalOverrides || []).map(buildSeasonalOverride)
  };
}

function buildReturnPolicySchema(source) {
  // (a) Page gates: indexable, self-canonical, visible policy text, on the page that describes the return policy.
  if (!passesPageGates(source) || source.pageRole !== "return_policy") return null;

  // (b) At least one policy must pass Google's required option (country + category, or merchantReturnLink).
  const hasMerchantReturnPolicy = (source.policies || []).map(buildReturnPolicy).filter(Boolean);
  if (!hasMerchantReturnPolicy.length) return null;

  // House rule: nest under the Organization, identified by name, home URL and the same @id as the home page markup.
  const org = source.organization || {};
  if (!org.name || !isAbsoluteUrl(org.url)) return null;

  // (c) and (d) applied inside buildReturnPolicy; (e) strip empty values.
  return compact({
    "@context": "https://schema.org",
    "@type": chooseOrganizationType(org),
    "@id": `${org.url}#organization`,
    name: org.name,
    url: org.url,
    hasMerchantReturnPolicy
  });
}

// Usage:
// const source = {
//   "url": "https://www.example.com/policies/returns",
//   "canonicalUrl": "https://www.example.com/policies/returns",
//   "indexable": true,
//   "contentVisible": true,
//   "pageRole": "return_policy",
//   "organization": {
//     "kind": "online_store",
//     "name": "Trailhead Outfitters",
//     "url": "https://www.example.com/"
//   },
//   "policies": [
//     {
//       "countries": [
//         "US",
//         "CA"
//       ],
//       "returnToCountries": [
//         "US"
//       ],
//       "category": "finite",
//       "days": 30,
//       "link": "https://www.example.com/policies/returns",
//       "methods": [
//         "mail",
//         "in_store"
//       ],
//       "fees": "shipping_fee",
//       "shippingFee": {
//         "value": 6.95,
//         "currency": "USD"
//       },
//       "label": "download",
//       "refundTypes": [
//         "full",
//         "store_credit"
//       ],
//       "conditions": [
//         "new"
//       ],
//       "restockingFee": {
//         "percent": 0
//       },
//       "customerRemorse": {
//         "fees": "shipping_fee",
//         "shippingFee": {
//           "value": 6.95,
//           "currency": "USD"
//         },
//         "label": "download"
//       },
//       "itemDefect": {
//         "fees": "free",
//         "label": "in_box"
//       },
//       "seasonalOverrides": [
//         {
//           "category": "finite",
//           "days": 60,
//           "start": "2026-11-20",
//           "end": "2026-12-31"
//         }
//       ]
//     }
//   ]
// };
// const schema = buildReturnPolicySchema(source); // null when a gate or required property fails

What It Does Instead

What this framework does that the template cannot.

  • Enforces the required option in code: applicableCountry plus returnPolicyCategory, or merchantReturnLink alone, and never a policy with neither.
  • Drops fee, method and day properties when returns are not permitted, and blocks a finite window that has no merchantReturnDays.
  • Keeps returnShippingFeesAmount tied to ReturnShippingFees, so a fee change in the policy config cannot leave a stale amount behind.
  • Emits seasonal overrides only with a valid dated window, so a lapsed holiday policy is never published as all-year.
  • Reads from the same policy config that renders the page and feeds Merchant Center, which keeps markup, visible text and higher-precedence settings in sync.

The Logic As A Flowchart

The same logic as the builder, drawn for readers who do not write code. Every Yes moves down. A No that runs out to the line on the right stops everything, and no schema is output. A No inside a dashed box only drops that one item. Where the path splits, exactly one branch is taken. Each step was run against the builder itself before this page was published: 41 test cases, all passing.

  1. The page that sets out the return policy
  2. 1Page indexable?not marked as non-indexableNo: no schema
    Yes
  3. 2Canonical is itself?or no canonical is setNo: no schema
    Yes
  4. 3Content visible?not marked as hiddenNo: no schema
    Yes
  5. 4The return policy page?the page that describes how returns workNo: no schema
    Yes
  6. For each policy on the page
    1. 5Country codes valid?every country a 2-letter code, and no more than 50No: drop this policy
      Yes
    2. Countries and a return window both given?decides how much of the policy is published
      Yes
      The full policy
      1. 6A time-limited window says how many days?a whole number of daysNo: drop this policy
      or
      No
      Only the link to the policy page
      1. 7Has a full link to the policy?starts with http:// or https://No: drop this policy
    3. Policy kept
  7. 8At least one policy kept?nothing to publish without oneNo: no schema
    Yes
  8. 9Organization has a name?the business the policy belongs toNo: no schema
    Yes
  9. 10Organization has a full home URL?starts with http:// or https://No: no schema
    Yes
  10. Which organization type?the most specific one that fits
    An online store, an online business or a corporation
    That type
    Anything else
    Organization
  11. Build the restanything optional that is missing or invalid is left out
  12. Output the organization with its return policy
    No schema

Put It To Work

What the builder needs, where it runs and how to tell it is working.

What To Feed It

The builder reads one object. The example at the end of the JavaScript tab fills in every field of it. Each row says whether the builder needs that field and what the output loses without it, found by taking the field out of the example and running the builder again. A field that holds other fields opens to show the same for each field inside it.

Whether the builder needs each field of its input, and what it outputs without it
InputNeededWhat happens
pageRoleRequiredWithout it, nothing is output.
organizationRequiredWithout it, nothing is output.
Inside it: 3 fields
  • nameRequiredWithout it, nothing is output.
  • urlRequiredWithout it, nothing is output.
  • kindOptionalWithout it, @type changes.
policiesRequiredWithout it, nothing is output.
Inside each item: 15 fields
  • daysRequiredWithout it, nothing is output.
  • countriesOptionalWithout it, hasMerchantReturnPolicy[].applicableCountry, hasMerchantReturnPolicy[].returnPolicyCategory, hasMerchantReturnPolicy[].merchantReturnDays and 14 more are left out.
  • returnToCountriesOptionalWithout it, hasMerchantReturnPolicy[].returnPolicyCountry is left out.
  • categoryOptionalWithout it, hasMerchantReturnPolicy[].applicableCountry, hasMerchantReturnPolicy[].returnPolicyCategory, hasMerchantReturnPolicy[].merchantReturnDays and 14 more are left out.
  • methodsOptionalWithout it, hasMerchantReturnPolicy[].returnMethod is left out.
  • feesOptionalWithout it, hasMerchantReturnPolicy[].returnFees and hasMerchantReturnPolicy[].returnShippingFeesAmount are left out.
  • shippingFeeOptionalWithout it, hasMerchantReturnPolicy[].returnFees and hasMerchantReturnPolicy[].returnShippingFeesAmount are left out.
    Inside it: 2 fields
    • valueOptionalWithout it, hasMerchantReturnPolicy[].returnFees and hasMerchantReturnPolicy[].returnShippingFeesAmount are left out.
    • currencyOptionalWithout it, hasMerchantReturnPolicy[].returnFees and hasMerchantReturnPolicy[].returnShippingFeesAmount are left out.
  • labelOptionalWithout it, hasMerchantReturnPolicy[].returnLabelSource is left out.
  • refundTypesOptionalWithout it, hasMerchantReturnPolicy[].refundType is left out.
  • conditionsOptionalWithout it, hasMerchantReturnPolicy[].itemCondition is left out.
  • restockingFeeOptionalWithout it, hasMerchantReturnPolicy[].restockingFee is left out.
    Inside it: 1 field
    • percentOptionalWithout it, hasMerchantReturnPolicy[].restockingFee is left out.
  • customerRemorseOptionalWithout it, hasMerchantReturnPolicy[].customerRemorseReturnFees, hasMerchantReturnPolicy[].customerRemorseReturnShippingFeesAmount and hasMerchantReturnPolicy[].customerRemorseReturnLabelSource are left out.
    Inside it: 3 fields
    • feesOptionalWithout it, hasMerchantReturnPolicy[].customerRemorseReturnFees and hasMerchantReturnPolicy[].customerRemorseReturnShippingFeesAmount are left out.
    • shippingFeeOptionalWithout it, hasMerchantReturnPolicy[].customerRemorseReturnFees and hasMerchantReturnPolicy[].customerRemorseReturnShippingFeesAmount are left out.
    • labelOptionalWithout it, hasMerchantReturnPolicy[].customerRemorseReturnLabelSource is left out.
  • itemDefectOptionalWithout it, hasMerchantReturnPolicy[].itemDefectReturnFees and hasMerchantReturnPolicy[].itemDefectReturnLabelSource are left out.
    Inside it: 2 fields
    • feesOptionalWithout it, hasMerchantReturnPolicy[].itemDefectReturnFees is left out.
    • labelOptionalWithout it, hasMerchantReturnPolicy[].itemDefectReturnLabelSource is left out.
  • seasonalOverridesOptionalWithout it, hasMerchantReturnPolicy[].returnPolicySeasonalOverride is left out.
    Inside each item: 4 fields
    • categoryOptionalWithout it, hasMerchantReturnPolicy[].returnPolicySeasonalOverride is left out.
    • daysOptionalWithout it, hasMerchantReturnPolicy[].returnPolicySeasonalOverride is left out.
    • startOptionalWithout it, hasMerchantReturnPolicy[].returnPolicySeasonalOverride is left out.
    • endOptionalWithout it, hasMerchantReturnPolicy[].returnPolicySeasonalOverride is left out.
url, canonicalUrl, indexable, contentVisibleOptionalWithout them, nothing changes. They are checks: nothing is output when url and canonicalUrl differ, or when indexable or contentVisible is set to false.

Where To Run It

Run it where the page is built, on the server or in the build step, with that page's own data. Print what it returns as JSON in a <script type="application/ld+json"> tag. When it returns nothing, print no tag.

Build It In A Chat

Add the Schema Frameworks connector to Claude or another assistant that supports MCP and ask it to build this markup. It runs the builder on this page, and when nothing is output it names the check that stopped it.

  • Claude
  • ChatGPT
  • Gemini
  • Grok
  • Perplexity
  • Le Chat
  • Meta Muse
  • Manus
  • Copilot
# Connector address
https://mcp.jakelabate.com/schema-frameworks
# Then ask
Use the Schema Frameworks MCP server and its Return Policy framework to build markup for my page. Ask me for the page URL first.

How To Check It

  • Validate with the Rich Results Test and URL Inspection after deployment.
  • Test the page as it is served, not the template. A build step or client-side rendering can change what is printed.
  • Log every page where the builder returns nothing. Each one was stopped by one of the 7 checks in the flowchart, which is not the same as a builder that failed.

The Output As An Entity Graph

The conditional-logic output, parsed in your browser and drawn as the graph a crawler builds from it. Every nested object is a node and the property that holds it is the edge. Tap a node to inspect its properties, or drag to rearrange.

Property Reference

What Google's Merchant return policy (organization-level) documentation requires and recommends, property by property. These are the same rules the SchemaCDN validator checks. Each name links to its schema.org definition. The rules that are not about one property are in Key Implementation Documentation Highlights.

Merchant return policy (organization-level) properties in Google's documentation
PropertyGoogleExpectsNotes
applicableCountryRequiredText, can repeatThe country code(s) the return policy applies to (where the product is sold and returned from) ISO 3166-1 alpha-2 codes, at most 50.
returnPolicyCategoryRequiredEnumThe type of return policy. One of: MerchantReturnFiniteReturnWindow, MerchantReturnNotPermitted, MerchantReturnUnlimitedWindow.
merchantReturnDaysRecommendedIntegerThe number of days from the delivery date that a product can be returned.
returnPolicyCountryRecommendedText, can repeatThe country where the product has to be sent to for returns. ISO 3166-1 alpha-2 codes, at most 50.
returnMethodRecommendedEnum, can repeatThe type of return method offered; one or more values. One of: ReturnAtKiosk, ReturnByMail, ReturnInStore.
returnFeesRecommendedEnumThe type of return fees. One of: FreeReturn, ReturnFeesCustomerResponsibility, ReturnShippingFees.
returnShippingFeesAmountRecommendedMonetaryAmountThe cost of shipping for returning a product.
returnShippingFeesAmount.currencyRecommendedTextISO 4217 currency code.
returnShippingFeesAmount.valueRecommendedNumberThe amount.
returnLabelSourceRecommendedEnumHow the customer obtains a return shipping label. One of: ReturnLabelCustomerResponsibility, ReturnLabelDownloadAndPrint, ReturnLabelInBox.
itemConditionRecommendedEnum, can repeatAcceptable condition(s) of returned items. One of: DamagedCondition, NewCondition, RefurbishedCondition, UsedCondition.
refundTypeRecommendedEnum, can repeatThe type of refund available. One of: ExchangeRefund, FullRefund, StoreCreditRefund.
restockingFeeRecommendedMonetaryAmount or NumberThe restocking fee charged for returns.
customerRemorseReturnFeesRecommendedEnumReturn fee type if the product is returned due to customer remorse. One of: FreeReturn, ReturnFeesCustomerResponsibility, ReturnShippingFees.
customerRemorseReturnLabelSourceRecommendedEnumReturn label source for customer remorse returns. One of: ReturnLabelCustomerResponsibility, ReturnLabelDownloadAndPrint, ReturnLabelInBox.
customerRemorseReturnShippingFeesAmountRecommendedMonetaryAmountShipping fee for customer remorse returns.
customerRemorseReturnShippingFeesAmount.currencyRecommendedTextISO 4217 currency code.
customerRemorseReturnShippingFeesAmount.valueRecommendedNumberThe amount.
itemDefectReturnFeesRecommendedEnumReturn fee type for defect products. One of: FreeReturn, ReturnFeesCustomerResponsibility, ReturnShippingFees.
itemDefectReturnLabelSourceRecommendedEnumReturn label source for defect product returns. One of: ReturnLabelCustomerResponsibility, ReturnLabelDownloadAndPrint, ReturnLabelInBox.
itemDefectReturnShippingFeesAmountRecommendedMonetaryAmountShipping fee for defect product returns.
itemDefectReturnShippingFeesAmount.currencyRecommendedTextISO 4217 currency code.
itemDefectReturnShippingFeesAmount.valueRecommendedNumberThe amount.
returnPolicySeasonalOverrideRecommendedMerchantReturnPolicySeasonalOverride, can repeatA seasonal override of the return policy.
returnPolicySeasonalOverride.returnPolicyCategoryRequiredEnumThe type of return policy for the season. One of: MerchantReturnFiniteReturnWindow, MerchantReturnNotPermitted, MerchantReturnUnlimitedWindow.
returnPolicySeasonalOverride.merchantReturnDaysRecommendedIntegerNumber of return days during the season.
returnPolicySeasonalOverride.startDateRecommendedDate or DateTimeStart of the seasonal override.
returnPolicySeasonalOverride.endDateRecommendedDate or DateTimeEnd of the seasonal override.

Explore Other Schema Framework Pages

Review Snippet Use when a page publishes genuine reviews tied to a clearly identified product, service, or entity. Review Open Shipping Policy Use to publish shipping rates, delivery times and destinations once at the organization level. ShippingService Open Site Name Use on the home page so Google shows the preferred site name in search results. WebSite Open Retired Sitelinks Search Box Use on sites with a functioning internal search endpoint that can accept URL query parameters. WebSite Open Software App (Beta) Use for software product pages that describe platform support and application category clearly. SoftwareApplication Open Limited Speakable Use for news-style pages where specific text segments are appropriate for text-to-speech playback. SpeakableSpecification Open Subscription and Paywalled Content Use for pages with restricted sections so Google can distinguish free previews from protected content. CreativeWork Open Limited Vacation Rental Use for rental property detail pages where booking-relevant amenities and location signals are explicit. VacationRental Open Retired Vehicle Listing Use for inventory pages selling vehicles with standardized listing fields and offer information. Car Open Video Use for pages where a primary video is embedded and key media metadata is visible on-page. VideoObject Open Article Use for editorial pages where the visible content is a complete article with a clear byline and publication timestamps. Article Open Limited Book Actions Use when your page helps users read, preview, or purchase books through clearly described actions. Book Open Breadcrumb Use on pages that belong to a clear hierarchy and display navigational trail links users can follow. BreadcrumbList Open Carousel Use when a page lists multiple related entities in a scannable sequence that can be surfaced as cards. ItemList Open Course Use for educational offerings where curriculum details, provider identity, and delivery context are explicit. Course Open Dataset Use for dataset landing pages so datasets are discoverable in Google Dataset Search with license, creator and download details. Dataset Open Discussion Forum Use for forum and community threads where a primary post and subsequent replies are publicly visible. DiscussionForumPosting Open Limited Education Q&A Use for educational question-answer pages where a single canonical answer and supporting context are visible. Quiz Open Employer Aggregate Rating Use on pages that publish employer rating aggregates from a clear and policy-compliant review source. EmployerAggregateRating Open Retired Estimated Salary Use for compensation insight pages that present transparent salary ranges for specific occupations and locations. Occupation Open Event Use for upcoming events with a real-world or virtual occurrence, schedule, and location context. Event Open Retired Fact Check Use for fact-checking pages that evaluate a specific claim with a transparent rating methodology. ClaimReview Open Retired Home Activities Use for virtual classes and activities where participation details and timing are clearly listed. Event Open Retired How-To Use for instructional content that teaches a process through ordered steps and actionable detail. HowTo Open Image Metadata Use on image pages and image hosts that expose ownership and licensing information to search engines. ImageObject Open Job Posting Use for active job listings that include role details, hiring entity, and location/salary context. JobPosting Open Retired Learning Video Use for educational videos where the learning objective and pedagogical structure are explicit. LearningResource Open Local Business Use for physical businesses serving local customers with publicly verifiable contact and location details. LocalBusiness Open Loyalty Program Use to publish a loyalty program and its tiers once at the organization level, so member prices and member shipping can reference them. MemberProgram Open Math Solvers Use for pages that solve mathematical expressions and present step-by-step computational guidance. MathSolver Open Merchant Listing Use on pages where a product can be bought, with price, availability, shipping and return details. Product Open Limited Movie Use for movie detail pages with canonical film information and transparent metadata attribution. Movie Open Organization Use for official organization pages to clarify brand identity and authoritative entity signals. Organization Open Retired Practice Problems Use for educational practice content that presents solvable problems and answer validation structure. Quiz Open Product Snippet Use for product pages where pricing, availability, and product identity are visible to users. Product Open Product Variants Use when one product comes in variants such as size or color, grouped with ProductGroup. ProductGroup Open Profile Page Use for creator or contributor profile pages where identity attributes and ownership are explicit. ProfilePage Open Q&A Use for pages where users submit questions and community or editorial answers are displayed. QAPage Open Recipe Use for recipe pages with complete ingredients, instructions, and preparation details. Recipe Open

Implement Return Policy Schema Frameworks Correctly

Get implementation support for conditional schema architecture, validation, and deployment governance.