Skip to content

Schema Types for Rich Results

Which schema.org types Google shows, and what each needs.

About Schema types for rich results

Structured data describes a page in a machine-readable way, usually as JSON-LD in a script tag using the schema.org vocabulary. Google uses it to understand pages and, for a limited set of types, to show rich results: stars under a product, event dates, recipe images, job listings and breadcrumbs in place of the URL. Schema.org defines hundreds of types, but only the ones in Google's search gallery can produce a rich result in Google Search.

Valid markup makes a page eligible, not guaranteed: Google decides whether to show a rich result based on the query, the page's quality and its own policies, and the markup must describe content that is visible on the page. The list has also shrunk. How-to results were dropped in 2023, the sitelinks search box in 2024, several smaller features in 2025, and FAQ results, which had been limited to government and health sites since 2023, stopped appearing in May 2026. The required properties below are a summary; check Google's page for each type before you deploy.

Last reviewed against the sources below.

37 entries

Rich result types Google supports

From Google's search gallery, October 2026.

Featureschema.org typeRequired properties (summary)Note
ArticleArticle, NewsArticle, BlogPostingNone required. Recommended: headline, image, datePublished, dateModified, authorHelps Google show a better title, image and date
Book actionsBook (editions with ReadAction or BorrowAction)author, name, url, workExample editions with bookFormat, inLanguage, isbn and potentialActionFor book providers with a wide catalog, by registering interest. A June 2025 phase-out notice was removed in November 2025
BreadcrumbBreadcrumbListitemListElement: ListItem entries with position, name and item (item optional on the last one)Shows the page's position in the site hierarchy. Desktop only
CarouselItemListitemListElement: ListItem entries with position and url (or the full item)Only with Course, Movie, Recipe or Restaurant items
Course listCoursename, descriptionCourse info (the single-course feature) was retired in 2025
DatasetDatasetname, descriptionFor Google Dataset Search
Discussion forumDiscussionForumPostingauthor (with name), datePublished, and text, image or videoFor forum threads and social posts written by users
Education Q&AQuizhasPart: Question items, each with an answerFlashcard-style study questions
Employer aggregate ratingEmployerAggregateRatingitemReviewed (Organization), ratingValue, ratingCount or reviewCountRatings of a company as an employer
EventEventname, startDate, location (a Place with an address)Physical venues only since June 2025; virtual-only events aren't supported
Image metadataImageObjectcontentUrl, plus creator, creditText, copyrightNotice or licenseShows licensing details in Google Images
Job postingJobPostingtitle, description, datePosted, hiringOrganization, jobLocation (or remote-work properties)Remove or expire the markup when the job closes
Local businessLocalBusiness or a subtypename, addressYour Business Profile matters more for local results
Loyalty programMemberProgram (under Organization)name, description, hasTiers: MemberProgramTier entries with name and hasTierBenefitAdded June 2025 for member prices and benefits; in a limited list of countries
Math solverMathSolver, LearningResourceurl, usageInfo, potentialAction (SolveMathAction)For sites that solve math problems
MovieMovie (in an ItemList)name, imageShown as a carousel of movies
OrganizationOrganization or a subtypeNone required. Recommended: name, url, logo, sameAsHelps Google understand the organization behind a site
ProductProductname, plus review, aggregateRating or offersMerchant listings also need image and offers with price and currency. Adult-oriented products must carry hasAdultConsideration (May 2026)
Product variantsProductGroup (with hasVariant), or Product with isVariantOfname on the ProductGroup; productGroupID, variesBy and hasVariant describe the variantsDocumented on its own page since June 2025
Profile pageProfilePagemainEntity: a Person or Organization with nameFor pages about a single creator
Q&AQAPagemainEntity: Question with name, answerCount and an accepted or suggested Answer with textOnly for pages with one question and user answers
RecipeRecipename, imageRecommended: ingredients, instructions, cook time, ratings
Return policyMerchantReturnPolicy (Organization hasMerchantReturnPolicy, or on an Offer)applicableCountry and returnPolicyCategory, or merchantReturnLinkStore-wide policies go under Organization (clarified July 2025); Search Console or Merchant Center settings take precedence
Review snippetReview, AggregateRatingitemReviewed, the rating value, and author (Review) or ratingCount/reviewCount (AggregateRating)Self-serving reviews of your own business aren't shown for LocalBusiness and Organization
Shipping policyShippingService (Organization hasShippingService)shippingConditionsA store-wide shipping policy, documented November 2025; Search Console or Merchant Center settings take precedence
Software appSoftwareApplicationname, offers.price, plus aggregateRating or reviewRecommended: applicationCategory, operatingSystem
Speakablespeakable (on Article or WebPage)cssSelector or xpathBeta, for news publishers, in US English
Subscription and paywalled contentCreativeWork typesisAccessibleForFree, hasPart with cssSelector for the paywalled sectionKeeps paywalls from being treated as cloaking
Vacation rentalVacationRentalcontainsPlace (Accommodation with occupancy), identifier, image, latitude, longitude, nameFor approved vacation rental partners
VideoVideoObjectname, thumbnailUrl, uploadDateRecommended: description, duration, contentUrl or embedUrl

Retired rich results

The markup is still valid schema.org, but Google no longer shows these features.

Featureschema.org typeWhat happened
FAQFAQPageLimited to well-known government and health sites from August 2023, then no longer shown in Google Search from May 2026 (May 7). Documentation removed June 15, 2026
How-toHowToDeprecated in September 2023; no longer shown
Sitelinks search boxWebSite + SearchActionRetired in November 2024
Special announcementSpecialAnnouncementDeprecated from July 31, 2025 (notice added April 2025); documentation removed September 2025
Claim reviewClaimReviewPhase-out from Google Search announced June 2025. The documentation stays up because Google's Fact Check Explorer still supports the markup
Course info, Estimated salary, Learning video, Vehicle listingCourse, Occupation, LearningResource, CarPhase-out announced June 2025; documentation removed September 2025
Practice problemsQuizDeprecation notice November 2025; documentation removed January 2026

Good to know

Test before you ship

Google's Rich Results Test shows which features a page is eligible for, and Search Console's enhancement reports show errors across the site. A syntax check like our schema validator catches broken JSON and missing basics, but only Google's tools can confirm eligibility.

Markup must match the page

Marking up content users can't see, such as reviews that aren't on the page or a price that differs from the visible one, is against Google's structured data guidelines and can lead to a manual action.

Sources

Search engines and AI companies change their documentation often; check the source before relying on a detail.

More references