Data model / schema · 2.0 · current

Data Package Standard

Maintained by Data Package Working Group

What it helps you do

Use Data Package when you need a JSON descriptor for a coherent collection of resources, plus Data Resource, Table Schema, and Table Dialect specifications.

  • Discovery
  • Laboratory
  • Cross-cutting
PlanAcquireHarmonizeExchangeLearn + reuse

01

Where it fits—and where it doesn’t

Use these four checks before committing implementation time.

Use it when
Lightweight packaging and validation of assay exports, reference tables, tabular analysis results, and other file-based data products.
Do not use it as
Do not treat Data Package as a complete solution on its own. It does not supply biological semantics, full provenance, privacy policy, repository trust, or ML-specific intended-use and bias documentation.
Best for
Teams working with Discovery and Laboratory and Cross-cutting data across Harmonize → Exchange → Learn + reuse.
Maturity
ScalingUsable today, with adoption or tooling still scaling; pilot the exact stack you plan to run.

02

See it in the workflow

A standard creates value by changing a handoff, not by existing in a catalog.

  1. InputWhat starts

    Discovery and Laboratory and Cross-cutting data, metadata, and the local decisions around them

  2. Data PackageWhat changes

    Data Package applies a shared data model / schema across Harmonize → Exchange → Learn + reuse

  3. OutputWhat becomes possible

    A more consistent, reviewable handoff for the next system or team

Readiness gateBefore scaling: It does not supply biological semantics, full provenance, privacy policy, repository trust, or ML-specific intended-use and bias documentation.

03

A concrete example

A release includes a v2 datapackage.json with stable identity, version, license, sources, contributors, resources, and Table Schemas for tabular files.

Why it matters: Machine-readable resources, field types, missing-value conventions, and categories improve loading and validation, but labels, splits, cohort meaning, and fitness remain external.

04

What it fits with

Can carry DataCite-aligned contributor roles and identifiers, sit inside an RO-Crate, and provide structural metadata beneath a Croissant ML description.

05

Implementation starter

Start with one bounded handoff. Pin, test, and review it before scaling.

  1. Name an accountable owner and the decision Data Package must support.

  2. Pin the exact version and companion artifacts: 2.0 · current.

  3. Map one representative input to the required data model / schema artifacts.

  4. Test the result against the canonical source and record every exception.

  5. Preserve the source data, mappings, and review evidence before scaling.

06

Limitation to test first—and the tests that catch it

Risk

It does not supply biological semantics, full provenance, privacy policy, repository trust, or ML-specific intended-use and bias documentation.

Test

Run one representative end-to-end pilot and record exactly where Data Package loses context, needs an extension, or depends on another standard.

Risk

A structured or machine-readable result can still be unfit for analysis or AI.

Test

Test the output for missing context, provenance, terminology alignment, time leakage, and the intended downstream decision. Machine-readable resources, field types, missing-value conventions, and categories improve loading and validation, but labels, splits, cohort meaning, and fitness remain external.

07

Why we believe this

Checked against the canonical source plus implementation or adoption evidence reported by the steward or its community.

Evidence notation: E1 + E3. The code is shorthand; the plain-language statement above is the claim.

Formal status
Released Data Package Standard 2.0
Confidence
Medium
Review state
Source-checked · watch
Reviewed by
Tabular data packaging reviewer
Last verified
13 July 2026
Review again when
Core specification, profile, validator, or major implementation update
How the evidence method works

08

Source shelf

Official diagrams, examples, specifications, and explainers. Nothing external loads until you choose to open it.

  • Primary source2.0 · current

    Data Package Standard v2

    The canonical publisher or steward source used to verify this data model / schema profile.

    Publisher
    Data Package Working Group
    Rights
    Rights remain with the publisher; this knowledge base links to the source rather than copying it.
    Access
    Opens the publisher's source in a new tab; no external media loads on this page.
    Verified
    2026-07-13
    Open at source

Next action

Put this profile in context

Compare its role with adjacent standards or place it inside an end-to-end data pathway before choosing an implementation.