Overview

Detailed property reference for every supported Schema.org type. Each type lists its required, recommended, and optional properties with expected value types — the same data ValidGraph uses for scoring and validation.

How It Works

1. Browse types via the API or dashboard vocabulary section
2. Each type shows:
– Required properties (must have for valid markup)
– Recommended properties (improve completeness score)
– Optional properties (nice to have)
– Expected value types for each property
– Links to Schema.org documentation
3. The vocabulary is compiled from Schema.org and Google’s rich results requirements
4. Updated periodically to reflect Schema.org changes

Tier Availability

Vocabulary reference is available to all tiers.

Related Features

– Supported Schema Types: Which types are available in your tier
– Schema Completeness Score: Scoring uses this vocabulary data
– Auto-Fix Suggestions: Suggestions reference this vocabulary

Mini-Tutorial

Step 1: Find a Type

In ValidGraph, click “Vocabulary” and search for a schema type (e.g., “Product”).

Step 2: View Property Breakdown

You’ll see three sections:
– Required: Must be present for valid schema
– Recommended: Improve completeness score if added
– Optional: Nice to have

Step 3: Check Property Details

For each property, see:
– Expected value type (Text, URL, Number, etc.)
– Description
– Link to Schema.org docs

Step 4: Understand Property Inheritance

Properties marked with “(inherited)” come from a parent type. For example, Product inherits from Thing.

Step 5: Use in Your Implementation

When marking up your website, include required properties first, then recommended ones for a better score.

Technical Details

Get Supported Types

GET /api/v1/vocabulary/types?search=product&limit=10

Response:

{
  "types": [
    {
      "id": "Product",
      "name": "Product",
      "description": "Any offered product or service. For example: a pair of shoes; a concert ticket; the rental of a car; a haircut; or an episode of a TV show streamed online.",
      "schema_org_url": "https://schema.org/Product",
      "tier_availability": ["pro", "agency", "enterprise"]
    }
  ],
  "total": 1
}

Get Type Details (Properties)

GET /api/v1/vocabulary/type/Product

Response:

{
  "type": "Product",
  "description": "Any offered product or service...",
  "schema_org_url": "https://schema.org/Product",
  "required_properties": [
    {
      "name": "name",
      "value_type": "Text",
      "description": "The name of the item.",
      "schema_org_url": "https://schema.org/name"
    }
  ],
  "recommended_properties": [
    {
      "name": "description",
      "value_type": "Text",
      "description": "A description of the item.",
      "schema_org_url": "https://schema.org/description"
    },
    {
      "name": "image",
      "value_type": "URL|ImageObject",
      "description": "An image of the item.",
      "schema_org_url": "https://schema.org/image"
    },
    {
      "name": "aggregateRating",
      "value_type": "AggregateRating",
      "description": "The overall rating, based on a collection of reviews or ratings, of the item.",
      "schema_org_url": "https://schema.org/aggregateRating"
    }
  ],
  "optional_properties": [
    {
      "name": "brand",
      "value_type": "Brand|Organization",
      "description": "The brand(s) associated with the item.",
      "schema_org_url": "https://schema.org/brand"
    }
  ],
  "parents": ["Thing"],
  "children": []
}

Property Value Types

Common value types in the vocabulary:
– Text: String (e.g., “Widget Name”)
– URL: Web address (e.g., “https://example.com/image.jpg”)
– Number: Integer or float (e.g., 4.5 for a rating)
– Date: ISO 8601 format (e.g., “2025-03-22”)
– Time: ISO 8601 format (e.g., “14:30”)
– Boolean: True or false
– ImageObject: Nested structured data for images
– AggregateRating: Nested rating information
– Organization: Reference to another type

Example Product Markup

Based on the vocabulary reference:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Executive Anvil",
  "description": "Sleek and stylish anvil.",
  "image": "https://example.com/anvil.jpg",
  "brand": {
    "@type": "Organization",
    "name": "ACME"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "ratingCount": "89"
  }
}

References

– Schema.org Full Specification
– Schema.org Types Hierarchy
– Google Rich Results Test
– JSON-LD Implementation Guide