# Schema Property Reference Guide

> Copy-ready code snippets to boost your schema quality score. No fluff. Just the exact properties you need to paste into your schema.

*Source: [SuperSchema](https://superschema.ai/schema-markup/improve-quality-score) | Last updated: 2026-08-27*

---

## Schema Property Reference

Copy-ready code snippets to boost your schema quality score. No fluff. Just the exact properties you need to paste into your schema.

**Key Features:**
- Copy & Paste Ready
- Improve your score
- No Technical Knowledge Required

## How to Use This Guide

### Step 1: Find Your Schema Type

Scroll to the section for your content type (Article, Product, Organization, etc.)

### Step 2: Copy the Snippet

Click the copy button on any property you want to add

### Step 3: Paste & Customize

Replace placeholder values with your real content and regenerate

## How These Properties Affect Your Score

SuperSchema grades each schema type against its own rubric, not a universal point list. Each type weights required properties, recommended properties, advanced AEO properties, and content quality differently. An Organization schema, for example, weights required properties higher and content quality lower than an Article does. For article types specifically, advanced AEO properties like articleSection, wordCount, and inLanguage carry as much weight as recommended properties like description and publisher, so both are worth finishing.

The score also checks specific claims, like your headline, dates, and word count, against the real content on your page. Properties backed by real, verifiable data raise the score. Properties filled with invented or unverifiable data get caught by that check and lower the score instead, so only add a property below if you can back it with something true on your page.

## Article & BlogPosting Schema

Perfect for blog posts, news articles, and editorial content. These properties help search engines understand your content and display it in rich results.

### Recommended Article Properties

#### Author (Structured) (Required property)

Structured author with profile links for maximum credibility

```json
"author": {
  "@type": "Person",
  "name": "Your Name",
  "url": "https://yoursite.com/author/yourname",
  "sameAs": [
    "https://twitter.com/yourhandle",
    "https://linkedin.com/in/yourprofile"
  ]
}
```

#### Publisher (With Logo) (Recommended property)

Organization info with logo for rich results

```json
"publisher": {
  "@type": "Organization",
  "name": "Your Company Name",
  "logo": {
    "@type": "ImageObject",
    "url": "https://yoursite.com/logo.png",
    "width": 600,
    "height": 60
  },
  "url": "https://yoursite.com"
}
```

#### Dates (Published & Modified) (Required and recommended)

When the article was published and last updated

```json
"datePublished": "2024-11-06T08:00:00-05:00",
"dateModified": "2024-11-06T14:30:00-05:00"
```

#### Description (Recommended property)

100-150 character summary (this becomes your search preview)

```json
"description": "Your 100-150 character summary here that describes the article content clearly and concisely for search results."
```

#### Image (Structured) (Recommended property)

Featured image with dimensions for better display

```json
"image": {
  "@type": "ImageObject",
  "url": "https://yoursite.com/featured-image.jpg",
  "width": 1200,
  "height": 630,
  "caption": "Descriptive image caption"
}
```

#### URL (Improves completeness)

The canonical URL of this article

```json
"url": "https://yoursite.com/your-article-url"
```

### Advanced Article Properties

#### Keywords (Array) (Improves completeness)

3-5 main topics for better topical relevance

```json
"keywords": ["topic 1", "topic 2", "topic 3", "topic 4", "topic 5"]
```

#### About (Improves completeness)

The main subject matter of the article

```json
"about": {
  "@type": "Thing",
  "name": "Main Topic",
  "description": "What this article is primarily about"
}
```

#### Article Section (Advanced property)

The category or section this article belongs to

```json
"articleSection": "Your Category Name"
```

#### Word Count (Advanced property)

Total words in the article

```json
"wordCount": 1500
```

#### Language (Advanced property)

Content language code

```json
"inLanguage": "en-US"
```

#### Mentions (Improves completeness)

Related topics or entities mentioned in the article

```json
"mentions": [
  {
    "@type": "Thing",
    "name": "Related Topic 1"
  },
  {
    "@type": "Thing",
    "name": "Related Topic 2"
  }
]
```

#### Main Entity (Recommended property)

The primary entity this page is about

```json
"mainEntityOfPage": {
  "@type": "WebPage",
  "@id": "https://yoursite.com/your-article-url"
}
```

## Product Schema

Essential for e-commerce pages, product listings, and review sites. These properties enable rich product snippets in search results.

### Recommended Product Properties

#### Description (Recommended property)

100-150 character product description

```json
"description": "Clear product description between 100-150 characters for optimal display in search results."
```

#### Image (Multiple) (Recommended property)

Product images (multiple recommended)

```json
"image": [
  "https://yoursite.com/product-image-1.jpg",
  "https://yoursite.com/product-image-2.jpg",
  "https://yoursite.com/product-image-3.jpg"
]
```

#### Brand (Recommended property)

The brand or manufacturer

```json
"brand": {
  "@type": "Brand",
  "name": "Your Brand Name"
}
```

#### SKU & Identifiers (Recommended and advanced)

Product identifiers for better matching

```json
"sku": "ABC-123",
"gtin": "00000000000000",
"mpn": "MANUFACTURER-PART-NUMBER"
```

### Advanced Product Properties

#### Aggregate Rating (Advanced property)

Overall customer ratings, so an assistant can quote a rating and compare your product to others

```json
"aggregateRating": {
  "@type": "AggregateRating",
  "ratingValue": "4.5",
  "reviewCount": "89",
  "bestRating": "5",
  "worstRating": "1"
}
```

#### Individual Review (Advanced property)

Sample customer review

```json
"review": {
  "@type": "Review",
  "author": {
    "@type": "Person",
    "name": "Reviewer Name"
  },
  "datePublished": "2024-11-01",
  "reviewRating": {
    "@type": "Rating",
    "ratingValue": "5",
    "bestRating": "5"
  },
  "reviewBody": "Great product! Highly recommend for anyone looking for quality."
}
```

#### Offers (Recommended property)

Price and availability information

```json
"offers": {
  "@type": "Offer",
  "url": "https://yoursite.com/product-url",
  "priceCurrency": "USD",
  "price": "29.99",
  "availability": "https://schema.org/InStock",
  "priceValidUntil": "2025-12-31",
  "seller": {
    "@type": "Organization",
    "name": "Your Store Name"
  }
}
```

## Organization Schema

For company pages, about pages, and business information. Helps establish authority and credibility in search results.

### Recommended Organization Properties

#### Logo (Recommended property)

Company logo for brand recognition

```json
"logo": "https://yoursite.com/logo.png"
```

#### Description (Recommended property)

Company description (100-150 characters)

```json
"description": "Brief description of your organization between 100-150 characters for search results."
```

#### URL (Required property)

Company website URL

```json
"url": "https://yoursite.com"
```

#### Contact Information (Recommended property)

How customers can reach you

```json
"contactPoint": {
  "@type": "ContactPoint",
  "telephone": "+1-555-555-5555",
  "contactType": "customer service",
  "email": "[email protected]",
  "availableLanguage": ["English", "Spanish"]
}
```

#### Address (Recommended property)

Physical business address

```json
"address": {
  "@type": "PostalAddress",
  "streetAddress": "123 Main Street",
  "addressLocality": "City Name",
  "addressRegion": "ST",
  "postalCode": "12345",
  "addressCountry": "US"
}
```

### Advanced Organization Properties

#### Same As (Social Profiles) (Recommended property)

Links to your official profiles, so an assistant can confirm it has the right organization

```json
"sameAs": [
  "https://facebook.com/yourpage",
  "https://twitter.com/yourhandle",
  "https://linkedin.com/company/yourcompany",
  "https://instagram.com/yourhandle",
  "https://youtube.com/@yourchannel"
]
```

#### Founding Information (Advanced properties)

When the company was founded

```json
"foundingDate": "2020-01-15",
"founder": {
  "@type": "Person",
  "name": "Founder Name"
}
```

## Person Schema

For author pages, team member profiles, and personal brands. Establishes credibility for content creators.

### Recommended Person Properties

#### Basic Person Information (Required and recommended)

Essential person details

```json
"@context": "https://schema.org",
"@type": "Person",
"name": "Full Name",
"url": "https://yoursite.com/about",
"image": "https://yoursite.com/headshot.jpg",
"description": "Brief bio between 100-150 characters about this person and their expertise."
```

#### Job Title & Company (Recommended properties)

Professional role and organization

```json
"jobTitle": "Job Title",
"worksFor": {
  "@type": "Organization",
  "name": "Company Name",
  "url": "https://companysite.com"
}
```

### Advanced Person Properties

#### Social Profiles (Advanced property)

Links to this person's official profiles, so an assistant can confirm it has the right person

```json
"sameAs": [
  "https://twitter.com/username",
  "https://linkedin.com/in/username",
  "https://github.com/username",
  "https://medium.com/@username"
]
```

#### Contact Information (Improves completeness)

How to reach this person

```json
"email": "[email protected]",
"telephone": "+1-555-555-5555"
```

## Recipe Schema

Essential for food blogs and cooking sites. Enables rich recipe cards in search results with ratings, cook time, and more.

### Recommended Recipe Properties

#### Author (Improves completeness)

Recipe creator information

```json
"author": {
  "@type": "Person",
  "name": "Chef Name",
  "url": "https://yoursite.com/author/chef-name"
}
```

#### Dates (Improves completeness)

When recipe was published and updated

```json
"datePublished": "2024-11-06",
"dateModified": "2024-11-06"
```

#### Image (Multiple) (Recommended property)

Recipe photos (multiple recommended)

```json
"image": [
  "https://yoursite.com/recipe-photo-1.jpg",
  "https://yoursite.com/recipe-photo-2.jpg",
  "https://yoursite.com/recipe-photo-3.jpg"
]
```

#### Recipe Details (Improves completeness)

Cook times and serving information

```json
"recipeYield": "4 servings",
"prepTime": "PT15M",
"cookTime": "PT30M",
"totalTime": "PT45M",
"recipeCategory": "Main Course",
"recipeCuisine": "Italian"
```

### Advanced Recipe Properties

#### Keywords (Improves completeness)

Recipe topics for better discovery

```json
"keywords": ["quick dinner", "pasta", "italian food", "weeknight meals", "family friendly"]
```

#### Nutrition Information (Improves completeness)

Nutritional facts (highly valued)

```json
"nutrition": {
  "@type": "NutritionInformation",
  "calories": "350 calories",
  "proteinContent": "25g",
  "fatContent": "10g",
  "carbohydrateContent": "40g",
  "fiberContent": "5g",
  "sugarContent": "8g"
}
```

#### Aggregate Rating (Improves completeness)

User ratings for the recipe

```json
"aggregateRating": {
  "@type": "AggregateRating",
  "ratingValue": "4.8",
  "ratingCount": "127",
  "bestRating": "5",
  "worstRating": "1"
}
```

## Event Schema

For conferences, webinars, concerts, and any scheduled events. Enables rich event listings in search results.

### Recommended Event Properties

#### Event Dates & Location (Includes required properties)

When and where the event happens

```json
"startDate": "2024-12-15T19:00:00-05:00",
"endDate": "2024-12-15T22:00:00-05:00",
"eventStatus": "https://schema.org/EventScheduled",
"eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
"location": {
  "@type": "Place",
  "name": "Venue Name",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "123 Event Street",
    "addressLocality": "City Name",
    "addressRegion": "ST",
    "postalCode": "12345",
    "addressCountry": "US"
  }
}
```

#### Organizer (Recommended property)

Who is hosting the event

```json
"organizer": {
  "@type": "Organization",
  "name": "Event Organizer Name",
  "url": "https://organizer-site.com"
}
```

#### Image (Recommended property)

Event poster or promotional image

```json
"image": "https://yoursite.com/event-poster.jpg"
```

#### Description (Recommended property)

Event description (100-150 characters)

```json
"description": "Brief event description between 100-150 characters highlighting what attendees can expect."
```

### Advanced Event Properties

#### Offers (Tickets) (Recommended property)

Ticket pricing and availability

```json
"offers": {
  "@type": "Offer",
  "url": "https://yoursite.com/tickets",
  "price": "25.00",
  "priceCurrency": "USD",
  "availability": "https://schema.org/InStock",
  "validFrom": "2024-11-01T00:00:00"
}
```

#### Performer (Recommended property)

Featured speakers or performers

```json
"performer": {
  "@type": "Person",
  "name": "Performer Name",
  "url": "https://performersite.com"
}
```

## Common Patterns

These reusable patterns work across multiple schema types.

### Basic Author Pattern

Use this exact structure for any article, blog post, or recipe

```json
"author": {
  "@type": "Person",
  "name": "Your Name Here",
  "url": "https://yoursite.com/author/yourname",
  "sameAs": [
    "https://twitter.com/yourhandle",
    "https://linkedin.com/in/yourprofile"
  ]
}
```

### Basic Publisher Pattern

Standard publisher format for all content types

```json
"publisher": {
  "@type": "Organization",
  "name": "Your Company Name",
  "logo": {
    "@type": "ImageObject",
    "url": "https://yoursite.com/logo.png",
    "width": 600,
    "height": 60
  },
  "url": "https://yoursite.com"
}
```

### Structured Image Pattern

Better than plain string URLs (higher quality score)

```json
"image": {
  "@type": "ImageObject",
  "url": "https://yoursite.com/image.jpg",
  "width": 1200,
  "height": 630,
  "caption": "Descriptive caption for accessibility"
}
```

## Frequently Asked Questions

### Where do I paste these snippets?

In the schema editor after generating your schema. Add the property inside the main schema object (after existing properties, before the closing }). Make sure to add a comma after the previous property.

