MSP-1 Namespace Term

msp:parent

Identifies the higher-level resource, page, section, collection, or structural context that contains or organizes the current MSP-1 resource.

IRI: https://msp-1.org/ns/parent

Definition

msp:parent declares the parent relationship for a resource within an MSP-1 implementation. It helps agents, validators, and implementation tools understand hierarchy, inheritance, breadcrumb logic, structural placement, and contextual grouping.

The canonical parent form is an object with at least id. Additional fields such as url, type, label, relation, path, and depth may provide useful hierarchy context where appropriate.

Usage

{
  "msp:parent": {
    "id": "lighting-guide"
  }
}

Parent declaration with type and relation:

{
  "msp:parent": {
    "id": "guides",
    "type": "collection",
    "relation": "organizational"
  }
}

Parent declaration with URL and path:

{
  "msp:parent": {
    "id": "documentation",
    "url": "https://msp-1.org/spec/",
    "type": "page",
    "relation": "direct",
    "path": [
      "site-root",
      "documentation"
    ],
    "depth": 2
  }
}

Legacy flat-string parent values may be interpreted as a parent URL or identifier when graceful degradation is appropriate. The canonical MSP-1 v1.0.1 form is an object with at least id.

Related Terms