ChangeEvent Schema

Every changelog entry is normalized to the ChangeEvent schema. Same fields for all 5000+ sources.

Core Fields (Always Present)

{
  "id": "stable-external-id",
  "source": "vercel.changelog",
  "vendor": "Vercel",
  "title": "Security Dashboard is now generally available",
  "url": "https://vercel.com/changelog/vercel-security-dashboard-is-now-generally-available",
  "publishedAt": "2026-08-26T00:00:00.000Z",
  "summary": "The Security Dashboard helps you identify and fix security issues across your projects.",
  "tags": ["security", "dashboard"],
  "isImportant": false
}

Field Definitions

• id: Stable external identifier (unique per source)
• source: Slug of the changelog source (e.g., vercel.changelog, aws.whats-new)
• vendor: Vendor name (e.g., Vercel, AWS, Shopify)
• title: Update title as published by the vendor
• url: Link to the full update on the vendor site
• publishedAt: Vendor’s own timestamp (ISO 8601, not our fetch time)
• summary: Cleaned description text (may be null if vendor does not provide one)
• tags: Array of categorization tags (empty array if none)
• isImportant: Boolean flag for breaking changes, security, GA, deprecations, major versions

Optional Typed Fields (Nullable)

These fields are only set when we actually have the data from the vendor. We do not invent values.

{
  changeKind?: "feature" | "fix" | "deprecation" | "security" | "preview" | "ga" | "breaking" | "version" | "other"
  effectiveAt?: string  // ISO 8601 DateTime
  sunsetAt?: string     // ISO 8601 DateTime
}

changeKind

Classifies the type of change:

• feature: New capability or product
• fix: Bug fix or correction
• deprecation: Feature marked for removal
• security: Security patch or advisory
• preview: Public preview or beta
• ga: General availability announcement
• breaking: Breaking change
• version: Version bump or release
• other: Other change types

effectiveAt

When the change takes effect. Examples:

• Preview launch date: AWS Lambda Node.js 26 preview ships August 25, 2026
• GA date: Vercel Security Dashboard GA on August 26, 2026

sunsetAt

Hard deadline for deprecated features. Example:

• Shopify script tags stop running March 1, 2027

Real Examples

Feature (Vercel Atom feed)

{
  "id": "vercel-security-dashboard-ga",
  "source": "vercel.changelog",
  "vendor": "Vercel",
  "title": "Security Dashboard is now generally available",
  "url": "https://vercel.com/changelog/vercel-security-dashboard-is-now-generally-available",
  "publishedAt": "2026-08-26T00:00:00.000Z",
  "summary": "The Security Dashboard helps you identify and fix security issues across your projects. All plans.",
  "tags": ["security", "dashboard"],
  "isImportant": false,
  "changeKind": "ga",
  "effectiveAt": "2026-08-26T00:00:00.000Z"
}

Version (Next.js GitHub releases)

{
  "id": "next-15.1.2-canary.5",
  "source": "nextjs.releases",
  "vendor": "Vercel",
  "title": "v15.1.2-canary.5",
  "url": "https://github.com/vercel/next.js/releases/tag/v15.1.2-canary.5",
  "publishedAt": "2026-08-27T00:00:00.000Z",
  "summary": null,
  "tags": ["canary"],
  "isImportant": false,
  "changeKind": "version"
}

Deprecation with Sunset (Shopify RSS)

{
  "id": "shopify-script-tags-deprecated",
  "source": "shopify-api-updates",
  "vendor": "Shopify",
  "title": "Script tags are deprecated and will stop running on March 1, 2027",
  "url": "https://shopify.dev/changelog/script-tags-deprecated",
  "publishedAt": "2026-08-24T00:00:00.000Z",
  "summary": "Script tags will stop executing on March 1, 2027. Migrate to Shopify App Extensions.",
  "tags": ["deprecation", "scripts"],
  "isImportant": true,
  "changeKind": "deprecation",
  "sunsetAt": "2027-03-01T00:00:00.000Z"
}

Preview (AWS What’s New)

{
  "id": "aws-lambda-node26-python315-preview",
  "source": "aws.whats-new",
  "vendor": "AWS",
  "title": "AWS Lambda introduces managed runtimes in public preview for Node.js 26 and Python 3.15",
  "url": "https://aws.amazon.com/about-aws/whats-new/2026/08/aws-lambda-node-js-python-public-preview/",
  "publishedAt": "2026-08-25T00:00:00.000Z",
  "summary": "Public preview runtimes for Node.js 26 and Python 3.15. Not covered by SLA. GA targeted within two months of upstream stable.",
  "tags": ["lambda", "runtime", "preview"],
  "isImportant": true,
  "changeKind": "preview",
  "effectiveAt": "2026-08-25T00:00:00.000Z"
}

Public Source URLs

All source detail pages use dashed slugs:

• /sources/vercel-changelog
• /sources/shopify-api-updates
• /sources/aws-whats-new
• /sources/nextjs-releases

Next

Learn about Structure Drift Detection and how we flag when a vendor changes their feed shape.