### Do I need all of these properties?

No. Focus on "Recommended Properties" first (biggest score impact), then add "Advanced AEO Features" if you want to reach 90+. Only add properties where you have real data. Never make up fake information.

### What if I don't have some of this information?

Skip properties you don't have. Don't make up fake data. It's worse than leaving it blank. For example, if you don't have ratings, don't add fake aggregateRating data.

### Can I copy multiple snippets at once?

Yes! Just make sure to add a comma after each property (except the last one). Proper JSON formatting is important: each property needs to be separated by commas.

### Will this break my schema?

These snippets are valid schema.org properties. As long as you maintain proper JSON formatting (commas, brackets, quotes), your schema will remain valid. Use the grader to verify after making changes.

### How much will my score improve?

It depends on your schema type, since each type weights required, recommended, and advanced properties differently. Adding real, verifiable data raises the score because it is checked against your page. Making up data to fill a property does not help. It gets caught and lowers the score instead.

## Ready to Boost Your Schema Score?

Copy the properties you need, paste them into your schema, and watch your score improve. It's that simple.

- **[Grade Your Schema](https://superschema.ai/grader)**
- [Get Started Free](https://superschema.ai/sign-up)

---

*This content is optimized for AI systems. Human-friendly version: https://superschema.ai/schema-markup/improve-quality-score*

*Generated by [SuperSchema](https://superschema.ai) - AI-Powered Schema Markup*