{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://designsystemdocspec.org/v0.15.2/metadata/last-updated.schema.json",
"title": "Last updated metadata field",
"description": "When this entity's documentation last changed. A bare ISO date covers the common case; the object form adds a note describing what changed.",
"$defs": {
"lastUpdated": {
"description": "When this entity's documentation last changed. A bare ISO 8601 date string ('2026-05-28') covers the common case. Use the object form to add a note describing what changed.",
"oneOf": [
{
"$ref": "../common/dated-note.schema.json#/$defs/isoDate",
"description": "ISO 8601 date (YYYY-MM-DD) of the most recent update to this entity's documentation."
},
{
"type": "object",
"description": "Full lastUpdated form: the date plus a note describing what changed.",
"required": [
"date"
],
"properties": {
"date": {
"$ref": "../common/dated-note.schema.json#/$defs/isoDate",
"description": "ISO 8601 date (YYYY-MM-DD) of the most recent update to this entity's documentation."
},
"note": {
"$ref": "../common/dated-note.schema.json#/$defs/plainNote",
"description": "Plain-text note summarizing what changed in the most recent update (ex: 'Added focus-visible guidance', 'Revised contrast requirements for inverse surfaces'). MUST NOT contain markup."
}
},
"additionalProperties": false
}
]
}
}
}
object — Full lastUpdated form: the date plus a note describing what changed.ISO 8601 date (YYYY-MM-DD) of the most recent update to this entity's documentation.Plain-text note summarizing what changed in the most recent update (ex: 'Added focus-visible guidance', 'Revised contrast requirements for inverse surfaces'). MUST NOT contain markup.
References:isoDate, plainNote[
"2026-05-28",
{
"date": "2026-05-28",
"note": "Added focus-visible guidance and refreshed contrast requirements for inverse surfaces."
}
]