App Page Schema
The page for one app: a MobileApplication with its price, operating systems, rating and reviews, published by the Organization from the homepage.
When To Use It
Use on the page that presents one app: what it does, what it runs on, what it costs and how people rate it. That is what makes the page eligible for the software app result, with the rating and price in the listing.
Google needs a name, a price and a rating or a review. A free app states a price of 0. Without all three the builder outputs nothing, since a half-described app earns no result.
Frameworks On This Page
Each card opens the framework for that feature, with its own rules and property reference. Cards marked "Linked by @id" are defined on the homepage and only referenced here.
Software App
On this page. MobileApplication with price, operating system and category. Schema framework OpenReview Snippet
On this page. The aggregate rating and the reviews, shown as stars. Schema framework OpenBreadcrumb
On this page. Home, Trail Log App. Schema framework OpenOrganization
Linked by @id. Publisher of the app, by @id from the homepage. Schema framework OpenHow The Pieces Connect
Every node has a stable @id. A node is written out once, where it belongs, and everywhere else it is referenced by that @id alone. This is the map for this page, generated from the output below.
| @id | Defined on | Type | Referenced by |
|---|---|---|---|
/app/#webpage | This page | WebPage | Top-level node |
/app/#breadcrumb | This page | BreadcrumbList | WebPage.breadcrumb |
/app/#app | This page | MobileApplication | WebPage.mainEntity |
/#organization | Homepage | OnlineStore | MobileApplication.publisher |
/#website | Homepage | WebSite | WebPage.isPartOf |
The Builder
One function turns the page's data into the whole graph. It drops anything Google would reject instead of shipping it half built. The input below includes rows it is meant to drop, so you can see the logic work.
// App page schema: the page for one app. A MobileApplication, WebApplication
// or SoftwareApplication with its price, rating and reviews, published by
// the Organization from the homepage, plus the page's WebPage and
// BreadcrumbList.
//
// Google needs a name, a price (0 for a free app) and a rating or a review.
// Without all three there is no rich result, so the builder outputs nothing.
const CURRENCY = /^[A-Z]{3}$/;
const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
const clean = (v) => (typeof v === 'string' ? v.trim() : v);
const isUrl = (v) => typeof v === 'string' && /^https:\/\/[^\s]+$/.test(v);
const compact = (obj) => {
if (Array.isArray(obj)) {
const out = obj.map(compact).filter((v) => v !== undefined);
return out.length ? out : undefined;
}
if (obj && typeof obj === 'object') {
const out = {};
for (const [k, v] of Object.entries(obj)) {
const c = compact(v);
if (c !== undefined) out[k] = c;
}
return Object.keys(out).length ? out : undefined;
}
return obj === null || obj === '' ? undefined : obj;
};
function breadcrumb(trail, id) {
const items = (trail || []).filter((c) => c.name && isUrl(c.url));
if (items.length < 2) return undefined;
return {
'@type': 'BreadcrumbList',
'@id': id,
itemListElement: items.map((c, i) => ({ '@type': 'ListItem', position: i + 1, name: clean(c.name), item: c.url })),
};
}
const num = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : null);
// A rating only counts with a score inside its scale and a count above zero.
function aggregateRating(r) {
if (!r) return undefined;
const best = num(r.best) ?? 5;
const worst = num(r.worst) ?? 1;
const value = num(r.value);
if (value === null || worst >= best || value < worst || value > best) return undefined;
if (!(num(r.count) > 0)) return undefined;
return { '@type': 'AggregateRating', ratingValue: value, bestRating: best, worstRating: worst, ratingCount: r.count };
}
// A review needs a named author and a score inside its scale.
function review(r) {
const author = clean(r.author);
const best = num(r.best) ?? 5;
const worst = num(r.worst) ?? 1;
const value = num(r.rating);
if (!author || author.length >= 100) return undefined;
if (value === null || worst >= best || value < worst || value > best) return undefined;
return compact({
'@type': 'Review',
author: { '@type': 'Person', name: author },
reviewRating: { '@type': 'Rating', ratingValue: value, bestRating: best, worstRating: worst },
datePublished: ISO_DATE.test(r.date || '') ? r.date : undefined,
reviewBody: clean(r.text),
});
}
const APP_TYPES = { mobile: 'MobileApplication', web: 'WebApplication' };
const APP_CATEGORIES = [
'GameApplication', 'SocialNetworkingApplication', 'TravelApplication', 'ShoppingApplication',
'SportsApplication', 'LifestyleApplication', 'BusinessApplication', 'DesignApplication',
'DeveloperApplication', 'DriverApplication', 'EducationalApplication', 'HealthApplication',
'FinanceApplication', 'SecurityApplication', 'BrowserApplication', 'CommunicationApplication',
'DesktopEnhancementApplication', 'EntertainmentApplication', 'MultimediaApplication',
'HomeApplication', 'UtilitiesApplication', 'ReferenceApplication',
];
function buildAppPageSchema(source) {
const site = source.site || {};
const page = source.page || {};
const app = source.app || {};
if (!isUrl(site.url) || !isUrl(page.url) || !app.name) return null;
// A free app states a price of 0. A paid one needs its currency.
const price = num(app.price);
if (price === null || price < 0) return null;
const currency = CURRENCY.test(app.currency || '') ? app.currency : undefined;
if (price > 0 && !currency) return null;
const rating = aggregateRating(app.rating);
const reviews = (app.reviews || []).map(review).filter(Boolean);
if (!rating && !reviews.length) return null;
const root = site.url.replace(/\/+$/, '');
const pageUrl = page.url;
const appId = `${pageUrl}#app`;
// A game is typed as a VideoGame and an app: VideoGame alone is not eligible.
const base = APP_TYPES[app.platform] || 'SoftwareApplication';
const software = compact({
'@type': app.isGame ? ['VideoGame', base] : base,
'@id': appId,
name: clean(app.name),
description: clean(app.description),
url: pageUrl,
image: (app.images || []).filter(isUrl),
operatingSystem: clean(app.operatingSystem),
applicationCategory: APP_CATEGORIES.includes(app.category) ? app.category : undefined,
softwareVersion: clean(app.version),
downloadUrl: (app.storeLinks || []).filter(isUrl),
offers: { '@type': 'Offer', price, priceCurrency: currency },
aggregateRating: rating,
review: reviews,
publisher: { '@id': `${root}/#organization` },
});
const crumbs = breadcrumb(page.breadcrumbs, `${pageUrl}#breadcrumb`);
const webpage = compact({
'@type': 'WebPage',
'@id': `${pageUrl}#webpage`,
url: pageUrl,
name: clean(page.title) || clean(app.name),
isPartOf: { '@id': `${root}/#website` },
breadcrumb: crumbs ? { '@id': crumbs['@id'] } : undefined,
mainEntity: { '@id': appId },
});
return { '@context': 'https://schema.org', '@graph': [webpage, crumbs, software].filter(Boolean) };
}
{
"site": {
"url": "https://www.example.com"
},
"page": {
"url": "https://www.example.com/app/",
"title": "Trail Log App | Harbor & Pine",
"breadcrumbs": [
{
"name": "Home",
"url": "https://www.example.com/"
},
{
"name": "Trail Log App",
"url": "https://www.example.com/app/"
}
]
},
"app": {
"name": "Harbor & Pine Trail Log",
"description": "Log hikes, track gear wear and get care reminders for the kit you own.",
"platform": "mobile",
"isGame": false,
"operatingSystem": "iOS 16, Android 10",
"category": "SportsApplication",
"version": "3.2.0",
"images": [
"https://www.example.com/img/app/trail-log-icon.png",
"https://www.example.com/img/app/trail-log-screens.jpg"
],
"storeLinks": [
"https://apps.apple.com/us/app/example/id0000000000",
"https://play.google.com/store/apps/details?id=com.example.traillog"
],
"price": 0,
"currency": "USD",
"rating": {
"value": 4.7,
"count": 2318
},
"reviews": [
{
"author": "Dana Whitfield",
"rating": 5,
"date": "2026-08-14",
"text": "The gear care reminders saved my rain shell."
},
{
"author": "",
"rating": 4,
"date": "2026-09-02",
"text": "Good offline maps."
},
{
"author": "Luis Ortega",
"rating": 7,
"date": "2026-09-20",
"text": "Seven stars if I could."
}
]
}
}
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "WebPage",
"@id": "https://www.example.com/app/#webpage",
"url": "https://www.example.com/app/",
"name": "Trail Log App | Harbor & Pine",
"isPartOf": {
"@id": "https://www.example.com/#website"
},
"breadcrumb": {
"@id": "https://www.example.com/app/#breadcrumb"
},
"mainEntity": {
"@id": "https://www.example.com/app/#app"
}
},
{
"@type": "BreadcrumbList",
"@id": "https://www.example.com/app/#breadcrumb",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://www.example.com/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Trail Log App",
"item": "https://www.example.com/app/"
}
]
},
{
"@type": "MobileApplication",
"@id": "https://www.example.com/app/#app",
"name": "Harbor & Pine Trail Log",
"description": "Log hikes, track gear wear and get care reminders for the kit you own.",
"url": "https://www.example.com/app/",
"image": [
"https://www.example.com/img/app/trail-log-icon.png",
"https://www.example.com/img/app/trail-log-screens.jpg"
],
"operatingSystem": "iOS 16, Android 10",
"applicationCategory": "SportsApplication",
"softwareVersion": "3.2.0",
"downloadUrl": [
"https://apps.apple.com/us/app/example/id0000000000",
"https://play.google.com/store/apps/details?id=com.example.traillog"
],
"offers": {
"@type": "Offer",
"price": 0,
"priceCurrency": "USD"
},
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": 4.7,
"bestRating": 5,
"worstRating": 1,
"ratingCount": 2318
},
"review": [
{
"@type": "Review",
"author": {
"@type": "Person",
"name": "Dana Whitfield"
},
"reviewRating": {
"@type": "Rating",
"ratingValue": 5,
"bestRating": 5,
"worstRating": 1
},
"datePublished": "2026-08-14",
"reviewBody": "The gear care reminders saved my rain shell."
}
],
"publisher": {
"@id": "https://www.example.com/#organization"
}
}
]
}
The Logic As A Flowchart
The same logic as the builder above, 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: 30 test cases, all passing.
-
A page for one app
-
1Site has an https URL?the home page addressNo: no schemaYes
-
2Page has an https URL?the address of this pageNo: no schemaYes
-
3App has a name?the name of the appNo: no schemaYes
-
4Has a price?a number, 0 for a free appNo: no schemaYes
-
5A paid app has a currency?a 3-letter code such as USDNo: no schemaYes
-
6Has a rating or a review?a score with a count, or a review with a named authorNo: no schemaYes
-
Two or more breadcrumbs with a name and an https link?the trail shown on the pageYesA BreadcrumbList is added and linked from the pageNoNo BreadcrumbList
-
Build the linked nodesWebPage and the app, with its publisher pointing at the homepage Organization by @id. Anything optional that is missing or invalid is left out
-
Output WebPage and the appNo schema
Validation
The output above was run through the SchemaCDN validator, which checks every rule in Google's documentation for each feature. It was validated together with the homepage graph, so the @id links resolve. Result: no errors, and eligible for:
Left Out On Purpose
- A currency on a free app when none is given. The builder does not make one up.
- File size, permissions and release notes. Google does not use them, and they change with every release.
- A separate node per app store. The store links sit on the one app as downloadUrl.
Implementation Checklist
- State the price the page shows, as a number. A free app is 0, not blank.
- Use ratings from real users of this app, and show the same score and count on the page.
- Give every review a named author. A review without one is dropped.
- Name the operating systems with their lowest supported versions.
- Update the rating and the version when a release ships.