JSON-LD Schemas¶

easeo generates schema.org JSON-LD from the entity type, then lets you replace or extend it. The result is exposed as schema_jsonld (Python) or schemaJsonLd (JavaScript).

Built-in schemas¶

Breadcrumbs are always appended as a BreadcrumbList. When a page has both a main schema and breadcrumbs, schema_jsonld becomes a list of two objects.

Schema depth¶

Built-in schemas are intentionally minimal: they cover the fields a page can supply and the properties search engines commonly consume, not the full Schema.org vocabulary. Two examples:

• VideoObject adds thumbnailUrl and uploadDate, but does not model duration, contentUrl, or embedUrl.
• LocalBusiness.address is a single PostalAddress.streetAddress string; locality, region, postal code, and country are not modeled.

When a page needs deeper modeling, replace the schema per page with SEOOverrides.schema_jsonld, or register a generator per type with SchemaRegistry (both shown below).

Three ways to control it¶

Auto-generate¶

Leave auto_generate_schema at its default of True:

config = SEOConfig(
    canonical_host="example.com",
    public_base_url="https://example.com",
    auto_generate_schema=True,
)

Replace for one page¶

Use SEOOverrides when a single page needs a different shape:

from easeo import SEOOverrides, build_seo_payload

payload = build_seo_payload(
    entity,
    "/podcast/ep-1",
    config,
    SEOOverrides(schema_jsonld={
        "@context": "https://schema.org",
        "@type": "PodcastEpisode",
        "name": "Episode 1",
    }),
)

Register a generator for a type¶

When every page of a given schema type should use the same shape, register a generator once on the config:

from easeo import SchemaRegistry

registry = SchemaRegistry()

@registry.register("Article")
def podcast_episode(entity, config, canonical, title, description, og_image):
    return {
        "@context": "https://schema.org",
        "@type": "PodcastEpisode",
        "name": title,
        "url": canonical,
    }

config = SEOConfig(..., schema_registry=registry)

The generator runs whenever the resolved @type matches. Return None to fall back to the built-in schema for that page.

Suppressing the schema¶

overrides = SEOOverrides(omit_schema=True)

Recap¶

• Schemas are generated from the entity type.
• Breadcrumbs are appended automatically.
• Replace per page with SEOOverrides, or per type with SchemaRegistry.