JSON-LD Type Examples Reference
This article provides examples of JSON-LD types and a brief introduction and explanation. Each type’s example demonstrates how to annotate in JSON-LD, along with a brief explanation. I hope this helps.
This article provides examples of JSON-LD types and a brief introduction and explanation. Each type’s example demonstrates how to annotate in JSON-LD, along with a brief explanation. I hope this helps.
JSON-LD’s main core types
The main core types include some basic and important types in JSON-LD. These types are the basis for building more complex data structures.
Thing
Thing
It is the base class of all types. All types inherit from this class. It is the common parent class of other specific types.
Example :
{
"@context": "https://schema.org",
"@type": "Thing",
"name": "Generic Item"
}
Thing
A type that can be used as a base for other concrete types, typically for common items or things that do not have a clear category.
Creative Work
Refers to any creative work, such as articles, books, movies, music, etc.
Example :
{
"@context": "https://schema.org",
"@type": "CreativeWork",
"name": "The Great Adventure",
"author": "John Doe",
"datePublished": "2025-03-02"
}
CreativeWork
Used to refer to creative works in any form, including literary works, music, movies, etc.
Event
Indicates events such as concerts, competitions, meetings, etc.
Example :
{
"@context": "https://schema.org",
"@type": "Event",
"name": "Tech Conference 2025",
"startDate": "2025-05-01",
"location": {
"@type": "Place",
"name": "Convention Center, City"
}
}
Event
Used to describe a specific event, usually including name, time, location and other information.
Intangible
Represents non-physical things such as brands, currencies, ratings, etc.
Example :
{
"@context": "https://schema.org",
"@type": "Intangible",
"name": "XYZ Corporation",
"brand": "XYZ"
}
Intangible
Used to represent intangible things such as brands, patents, currencies, ratings, etc.
Organization
Indicates an organization, such as a company, non-profit organization, school, etc.
Example :
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Acme Corporation",
"url": "https://www.acme.com"
}
Organization
Used to describe an organization, commonly used for companies, government agencies, non-governmental organizations, etc.
Person
Indicates an individual or public figure.
Example :
{
"@context": "https://schema.org",
"@type": "Person",
"name": "Jane Smith",
"birthDate": "1980-01-01"
}
Person
Used to represent a specific person, including basic personal information such as name, birthday, etc.
Place
Indicates places, such as cities, shops, attractions, etc.
Example :
{
"@context": "https://schema.org",
"@type": "Place",
"name": "Central Park",
"address": "New York, NY"
}
Place
Used to represent a place, usually including information such as address, name, and geographic location.
Product
Indicates a product or service.
Example :
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Smartphone XYZ",
"price": "499.99",
"brand": "TechBrand"
}
Product
Used to indicate specific products or services, including price, brand and other related information.
Action
Indicates user behavior, such as purchase, viewing, comment, etc.
Example :
{
"@context": "https://schema.org",
"@type": "Action",
"name": "Buy Product",
"actionStatus": "Active"
}
Action
Used to describe the user’s behavior or activity, including the name, status, and other information of the behavior.
Articles & News
The “Articles & News” category includes various JSON-LD types for describing different types of articles. These types help to more accurately tag and categorize article content.
Article
The post type is generic and can be used for any type of post. It is suitable for blogs, news sites, etc.
Example :
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "The Importance of Structured Data in SEO",
"author": {
"@type": "Person",
"name": "John Doe"
},
"datePublished": "2025-03-02",
"dateModified": "2025-03-02",
"publisher": {
"@type": "Organization",
"name": "Tech Blog"
},
"description": "An in-depth look at the role of structured data in improving SEO rankings."
}
This is a general post type that is suitable for a variety of different articles, whether they are news, blogs, or other types of creative works. The main fields include headline
(title), author
(author), datePublished
(published date), etc.
Blog Posting
Specifically refers to blog posts. Applicable to articles on blogging platforms and websites.
Example :
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"headline": "How to Optimize Your Blog for Search Engines",
"author": {
"@type": "Person",
"name": "Jane Smith"
},
"datePublished": "2025-02-28",
"publisher": {
"@type": "Organization",
"name": "Jane's Blog"
},
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://janesblog.com/optimize-seo"
}
}
This type of content is particularly suitable for blog posts. It contains a mainEntityOfPage
link to the specific web page of the post.
NewsArticle
Articles suitable for news websites. Used to describe news reports and current events.
Example :
{
"@context": "https://schema.org",
"@type": "NewsArticle",
"headline": "New Tech Company Revolutionizes the Industry",
"author": {
"@type": "Person",
"name": "Alex Green"
},
"datePublished": "2025-03-01",
"publisher": {
"@type": "Organization",
"name": "Global News Network"
},
"articleBody": "This new startup is changing the way technology is perceived in the modern world."
}
NewsArticle
Applicable to news reports, usually contains articleBody
to describe the content of the article. This makes it different from other article types and is specifically used for news reports.
ScholarlyArticle
The academic paper type is used to represent academic research or papers, suitable for journals, conference proceedings, etc.
Example :
{
"@context": "https://schema.org",
"@type": "ScholarlyArticle",
"headline": "Exploring New Methods in Quantum Computing",
"author": {
"@type": "Person",
"name": "Dr. Emily Parker"
},
"datePublished": "2025-01-15",
"journalName": "International Journal of Quantum Physics",
"volumeNumber": "12",
"issueNumber": "4",
"pageStart": "123",
"pageEnd": "145"
}
Used for academic papers, including journal information such as journalName
(journal name), volumeNumber
(volume number), issueNumber
(issue number), etc.
TechArticle
Technical article type, suitable for technical content such as API documentation and programming tutorials.
Example :
{
"@context": "https://schema.org",
"@type": "TechArticle",
"headline": "How to Use the New JavaScript Framework",
"author": {
"@type": "Person",
"name": "Michael Brown"
},
"datePublished": "2025-02-20",
"publisher": {
"@type": "Organization",
"name": "Tech Insights"
},
"articleBody": "In this article, we will walk through the steps of setting up a new JavaScript framework..."
}
Used for technical articles, including technical tutorials, code examples, etc. articleBody
This describes the main content of the article and is suitable for technical articles.
Report
Report type, applicable to formal reports or research reports.
Example :
{
"@context": "https://schema.org",
"@type": "Report",
"headline": "Annual Market Trends Analysis",
"author": {
"@type": "Organization",
"name": "Market Research Ltd."
},
"datePublished": "2025-02-01",
"publisher": {
"@type": "Organization",
"name": "Market Research Reports"
},
"reportNumber": "2025-001",
"content": "This report explores the key trends in the market over the past year..."
}
Applicable to various reports, such as market research reports, annual reports, etc. reportNumber
It is used to identify the report number and content
mainly describes the core content of the report.
Location & Local Business
The “Places & Local Businesses” category covers JSON-LD types used to describe information about places and local businesses. These types help to more accurately present and categorize related data.
Place
Place
Used to indicate places, including cities, shops, attractions, etc.
Example :
{
"@context": "https://schema.org",
"@type": "Place",
"name": "Empire State Building",
"description": "A famous landmark in New York City.",
"address": {
"@type": "PostalAddress",
"streetAddress": "350 5th Ave",
"addressLocality": "New York",
"addressRegion": "NY",
"postalCode": "10118",
"addressCountry": "US"
},
"geo": {
"@type": "GeoCoordinates",
"latitude": "40.748817",
"longitude": "-73.985428"
}
}
This example represents the place “Empire State Building,” which includes the place’s name, description, address, and geographic coordinates.
Local Business
LocalBusiness
Used to represent local businesses such as restaurants, shops, etc.
Example :
{
"@context": "https://schema.org",
"@type": "LocalBusiness",
"name": "Joe's Pizza",
"address": {
"@type": "PostalAddress",
"streetAddress": "123 Pizza St.",
"addressLocality": "New York",
"addressRegion": "NY",
"postalCode": "10001",
"addressCountry": "US"
},
"telephone": "+1-212-555-1234",
"openingHours": "Mo-Su 11:00-23:00",
"sameAs": "http://www.joespizza.com"
}
This example represents a local restaurant called “Joe’s Pizza” and includes the business’s name, address, phone number, hours of operation, and a link to its website.
Landmarks Or Historical Buildings
LandmarksOrHistoricalBuildings
Used to indicate important landmarks or historical buildings.
Example :
{
"@context": "https://schema.org",
"@type": "LandmarksOrHistoricalBuildings",
"name": "The Great Wall of China",
"description": "An ancient fortification built along the northern borders of China.",
"address": {
"@type": "PostalAddress",
"addressLocality": "Beijing",
"addressCountry": "CN"
}
}
This example represents the Great Wall of China and includes a name, description, and location information.
Tourist Attraction
TouristAttraction
Used to indicate tourist attractions, places that attract tourists to visit.
Example :
{
"@context": "https://schema.org",
"@type": "TouristAttraction",
"name": "Eiffel Tower",
"description": "A wrought-iron lattice tower on the Champ de Mars in Paris, France.",
"address": {
"@type": "PostalAddress",
"streetAddress": "Champ de Mars",
"addressLocality": "Paris",
"addressRegion": "Île-de-France",
"postalCode": "75007",
"addressCountry": "FR"
},
"touristType": "Adults"
}
This example represents the Eiffel Tower tourist attraction, including its name, description, address, and appropriate visitor type information.
Restaurant
Restaurant
Used to refer to a restaurant, a place where food and beverage services are provided.
Example :
{
"@context": "https://schema.org",
"@type": "Restaurant",
"name": "The French Laundry",
"cuisine": "French",
"address": {
"@type": "PostalAddress",
"streetAddress": "6640 Washington St",
"addressLocality": "Yountville",
"addressRegion": "CA",
"postalCode": "94599",
"addressCountry": "US"
},
"telephone": "+1-707-944-2380",
"menu": "http://www.frenchlaundry.com/menu",
"priceRange": "$$$$"
}
This example represents a restaurant called “The French Laundry” that serves French cuisine and includes the restaurant’s address, phone number, menu, and price range information.
Hotel
Hotel
Used to refer to hotels, places that provide accommodation services.
Example :
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "The Ritz-Carlton",
"address": {
"@type": "PostalAddress",
"streetAddress": "600 Stockton St",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"postalCode": "94108",
"addressCountry": "US"
},
"telephone": "+1-415-296-7465",
"starRating": {
"@type": "Rating",
"ratingValue": "5",
"bestRating": "5"
},
"amenityFeature": {
"@type": "LocationFeatureSpecification",
"name": "Spa",
"value": "Available"
}
}
This example represents the “Ritz-Carlton” hotel and includes the hotel’s name, address, phone number, star rating, and information about the amenities it offers.
Media & Entertainment
The Media & Entertainment category includes several JSON-LD types for describing different forms of media and entertainment content. These types help to more accurately tag and categorize related content.
Creative Work
Creative works is a broad category that applies to any form of creative content, such as articles, books, movies, music, games, etc.
Example :
{
"@context": "https://schema.org",
"@type": "CreativeWork",
"name": "The Great Gatsby",
"author": "F. Scott Fitzgerald",
"datePublished": "1925",
"genre": "Fiction"
}
This type is used to describe any form of creative content, with attributes such as name, creator, publication date, etc. Applicable to all creative content.
Movie
Used to represent film works, including information such as the film title, director, starring actors, and release date.
Example :
{
"@context": "https://schema.org",
"@type": "Movie",
"name": "Inception",
"director": {
"@type": "Person",
"name": "Christopher Nolan"
},
"actor": [
{
"@type": "Person",
"name": "Leonardo DiCaprio"
},
{
"@type": "Person",
"name": "Joseph Gordon-Levitt"
}
],
"datePublished": "2010-07-16",
"genre": "Science Fiction"
}
This type is specifically used to describe film works and contains key fields such as director, actors, release date, etc.
TV Series
Used to represent TV series, including episodes, broadcast dates, actors, etc.
Example :
{
"@context": "https://schema.org",
"@type": "TVSeries",
"name": "Stranger Things",
"actor": {
"@type": "Person",
"name": "Millie Bobby Brown"
},
"genre": "Science Fiction",
"datePublished": "2016-07-15"
}
This type is used for TV series descriptions, including the title, actors, genre, release date, etc.
MusicAlbum
Used to represent music albums, including album name, artist, release date and other information.
Example :
{
"@context": "https://schema.org",
"@type": "MusicAlbum",
"name": "Reputation",
"byArtist": {
"@type": "MusicGroup",
"name": "Taylor Swift"
},
"datePublished": "2017-11-10",
"genre": "Pop"
}
This type is suitable for music albums and contains album name, artist, genre, release time, etc.
Music Recording
Used to represent a single or other type of musical recording, typically including information about the recorded song or audio file.
Example :
{
"@context": "https://schema.org",
"@type": "MusicRecording",
"name": "Shape of You",
"byArtist": {
"@type": "MusicGroup",
"name": "Ed Sheeran"
},
"datePublished": "2017-01-06",
"genre": "Pop"
}
This type is used to describe a single music recording and includes the song title, artist, release date, and genre.
VideoGame
Used to represent video games, including information such as the game’s title, publisher, and release date.
Example :
{
"@context": "https://schema.org",
"@type": "VideoGame",
"name": "The Legend of Zelda: Breath of the Wild",
"creator": {
"@type": "Organization",
"name": "Nintendo"
},
"datePublished": "2017-03-03",
"genre": "Action-Adventure"
}
This type is used for video game descriptions and includes the game title, developer, release date, and genre.
Podcast Episode
Used to represent a single podcast episode, including information such as the podcast name, host, and release date.
Example :
{
"@context": "https://schema.org",
"@type": "PodcastEpisode",
"name": "How to Start a Business",
"creator": {
"@type": "Person",
"name": "John Doe"
},
"datePublished": "2023-01-15",
"audio": {
"@type": "AudioObject",
"contentUrl": "https://example.com/podcast/episode1.mp3"
}
}
This type is suitable for the description of a single episode of a podcast program, including the program name, host, audio link, etc.
Products & E-commerce
The JSON-LD type under the “Products & E-commerce” category is used to describe e-commerce related information such as products, quotes, and reviews, helping search engines better understand and display e-commerce content.
Product
Product
The type is used to represent a product, service, or other item that can be purchased. This type contains relevant information about the product, such as name, description, brand, price, etc.
Example
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Wireless Headphones",
"image": "https://example.com/photos/1x1/photo.jpg",
"description": "Noise-cancelling wireless headphones with long battery life.",
"brand": {
"@type": "Brand",
"name": "BrandX"
},
"sku": "12345",
"offers": {
"@type": "Offer",
"url": "https://example.com/product/12345",
"priceCurrency": "USD",
"price": "99.99",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock"
}
}
This example shows relevant information about a wireless headset product, including product name, description, brand, price, inventory status, etc. This structured data can help search engines understand and display product information.
Offer
Offer
The type is used to describe one or more offers. It is often Product
used with to display the price, conditions, and purchase options of an item.
Example
{
"@context": "https://schema.org",
"@type": "Offer",
"url": "https://example.com/product/12345",
"priceCurrency": "USD",
"price": "199.99",
"priceValidUntil": "2025-03-10",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"seller": {
"@type": "Organization",
"name": "Example Store"
}
}
This example shows information about a product offer, including price, expiration date, stock status, and seller information. Structured data helps improve the SEO of e-commerce pages.
AggregateOffer
AggregateOffer
The type represents a collection of multiple quotes, often used to display different prices for the same product or purchase options from multiple sellers.
Example
{
"@context": "https://schema.org",
"@type": "AggregateOffer",
"lowPrice": "89.99",
"highPrice": "149.99",
"priceCurrency": "USD",
"offerCount": "5",
"offers": [
{
"@type": "Offer",
"price": "99.99",
"priceCurrency": "USD",
"seller": {
"@type": "Organization",
"name": "Store A"
}
},
{
"@type": "Offer",
"price": "129.99",
"priceCurrency": "USD",
"seller": {
"@type": "Organization",
"name": "Store B"
}
}
]
}
This example lists offers from multiple different sellers, AggregateOffer
aggregating different price ranges and seller information to provide consumers with choices.
Review
Review
The type is used to describe user reviews of products or services, including ratings, review content, reviewer, and other information.
Example
{
"@context": "https://schema.org",
"@type": "Review",
"reviewRating": {
"@type": "Rating",
"ratingValue": "4.5",
"bestRating": "5"
},
"author": {
"@type": "Person",
"name": "John Doe"
},
"reviewBody": "These headphones are excellent for daily use, very comfortable and great sound quality.",
"datePublished": "2025-02-25",
"itemReviewed": {
"@type": "Product",
"name": "Wireless Headphones"
}
}
This example shows a user review, including the rating (4.5/5), the review content, the reviewer’s name, and the date of the review. For e-commerce platforms, displaying reviews can help increase the credibility and appeal of products.
Brand
Brand
Type indicates the brand of the product. It is often Product
used in conjunction with genre to describe the brand name to which the product belongs.
Example
{
"@context": "https://schema.org",
"@type": "Brand",
"name": "BrandX",
"logo": "https://example.com/brandx_logo.jpg"
}
This example shows brand information, including the brand name and logo. Brand information helps consumers better understand the product’s origin and improve brand awareness.
Service
Service
This type is used to represent services that can be provided, rather than physical products. This type is suitable for services such as repair, consulting, and design.
Example
{
"@context": "https://schema.org",
"@type": "Service",
"serviceType": "Web Design",
"provider": {
"@type": "Organization",
"name": "DesignAgency"
},
"offers": {
"@type": "Offer",
"priceCurrency": "USD",
"price": "500.00",
"url": "https://example.com/web-design"
}
}
This example shows a service (web design service), including the service type, provider, and price. The service description helps potential customers understand the types of services available and their prices.
MerchantReturnPolicy
MerchantReturnPolicy
The type represents the merchant’s return policy. It helps consumers understand how returns or refunds are handled after a purchase.
Example
{
"@context": "https://schema.org",
"@type": "MerchantReturnPolicy",
"returnPolicyCategory": "https://schema.org/ReturnOnly",
"returnPolicyLabel": "30-Day Return Policy",
"returnPolicySeasonalOverride": "https://schema.org/SeasonalReturnPolicy",
"url": "https://example.com/return-policy"
}
This example shows a merchant’s return policy, including return categories and return periods. Displaying this information can help build consumer trust and reduce uncertainty when making a purchase.
Event
The event type ( Event
) is used to represent any type of event, including conferences, concerts, festivals, sporting events, and more. By marking up event information in structured data, you can help search engines better understand and surface relevant content.
Event (generic event type)
Used to indicate a general event, applicable to any activity that does not fall into a specific subcategory.
Example:
{
"@context": "http://schema.org",
"@type": "Event",
"name": "Spring Festival",
"startDate": "2025-04-10T19:00:00",
"endDate": "2025-04-10T23:59:59",
"location": {
"@type": "Place",
"name": "City Park",
"address": {
"@type": "PostalAddress",
"streetAddress": "123 Park Avenue",
"addressLocality": "Shenzhen",
"addressRegion": "Guangdong",
"postalCode": "518000",
"addressCountry": "CN"
}
},
"description": "A celebration of the traditional Spring Festival with music, food, and fun activities for all ages."
}
This example represents a spring festival event, including the event name, start and end time, event location, and detailed address information.
Festival
Used to mark festivals or carnival-like events, such as music festivals, cultural festivals, etc.
Example:
{
"@context": "http://schema.org",
"@type": "Festival",
"name": "Shenzhen Music Festival",
"startDate": "2025-06-20T18:00:00",
"endDate": "2025-06-22T23:00:00",
"location": {
"@type": "Place",
"name": "Shenzhen Convention Center",
"address": {
"@type": "PostalAddress",
"streetAddress": "1 Convention Road",
"addressLocality": "Shenzhen",
"addressRegion": "Guangdong",
"postalCode": "518100",
"addressCountry": "CN"
}
},
"description": "An annual music festival bringing together artists from all over the world."
}
This is an example of a music festival event, which specifically describes the time, location, and content of the festival.
SportsEvent
Used to indicate sports events, such as football games, basketball games, etc.
Example:
{
"@context": "http://schema.org",
"@type": "SportsEvent",
"name": "Shenzhen Open Tennis Tournament",
"startDate": "2025-07-15T09:00:00",
"endDate": "2025-07-20T18:00:00",
"location": {
"@type": "Place",
"name": "Shenzhen Tennis Center",
"address": {
"@type": "PostalAddress",
"streetAddress": "789 Sports Road",
"addressLocality": "Shenzhen",
"addressRegion": "Guangdong",
"postalCode": "518001",
"addressCountry": "CN"
}
},
"description": "A prestigious tennis tournament attracting top international players."
}
This example displays a sports event, the Shenzhen Open Tennis Tournament, and shows the time, location, and event details.
BusinessEvent
Used to indicate business-related activities, such as conferences, industry exhibitions, press conferences, etc.
Example:
{
"@context": "http://schema.org",
"@type": "BusinessEvent",
"name": "Global Business Expo",
"startDate": "2025-05-05T10:00:00",
"endDate": "2025-05-07T17:00:00",
"location": {
"@type": "Place",
"name": "Shenzhen International Exhibition Center",
"address": {
"@type": "PostalAddress",
"streetAddress": "200 Exhibition Road",
"addressLocality": "Shenzhen",
"addressRegion": "Guangdong",
"postalCode": "518500",
"addressCountry": "CN"
}
},
"description": "A global business expo showcasing the latest innovations in technology and entrepreneurship."
}
This is an example of a global business expo, highlighting the time, location, and nature of the event.
MusicEvent (Concert)
Used to represent music-related events, such as concerts, music festivals, etc.
Example:
{
"@context": "http://schema.org",
"@type": "MusicEvent",
"name": "Shenzhen Symphony Orchestra Concert",
"startDate": "2025-08-01T20:00:00",
"endDate": "2025-08-01T22:00:00",
"location": {
"@type": "Place",
"name": "Shenzhen Concert Hall",
"address": {
"@type": "PostalAddress",
"streetAddress": "456 Music Road",
"addressLocality": "Shenzhen",
"addressRegion": "Guangdong",
"postalCode": "518200",
"addressCountry": "CN"
}
},
"description": "A classical music concert by the Shenzhen Symphony Orchestra featuring Beethoven's 9th Symphony."
}
This example shows a concert of the Shenzhen Symphony Orchestra, including the performance time, location, and music content.
TheaterEvent (Drama Performance)
Used to indicate a play or theatrical performance.
Example:
{
"@context": "http://schema.org",
"@type": "TheaterEvent",
"name": "Shenzhen Broadway Musical",
"startDate": "2025-09-10T19:30:00",
"endDate": "2025-09-12T22:00:00",
"location": {
"@type": "Place",
"name": "Shenzhen Drama Theater",
"address": {
"@type": "PostalAddress",
"streetAddress": "101 Drama Street",
"addressLocality": "Shenzhen",
"addressRegion": "Guangdong",
"postalCode": "518300",
"addressCountry": "CN"
}
},
"description": "A Broadway-style musical performance featuring classic show tunes."
}
This is an example of a play performance, which specifically describes the time, location, and content of the performance.
EducationEvent
Used to indicate education-related activities, such as seminars, lectures, training, etc.
Example:
{
"@context": "http://schema.org",
"@type": "EducationEvent",
"name": "AI & Machine Learning Workshop",
"startDate": "2025-10-15T10:00:00",
"endDate": "2025-10-15T16:00:00",
"location": {
"@type": "Place",
"name": "Shenzhen Technology Institute",
"address": {
"@type": "PostalAddress",
"streetAddress": "321 Innovation Avenue",
"addressLocality": "Shenzhen",
"addressRegion": "Guangdong",
"postalCode": "518400",
"addressCountry": "CN"
}
},
"description": "A one-day workshop focused on the basics of AI and machine learning, with hands-on coding sessions."
}
This example represents an educational event, an AI and Machine Learning Workshop, and describes in detail the time, location, and educational content of the event.
Structured Data & Search Optimization
The JSON-LD type under the “Structured Data & Search Optimization” category helps improve the display of web pages in search engines and enables search engines to better understand the content of the page through structured markup.
BreadcrumbList (breadcrumb navigation)
It is used to display the path of the page, helping search engines understand the hierarchical structure of the page and helping to improve SEO results.
Example :
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "首页",
"item": "https://www.example.com/"
},
{
"@type": "ListItem",
"position": 2,
"name": "产品",
"item": "https://www.example.com/products"
},
{
"@type": "ListItem",
"position": 3,
"name": "智能手机",
"item": "https://www.example.com/products/smartphones"
}
]
}
This example shows a page hierarchy, with breadcrumbs from the home page to the smartphone page.
FAQPage
Used to mark up FAQ (Frequently Asked Questions) pages and improve the richness of Google search results through structured data.
Example :
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "如何注册账户?",
"acceptedAnswer": {
"@type": "Answer",
"text": "您可以点击网站右上角的“注册”按钮,然后填写您的个人信息完成注册。"
}
},
{
"@type": "Question",
"name": "如何重置密码?",
"acceptedAnswer": {
"@type": "Answer",
"text": "点击“忘记密码”,输入您的注册邮箱后,我们会发送重置链接到您的邮箱。"
}
}
]
}
This example marks up a FAQ page that contains common questions and answers about how to register and reset your password.
HowTo
Used to show steps on how to perform a task, typically used in guides or tutorials.
Example :
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "如何更换轮胎",
"step": [
{
"@type": "HowToStep",
"name": "抬起汽车",
"text": "使用千斤顶将汽车抬起,确保车轮完全离开地面。"
},
{
"@type": "HowToStep",
"name": "拆卸旧轮胎",
"text": "使用扳手拆下固定轮胎的螺丝,取下旧轮胎。"
},
{
"@type": "HowToStep",
"name": "安装新轮胎",
"text": "将新轮胎放上去,并用螺丝固定。"
}
]
}
This example shows a “How to Change a Tire” guide, which includes specific steps and operation descriptions.
QAPage (Question and Answer Page)
Suitable for forums, Q&A sites, or any Q&A-based content to help improve the visibility of your page in search.
Example :
{
"@context": "https://schema.org",
"@type": "QAPage",
"mainEntity": {
"@type": "Question",
"name": "如何学习Python编程语言?",
"acceptedAnswer": {
"@type": "Answer",
"text": "要学习Python编程语言,您可以从在线教程、书籍或参加课程开始,实践是掌握Python的关键。"
}
}
}
This example shows a question-and-answer page with the question “How do I learn the Python programming language?” and recommended answers.
Rating
Used to rate products, services, or other items, usually used in conjunction with user reviews.
Example :
{
"@context": "https://schema.org",
"@type": "Rating",
"ratingValue": "4.5",
"bestRating": "5",
"worstRating": "1"
}
This example shows a rating data with a rating value of 4.5, a maximum rating of 5, and a minimum rating of 1.
AggregateRating
Used to represent the combined result of multiple user ratings, usually used in product or service rating systems.
Example :
{
"@context": "https://schema.org",
"@type": "AggregateRating",
"ratingValue": "4.5",
"reviewCount": "150"
}
This example shows aggregate rating data, where the product or service has an average rating of 4.5 and 150 reviews.
Other subcategories
The “Other subcategory” includes some JSON-LD types used to describe websites, web pages, search operations, educational and career programs, and recruitment information, enriching the application scenarios of structured data.
WebSite
WebSite
The type is used to define the metadata of the entire website, including the website name, homepage link, description, etc. This type is suitable for structural data at the website level.
Example :
{
"@context": "https://schema.org",
"@type": "WebSite",
"name": "axiaoxin.com",
"url": "https://www.axiaoxin.com",
"description": "阿小信的个人主页",
"publisher": {
"@type": "Organization",
"name": "axiaoxin.com"
}
}
This is basic information that describes the entire website, such as the name, URL, and description, as well as publisher information.
WebPage
WebPage
Types are used to define metadata for a specific web page. Each individual web page can use this type.
Example :
{
"@context": "https://schema.org",
"@type": "WebPage",
"name": "axiaoxin",
"url": "https://www.axiaoxin.com/pageurl",
"description": "网页描述",
"mainEntityOfPage": "https://www.axiaoxin.com"
}
A description of a single web page that can include metadata such as the page’s title, URL, and description.
SearchAction
SearchAction
The search type is used to define the search operation of the website. You can embed a search box or function in a web page.
Example :
{
"@context": "https://schema.org",
"@type": "SearchAction",
"target": "https://www.axiaoxin.com/search?q={search_term}",
"query-input": "required name=search_term"
}
This type describes a search operation, including the URL of the search request and placeholders for search terms.
Educational Occupational Program
EducationalOccupationalProgram
Types are used to define metadata about education and vocational training programs.
Example :
{
"@context": "https://schema.org",
"@type": "EducationalOccupationalProgram",
"name": "数据分析培训课程",
"educationalCredentialAwarded": "数据分析师证书",
"provider": {
"@type": "Organization",
"name": "人言兑教育机构"
},
"educationalCredentialAwarded": "证书",
"educationalCredentialLevel": "中级"
}
This type is used to describe educational or vocational training courses offered and typically includes information such as the course title, certificate type, and provider.
JobPosting
JobPosting
Types are used to define job postings and can provide structured data on job descriptions, recruiting companies, etc.
Example :
{
"@context": "https://schema.org",
"@type": "JobPosting",
"title": "数据分析师",
"description": "负责分析公司数据,提供决策支持。",
"datePosted": "2025-03-01",
"hiringOrganization": {
"@type": "Organization",
"name": "人言兑科技公司",
"sameAs": "https://www.axiaoxin.com"
},
"jobLocation": {
"@type": "Place",
"address": {
"@type": "PostalAddress",
"streetAddress": "深圳市南山区科技园",
"addressLocality": "深圳",
"addressRegion": "广东",
"postalCode": "518000"
}
}
}
This type is used to describe recruitment information for a position, including information such as position title, company, job description, recruitment time and work location.
Conclusion
The above summarizes various usage examples, introductions, and explanations of JSON-LD types. By properly utilizing these different types of JSON-LD structured data, web content can be more accurately and richly displayed in search engines, improving website visibility and user experience. Understanding and mastering the use of JSON-LD types is crucial for content creators, website developers, and e-commerce practitioners. As search engine algorithms continue to evolve and improve, support for and emphasis on structured data is also increasing. Therefore, continuously monitoring updates to JSON-LD standards and specifications, and promptly adjusting and optimizing your website’s structured data, will help maintain your website’s competitiveness in search results.
For more information about JSON-LD, please refer to:
IT Resource Hub » JSON-LD Type Examples Reference