Loyalty Program Schema Framework
Loyalty program markup tells Google your membership tiers, so it can show member prices and points on your products. 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 .
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.
Trailhead Outfitters
Loyalty program
Basecamp Rewards
Earn points on every order and unlock member prices on gear and free 2-day shipping.
TrailPoints
SummitPoints · Member prices
- The program name
hasMemberProgram.name - The description
hasMemberProgram.description - Each tier
hasMemberProgram.hasTiers. name - What each tier gets
hasMemberProgram.hasTiers. hasTierBenefit
When To Use It
Nest MemberProgram under Organization via hasMemberProgram, on the page that carries your business's administrative details and policies. Define each tier once with an @id, then reference it from product offers and shipping services through validForMemberTier to show member prices, loyalty points and member shipping.
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.
- Availability: loyalty program markup is available in Australia, Brazil, Canada, France, Germany, Mexico, the UK and the US, on desktop and mobile.
- MemberProgram required properties: name, description (the primary benefits for members) and hasTiers (at least one MemberProgramTier). Recommended: url, the page where a shopper signs up; give a single URL, not several.
- MemberProgramTier required properties: name and hasTierBenefit, one or both of https://schema.org/TierBenefitLoyaltyPoints and https://schema.org/TierBenefitLoyaltyPrice. Recommended: hasTierRequirement, membershipPointsEarned, url (the sign up page for that tier).
- membershipPointsEarned (a QuantitativeValue: points earned per unit of currency spent) is listed as recommended, but it is required on any tier whose hasTierBenefit includes TierBenefitLoyaltyPoints.
- Member prices: add a UnitPriceSpecification to the Offer's priceSpecification with validForMemberTier and, for points, membershipPointsEarned (a whole number, only together with validForMemberTier). validForMemberTier cannot be combined with priceType; the active non-member price has neither. See the merchant listing framework.
- Member shipping: a ShippingService under Organization.hasShippingService can carry validForMemberTier for shipping rates that only apply to a tier. See the shipping policy framework.
- Google expects content parity: tier names, benefits, requirements and point rates must match the program terms users can read.
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/",
programName: "Basecamp Rewards",
programDescription: "Earn points on every order and unlock member prices.",
pointsPerDollar: 1
};
const staticTemplate = {
"@context": "https://schema.org",
"@type": "OnlineStore",
"name": pageData.storeName,
"url": pageData.homeUrl,
"hasMemberProgram": {
"@type": "MemberProgram",
"name": pageData.programName,
"description": pageData.programDescription,
"hasTiers": [
{
"@type": "MemberProgramTier",
"@id": pageData.homeUrl + "#tier-insider",
"name": "Insider",
"hasTierBenefit": [
"https://schema.org/TierBenefitLoyaltyPoints",
"https://schema.org/TierBenefitLoyaltyPrice"
],
"membershipPointsEarned": {
"@type": "QuantitativeValue",
"value": pageData.pointsPerDollar
}
}
]
}
};
{
"@context": "https://schema.org",
"@type": "OnlineStore",
"name": "Trailhead Outfitters",
"url": "https://www.example.com/",
"hasMemberProgram": {
"@type": "MemberProgram",
"name": "Basecamp Rewards",
"description": "Earn points on every order and unlock member prices.",
"hasTiers": [
{
"@type": "MemberProgramTier",
"@id": "https://www.example.com/#tier-insider",
"name": "Insider",
"hasTierBenefit": [
"https://schema.org/TierBenefitLoyaltyPoints",
"https://schema.org/TierBenefitLoyaltyPrice"
],
"membershipPointsEarned": {
"@type": "QuantitativeValue",
"value": 1
}
}
]
}
}
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
storeNamein the page data, it prints the block withoutname, which Google requires. - With no
pointsPerDollar, it still printshasMemberProgram.hasTiers.membershipPointsEarned, with a type and nothing else. - With no
homeUrl, it prints the text "undefined#tier-insider" ashasMemberProgram.hasTiers.@id. - It asks nothing before it prints. The framework below asks 7 questions first, such as "Organization has a full home URL?" and "At least one program?", 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 TIER_BENEFIT = { points: S + "TierBenefitLoyaltyPoints", member_price: S + "TierBenefitLoyaltyPrice" };
function chooseOrganizationType(org) {
return ORGANIZATION_TYPES[org.kind] || "Organization";
}
function isPositiveNumber(value) {
return typeof value === "number" && Number.isFinite(value) && value > 0;
}
function toCurrencyCode(value) {
const code = String(value || "").toUpperCase();
return /^[A-Z]{3}$/.test(code) ? code : null;
}
// Stable fragment id per tier, reused by Offer and OfferShippingDetails validForMemberTier.
function tierId(orgUrl, key) {
return /^[a-z0-9-]+$/.test(String(key || "")) ? `${orgUrl}#tier-${key}` : null;
}
// hasTierRequirement variants. undefined = no requirement (free to join), null = invalid.
function buildTierRequirement(req) {
if (!req || req.type === "none") return undefined;
if (req.type === "credit_card") {
return req.name ? { "@type": "CreditCard", name: req.name } : null;
}
if (req.type === "min_spend") {
const currency = toCurrencyCode(req.currency);
return isPositiveNumber(req.value) && currency ? { "@type": "MonetaryAmount", value: req.value, currency } : null;
}
if (req.type === "paid_membership") {
const priceCurrency = toCurrencyCode(req.currency);
const ok = isPositiveNumber(req.price) && priceCurrency && isPositiveNumber(req.billingDuration) &&
Number.isInteger(req.billingIncrement) && req.billingIncrement > 0 && /^[A-Z0-9]{3}$/.test(String(req.unitCode || ""));
return ok ? {
"@type": "UnitPriceSpecification",
price: req.price,
priceCurrency,
billingDuration: req.billingDuration,
billingIncrement: req.billingIncrement,
unitCode: req.unitCode
} : null;
}
if (req.type === "text") return typeof req.text === "string" && req.text.trim() ? req.text.trim() : null;
return null;
}
function buildTier(tier, orgUrl) {
const id = tierId(orgUrl, tier.key);
const hasTierBenefit = [...new Set((tier.benefits || []).map((b) => TIER_BENEFIT[b]).filter(Boolean))];
if (!id || !tier.name || !hasTierBenefit.length) return null; // name and hasTierBenefit are required
// A points tier must state how many points are earned.
const earnsPoints = hasTierBenefit.includes(TIER_BENEFIT.points);
if (earnsPoints && !isPositiveNumber(tier.pointsPerCurrencyUnit)) return null;
// An invalid requirement is not dropped silently: omitting it would claim the tier is free to join.
const hasTierRequirement = buildTierRequirement(tier.requirement);
if (hasTierRequirement === null) return null;
return {
"@type": "MemberProgramTier",
"@id": id,
name: tier.name,
hasTierBenefit,
hasTierRequirement,
membershipPointsEarned: earnsPoints ? { "@type": "QuantitativeValue", value: tier.pointsPerCurrencyUnit } : null,
url: isAbsoluteUrl(tier.signupUrl) ? tier.signupUrl : null
};
}
function buildMemberProgram(program, orgUrl) {
if (!program || !program.name || !program.description) return null; // required
if (!/^[a-z0-9-]+$/.test(String(program.key || ""))) return null;
const tierKeys = (program.tiers || []).map((t) => t.key);
if (new Set(tierKeys).size !== tierKeys.length) return null; // duplicate tier @id
const hasTiers = (program.tiers || []).map((t) => buildTier(t, orgUrl));
if (!hasTiers.length || hasTiers.includes(null)) return null; // publish every visible tier or none
return {
"@type": "MemberProgram",
"@id": `${orgUrl}#program-${program.key}`,
name: program.name,
description: program.description,
url: isAbsoluteUrl(program.signupUrl) ? program.signupUrl : null, // a single URL
hasTiers
};
}
function buildLoyaltyProgramSchema(source) {
// (a) Page gates, and only on the page that carries the Organization details and policies.
if (!passesPageGates(source) || source.pageRole !== "organization_details") return null;
const org = source.organization || {};
if (!org.name || !isAbsoluteUrl(org.url)) return null;
// (b) Required: name, description, at least one valid tier with name and hasTierBenefit.
const memberProgram = (source.memberPrograms || []).map((p) => buildMemberProgram(p, org.url));
if (!memberProgram.length || memberProgram.includes(null)) return null;
// (c) and (d) applied in buildMemberProgram and buildTier; (e) strip empty values.
return compact({
"@context": "https://schema.org",
"@type": chooseOrganizationType(org),
"@id": `${org.url}#organization`,
name: org.name,
url: org.url,
hasMemberProgram: memberProgram.length === 1 ? memberProgram[0] : memberProgram
});
}
// Usage:
// const source = {
// "url": "https://www.example.com/about",
// "canonicalUrl": "https://www.example.com/about",
// "indexable": true,
// "contentVisible": true,
// "pageRole": "organization_details",
// "organization": {
// "kind": "online_store",
// "name": "Trailhead Outfitters",
// "url": "https://www.example.com/"
// },
// "memberPrograms": [
// {
// "key": "basecamp",
// "name": "Basecamp Rewards",
// "description": "Earn points on every order and unlock member prices on gear and free 2-day shipping.",
// "signupUrl": "https://www.example.com/rewards",
// "tiers": [
// {
// "key": "trail",
// "name": "Trail",
// "benefits": [
// "points"
// ],
// "pointsPerCurrencyUnit": 1,
// "requirement": {
// "type": "text",
// "text": "Create a free online account"
// },
// "signupUrl": "https://www.example.com/rewards/join"
// },
// {
// "key": "summit",
// "name": "Summit",
// "benefits": [
// "points",
// "member_price"
// ],
// "pointsPerCurrencyUnit": 3,
// "requirement": {
// "type": "paid_membership",
// "price": 49,
// "currency": "USD",
// "billingDuration": 12,
// "billingIncrement": 1,
// "unitCode": "MON"
// },
// "signupUrl": "https://www.example.com/rewards/summit"
// }
// ]
// }
// ]
// };
// const schema = buildLoyaltyProgramSchema(source); // null when a gate or required property fails
import math
import re
from datetime import date, datetime, timezone
ISO_DATE_TIME = re.compile(r"^(\d{4})-(\d{2})-(\d{2})(?:T(\d{2}):(\d{2})(?::(\d{2}))?(Z|[+-]\d{2}:\d{2})?)?$")
ABSOLUTE_URL = re.compile(r"^https?://[^\s/?#]+\.[^\s/?#]+(?:[/?#]\S*)?$", re.I)
def is_absolute_url(value):
return isinstance(value, str) and bool(ABSOLUTE_URL.match(value))
# Returns the ISO 8601 string unchanged (timezone offset kept), or None if unparseable.
def to_iso_date_time(value):
if not isinstance(value, str):
return None
text = value.strip()
m = ISO_DATE_TIME.match(text)
if not m:
return None
y, mo, d = int(m[1]), int(m[2]), int(m[3])
try:
date(y, mo, d)
except ValueError:
return None
if int(m[4] or 0) > 23 or int(m[5] or 0) > 59 or int(m[6] or 0) > 59:
return None
return text
def to_iso_date(value):
iso = to_iso_date_time(value)
return iso[:10] if iso else None
# Drops None, "", [] and {} recursively.
def compact(value):
if isinstance(value, list):
items = [c for c in (compact(v) for v in value) if c is not None]
return items or None
if isinstance(value, dict):
out = {k: c for k, c in ((k, compact(v)) for k, v in value.items()) if c is not None}
return out or None
return None if value is None or value == "" else value
def passes_page_gates(source):
if source.get("indexable") is False:
return False
if source.get("canonicalUrl") and source.get("url") and source["canonicalUrl"] != source["url"]:
return False
return source.get("contentVisible") is not False
S = "https://schema.org/"
ORGANIZATION_TYPES = {"online_store": "OnlineStore", "online_business": "OnlineBusiness", "corporation": "Corporation"}
TIER_BENEFIT = {"points": S + "TierBenefitLoyaltyPoints", "member_price": S + "TierBenefitLoyaltyPrice"}
KEY = re.compile(r"^[a-z0-9-]+$")
MISSING = object() # no requirement: anyone can join for free
def choose_organization_type(org):
return ORGANIZATION_TYPES.get(org.get("kind"), "Organization")
def is_positive_number(value):
return isinstance(value, (int, float)) and not isinstance(value, bool) and math.isfinite(value) and value > 0
def to_currency_code(value):
code = str(value or "").upper()
return code if re.fullmatch(r"[A-Z]{3}", code) else None
# Stable fragment id per tier, reused by Offer and OfferShippingDetails validForMemberTier.
def tier_id(org_url, key):
return f"{org_url}#tier-{key}" if KEY.match(str(key or "")) else None
# hasTierRequirement variants. MISSING = no requirement (free to join), None = invalid.
def build_tier_requirement(req):
if not req or req.get("type") == "none":
return MISSING
kind = req.get("type")
if kind == "credit_card":
return {"@type": "CreditCard", "name": req["name"]} if req.get("name") else None
if kind == "min_spend":
currency = to_currency_code(req.get("currency"))
if is_positive_number(req.get("value")) and currency:
return {"@type": "MonetaryAmount", "value": req["value"], "currency": currency}
return None
if kind == "paid_membership":
price_currency = to_currency_code(req.get("currency"))
increment = req.get("billingIncrement")
ok = (is_positive_number(req.get("price")) and price_currency and is_positive_number(req.get("billingDuration"))
and isinstance(increment, int) and not isinstance(increment, bool) and increment > 0
and re.fullmatch(r"[A-Z0-9]{3}", str(req.get("unitCode") or "")))
if not ok:
return None
return {
"@type": "UnitPriceSpecification",
"price": req["price"],
"priceCurrency": price_currency,
"billingDuration": req["billingDuration"],
"billingIncrement": increment,
"unitCode": req["unitCode"],
}
if kind == "text":
text = req.get("text")
return text.strip() if isinstance(text, str) and text.strip() else None
return None
def build_tier(tier, org_url):
tid = tier_id(org_url, tier.get("key"))
has_tier_benefit = list(dict.fromkeys(TIER_BENEFIT[b] for b in tier.get("benefits") or [] if b in TIER_BENEFIT))
if not tid or not tier.get("name") or not has_tier_benefit:
return None # name and hasTierBenefit are required
# A points tier must state how many points are earned.
earns_points = TIER_BENEFIT["points"] in has_tier_benefit
if earns_points and not is_positive_number(tier.get("pointsPerCurrencyUnit")):
return None
# An invalid requirement is not dropped silently: omitting it would claim the tier is free to join.
requirement = build_tier_requirement(tier.get("requirement"))
if requirement is None:
return None
return {
"@type": "MemberProgramTier",
"@id": tid,
"name": tier["name"],
"hasTierBenefit": has_tier_benefit,
"hasTierRequirement": None if requirement is MISSING else requirement,
"membershipPointsEarned": {"@type": "QuantitativeValue", "value": tier["pointsPerCurrencyUnit"]} if earns_points else None,
"url": tier.get("signupUrl") if is_absolute_url(tier.get("signupUrl")) else None,
}
def build_member_program(program, org_url):
if not program or not program.get("name") or not program.get("description"):
return None # required
if not KEY.match(str(program.get("key") or "")):
return None
tiers = program.get("tiers") or []
keys = [t.get("key") for t in tiers]
if len(set(keys)) != len(keys):
return None # duplicate tier @id
has_tiers = [build_tier(t, org_url) for t in tiers]
if not has_tiers or None in has_tiers:
return None # publish every visible tier or none
return {
"@type": "MemberProgram",
"@id": f"{org_url}#program-{program['key']}",
"name": program["name"],
"description": program["description"],
"url": program.get("signupUrl") if is_absolute_url(program.get("signupUrl")) else None, # a single URL
"hasTiers": has_tiers,
}
def build_loyalty_program_schema(source):
# (a) Page gates, and only on the page that carries the Organization details and policies.
if not passes_page_gates(source) or source.get("pageRole") != "organization_details":
return None
org = source.get("organization") or {}
if not org.get("name") or not is_absolute_url(org.get("url")):
return None
# (b) Required: name, description, at least one valid tier with name and hasTierBenefit.
programs = [build_member_program(p, org["url"]) for p in source.get("memberPrograms") or []]
if not programs or None in programs:
return None
# (c) and (d) applied in build_member_program and build_tier; (e) strip empty values.
return compact({
"@context": "https://schema.org",
"@type": choose_organization_type(org),
"@id": f"{org['url']}#organization",
"name": org["name"],
"url": org["url"],
"hasMemberProgram": programs[0] if len(programs) == 1 else programs,
})
{
"@context": "https://schema.org",
"@type": "OnlineStore",
"@id": "https://www.example.com/#organization",
"name": "Trailhead Outfitters",
"url": "https://www.example.com/",
"hasMemberProgram": {
"@type": "MemberProgram",
"@id": "https://www.example.com/#program-basecamp",
"name": "Basecamp Rewards",
"description": "Earn points on every order and unlock member prices on gear and free 2-day shipping.",
"url": "https://www.example.com/rewards",
"hasTiers": [
{
"@type": "MemberProgramTier",
"@id": "https://www.example.com/#tier-trail",
"name": "Trail",
"hasTierBenefit": [
"https://schema.org/TierBenefitLoyaltyPoints"
],
"hasTierRequirement": "Create a free online account",
"membershipPointsEarned": {
"@type": "QuantitativeValue",
"value": 1
},
"url": "https://www.example.com/rewards/join"
},
{
"@type": "MemberProgramTier",
"@id": "https://www.example.com/#tier-summit",
"name": "Summit",
"hasTierBenefit": [
"https://schema.org/TierBenefitLoyaltyPoints",
"https://schema.org/TierBenefitLoyaltyPrice"
],
"hasTierRequirement": {
"@type": "UnitPriceSpecification",
"price": 49,
"priceCurrency": "USD",
"billingDuration": 12,
"billingIncrement": 1,
"unitCode": "MON"
},
"membershipPointsEarned": {
"@type": "QuantitativeValue",
"value": 3
},
"url": "https://www.example.com/rewards/summit"
}
]
}
}
What It Does Instead
What this framework does that the template cannot.
- Enforces the required properties in code: no program without name, description and at least one tier, and no tier without name and a recognized hasTierBenefit value.
- Blocks a points tier that has no membershipPointsEarned, so the points benefit is never published without its earn rate.
- Rejects a tier whose requirement is incomplete instead of dropping hasTierRequirement, which would tell Google a paid or card tier is free to join.
- Derives tier @id values from stable keys, so the validForMemberTier references in offers and shipping services keep resolving when tier names or prices change.
- Reads from the same program config that renders the rewards page and the member prices, which keeps markup, visible terms and offer pricing 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. Where the path splits, exactly one branch is taken. Each step was run against the builder itself before this page was published: 50 test cases, all passing.
-
The page that describes the organization and its loyalty program
-
1Page indexable?not marked as non-indexableNo: no schemaYes
-
2Canonical is itself?or no canonical is setNo: no schemaYes
-
3Content visible?not marked as hiddenNo: no schemaYes
-
4The organization details page?the one page that carries the organization and its policiesNo: no schemaYes
-
5Organization has a name?the business that runs the programNo: no schemaYes
-
6Organization has a full home URL?starts with http:// or https://No: no schemaYes
-
For each loyalty programEvery program on the page is published, or none is.
-
7Has a name and a description?both are requiredNo: no schemaYes
-
8Has a web-safe key?lowercase letters, digits and hyphensNo: no schemaYes
-
9Every tier key different?no two tiers share a keyNo: no schemaYes
-
For each tierEvery tier is published, or the program is not.
-
10Has a web-safe key?lowercase letters, digits and hyphensNo: no schemaYes
-
11Has a name?the tier name members seeNo: no schemaYes
-
12Has a recognized benefit?points, member prices, or bothNo: no schemaYes
-
13A points tier says how many points?a number above zero for each unit of currency spentNo: no schemaYes
-
14Joining rule valid, when there is one?a named credit card, a minimum spend, a paid membership or a line of text. No rule means free to joinNo: no schemaYes
- Tier kept
-
-
15At least one tier?a program needs a tierNo: no schemaYes
- Program kept
-
-
16At least one program?nothing to publish without oneNo: no schemaYes
-
Which organization type?the most specific one that fitsAn online store, an online business or a corporationThat typeAnything elseOrganization
-
Build the restanything optional that is missing or invalid is left out
-
Output the organization with its loyalty programNo 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.
| Input | Needed | What happens |
|---|---|---|
pageRole | Required | Without it, nothing is output. |
organization | Required | Without it, nothing is output.
Inside it: 3 fields
|
memberPrograms | Required | Without it, nothing is output.
Inside each item: 5 fields
|
url, canonicalUrl, indexable, contentVisible | Optional | Without 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.
https://mcp.jakelabate.com/schema-frameworksUse the Schema Frameworks MCP server and its Loyalty Program 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 Loyalty program 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.
| Property | Expects | Notes | |
|---|---|---|---|
| name | Required | Text | The name of the loyalty program. |
| description | Required | Text | The description of the loyalty program, describing the primary benefits for members. |
| hasTiers | Required | MemberProgramTier, can repeat | A loyalty program must have at least one tier. |
| hasTiers.name | Required | Text | The name of the membership tier. |
| hasTiers.hasTierBenefit | Required | Enum, can repeat | The benefits of the tier: TierBenefitLoyaltyPoints and/or TierBenefitLoyaltyPrice. One of: TierBenefitLoyaltyPoints, TierBenefitLoyaltyPrice. |
| hasTiers.hasTierRequirement | Recommended | CreditCard, MonetaryAmount, UnitPriceSpecification or Text | The requirement to join the member tier. A CreditCard with a name (a co-branded card), a MonetaryAmount with value and currency (a minimum spend), a UnitPriceSpecification with price, priceCurrency, billingDuration, billingIncrement and unitCode (a paid membership), or free-form Text. Without a requirement, anyone can join the tier for free. |
| hasTiers.membershipPointsEarned | Recommended | QuantitativeValue | The number of loyalty points earned per currency unit spent. |
| hasTiers.url | Recommended | URL | A URL of the page where a shopper can sign up for this tier. |
| url | Recommended | URL | A URL of the page where a shopper can sign up for the loyalty program. |
Related Page Types And Frameworks
The page types show this framework working inside a full page graph. Each framework card says how it relates to this one.