How to Fix Rich Result Eligibility Gaps

Schema that passes schema.org validation can still fail Google's Rich Results Test. Schema.org checks required properties; Google adds recommended properties that unlock rich-snippet features — star ratings, prices, images in the SERP. AI schema generators often produce the minimum valid schema, missing the recommendations. This guide maps the gaps by schema type and the data sources to populate them.

1. Required vs recommended

schema.org REQUIRED      → minimum for the type to validate
Google REQUIRED          → minimum for rich results (stricter)
Google RECOMMENDED       → strengthens eligibility, improves snippet
Google PREFERRED         → optimal rich-snippet display

AI generators usually hit schema.org REQUIRED. Hitting Google RECOMMENDED requires explicit data passed in.

2. Per-type gaps (Article)

3. Per-type gaps (Product)

4. Per-type gaps (Recipe)

5. Per-type gaps (Event)

6. Per-type gaps (LocalBusiness)

7. Source the data, not the schema

AI generators don't invent data — they format what you give them. The fix is feeding the generator the missing fields:

// Bad: generator infers from prose
const schema = await ai.generateProductSchema(htmlContent);
// Output may have name, price, but no aggregateRating, no shipping

// Good: explicit data from product DB
const product = await db.getProduct(productId);
const reviews = await db.getReviewSummary(productId);
const shipping = await calculateShipping(productId);

const schema = await ai.generateProductSchema({
  content: htmlContent,
  data: {
    name: product.name,
    sku: product.sku,
    gtin: product.gtin,
    brand: product.brand,
    image: product.images,
    offers: {
      price: product.price,
      priceCurrency: product.currency,
      priceValidUntil: product.priceValidUntil,
      availability: product.stockStatus,
      shippingDetails: shipping,
      hasMerchantReturnPolicy: product.returnPolicy
    },
    aggregateRating: reviews.summary,
    review: reviews.recent.slice(0, 3)
  }
});
// Now generator can output the recommended properties because the data exists

8. Post-process to add common recommendations

// Auto-fill commonly-missed properties from site config
function enrichSchema(schema, siteConfig) {
  function walk(obj) {
    if (!obj || typeof obj !== 'object') return;
    
    if (obj['@type'] === 'Article' || obj['@type'] === 'BlogPosting') {
      // Ensure recommended fields
      if (!obj.publisher) obj.publisher = { '@id': siteConfig.orgId };
      if (!obj.mainEntityOfPage) obj.mainEntityOfPage = obj.url || obj['@id'];
      if (!obj.dateModified && obj.datePublished) obj.dateModified = obj.datePublished;
    }
    
    if (obj['@type'] === 'Product') {
      // Common missing: brand from site, sku from URL
      if (!obj.brand && siteConfig.defaultBrand) obj.brand = siteConfig.defaultBrand;
    }
    
    for (const v of Object.values(obj)) {
      if (typeof v === 'object') walk(v);
    }
  }
  walk(schema);
  return schema;
}

9. Validate eligibility

// Map of recommended properties per type
const RECOMMENDED = {
  Article: ['image', 'dateModified', 'publisher', 'mainEntityOfPage'],
  Product: ['aggregateRating', 'brand', 'sku', 'offers.priceValidUntil'],
  Recipe: ['author', 'prepTime', 'cookTime', 'recipeYield', 'nutrition'],
  Event: ['endDate', 'image', 'offers', 'organizer'],
  LocalBusiness: ['telephone', 'openingHoursSpecification', 'geo', 'priceRange']
};

function checkRecommended(schema) {
  const warnings = [];
  function walk(obj, path = '') {
    if (!obj || typeof obj !== 'object') return;
    const type = Array.isArray(obj['@type']) ? obj['@type'][0] : obj['@type'];
    if (RECOMMENDED[type]) {
      for (const prop of RECOMMENDED[type]) {
        const val = prop.includes('.') 
          ? getNested(obj, prop) 
          : obj[prop];
        if (!val) warnings.push(`${path}${type}: missing recommended "${prop}"`);
      }
    }
    for (const [k, v] of Object.entries(obj)) {
      if (typeof v === 'object') walk(v, `${path}${k}.`);
    }
  }
  walk(schema);
  return warnings;
}