The Model

USDM Version 4.0 Explained

USDM v4.0 (Final, June 2025) is the current release — aligned with ICH M11's second public consultation draft and carrying a substantially expanded intervention model.

Version history at a glance

Version Released Headline content
v1.0 July 2023 Initial USDM data model (Phase 1 output). No Implementation Guide existed yet.
v2.0 June 2024 Expanded model coverage following Phase 2/3 work; first full Implementation Guide (IG v2.0, 7 June 2023 per IG revision history) and CORE rules.
v3.0 April 2025 Further refinement; IG v3.0 published 16 April 2024; CORE rules extended (v3.0 column in the rule spreadsheet).
v4.0 (Final) 3 June 2025 IDMP-aligned intervention model; continued ICH M11 alignment; IG v4.0 Final; current CORE rule set covers both v3.0 and v4.0.

USDM-IG document history additionally shows an earlier "Updated Step 2 Draft" reference point dated 3 February 2025, reflecting the iterative public-review process alongside ICH M11's own parallel development.

What's new headline: an IDMP-aligned intervention model

USDM v4.0's most substantial structural addition is an extended intervention part of the model, aligned with the ISO IDMP (Identification of Medicinal Products) standards used by regulators like the EMA and FDA for product identification. Concretely, this means new or substantially expanded classes:

  • AdministrableProduct — product designation (IMP/NIMP), pharmacological class, sourcing, identifiers, properties, ingredients.
  • Ingredient & Substance — including reference substances, for cases where the active substance and active moiety differ.
  • Strength — numerator/denominator quantities or ranges, supporting both exact and estimated (range-based) strength values.
  • MedicalDevice — sourcing, embedded products (for drug/device combination products), and medical device identifiers.
  • ProductOrganizationRole — manufacturer/supplier roles tied to specific medical devices and/or administrable products.

The IG is candid that this alignment is partial by design: not all IDMP-required elements could be included in USDM, because some of them (drug indication, effective dose) are actually outcomes of the trial being designed — they don't exist yet at protocol-design time.

ICH M11 alignment, version by version

USDM's alignment with ICH M11 has been a moving target because both standards developed in parallel. The IG documents this explicitly: "At the time of publication of USDM v4.0, ICH CeSHarP was still in the development phase. USDM v4.0 was aligned with the public review version issued on March 14, 2025. It is expected that the final version of the M11 specifications will be released in November 2025 and that USDM will be aligned with that release as Version 4.1." (USDM-IG v4.0, Section 3.2)

ICH M11 itself reached Step 4 adoption on 19 November 2025, with EMA final adoption on 11 December 2025 and a coming-into-effect date of 11 June 2026 — so USDM v4.1's M11 realignment work follows directly on the heels of that milestone.

What hasn't changed across versions

Despite four major releases, the fundamentals covered throughout this hub have stayed stable:

  • The backbone — Study → StudyVersion → StudyDesign — is unchanged since v1.0.
  • The UML normative form and its naming conventions (id/name/label/description/notes, previous/next ordering) have been stable design principles from the start.
  • The API serialization rules (natural parent nesting, Id/Ids cross-references) have not changed.
  • The overall ten model areas have been consistently used to organize training and documentation across versions.

In practice, moving between USDM versions is mostly about additive class/attribute growth (like the v4.0 IDMP intervention expansion) and CORE rule refinement, not structural rewrites of the backbone.

Study StudyVersion StudyDesign StudyArm StudyEpoch Encounter ScheduleTimeline StudyCell StudyElement ScheduledActivityInstance Timing Activity • BiomedicalConcept • Procedure (linked from ScheduledActivityInstance)
USDM backbone: Study → StudyVersion → StudyDesign, with Arms, Epochs, Encounters, ScheduleTimeline, and the detailed Activity layer.

Reading a version number correctly

USDM versioning follows a straightforward major-release pattern (v1.0, v2.0, v3.0, v4.0) rather than semantic versioning with frequent minor/patch releases. Each major version bump has historically corresponded to a genuine DDF phase deliverable (see CDISC DDF Explained) rather than a small incremental fix, which is why sponsors and vendors treat a USDM version upgrade as a real integration project rather than a routine dependency bump. The "Final" designation on v4.0 specifically indicates it has passed CDISC's public review process and is not a draft — a distinction worth checking whenever you download a USDM artifact, since draft versions do circulate during review windows.

What to check before adopting a new USDM version

  • Re-check your CORE rules. The CORE rule spreadsheet tracks applicability per version (separate Y/N columns for v3.0 and v4.0) — some rules are version-specific, so a payload valid under v3.0 CORE rules is not automatically valid under v4.0's.
  • Re-check controlled terminology. New codelists (like the IDMP-related sourcing and administrable product codelists added for v4.0) only exist from the version that introduced them onward.
  • Re-check the Implementation Guide edition. Each USDM version has its own IG edition with its own revision history — always confirm the IG version matches the model version you're implementing against.
  • Re-check any ICH M11 alignment claims. As shown above, M11 alignment specifically has shifted from version to version as both standards evolved in parallel — don't assume v3.0's M11 mapping guidance still applies unchanged to v4.0.

What USDM v4.1 is expected to bring

Per the USDM-IG's own forward-looking statement, v4.1 is expected to re-align USDM with the final ICH M11 specification released following M11's Step 4 adoption (19 November 2025) and subsequent final regulatory adoption steps (EMA final adoption 11 December 2025, coming into effect 11 June 2026). Beyond the M11 realignment, DDF's phased delivery pattern suggests continued refinement of the IDMP-aligned intervention model introduced in v4.0, since that area was explicitly flagged as partially, not fully, IDMP-compliant at release.

Should you build against v4.0 or wait for v4.1?

For most organizations, the practical answer is to build against v4.0 now rather than waiting. The backbone, the API serialization rules, and the ten model areas have proven stable across every major version so far, so a v4.0 implementation is very unlikely to require a structural rewrite for v4.1 — the anticipated changes are additive (further M11 alignment detail, further IDMP completeness), consistent with how every prior version transition has actually played out. Waiting for a "final, unchanging" version of USDM is not a realistic strategy given the model's own stated principle of iterating and adding complexity as it's understood; treat versioned releases as checkpoints to re-validate against, not gates to wait behind.

Frequently asked questions

What is the current USDM version?

USDM v4.0 (Final), published 3 June 2025 by the DDF Team, is the current release as covered on this site. A v4.1 update is anticipated to align with the final ICH M11 specification release.

What changed between USDM v3.0 and v4.0?

The headline addition is an extended intervention model aligned with ISO IDMP (Identification of Medicinal Products) concepts — AdministrableProduct, Ingredient, Substance, Strength, and MedicalDevice — plus continued alignment work with the evolving ICH M11 template.

Is USDM v4.0 fully IDMP-compliant?

Not fully — the IG is explicit that not all required IDMP elements could be included in USDM, since some IDMP elements (like drug indication or effective dose) are actually outcomes of the trials being designed, not known at design time.

Why does the IG mention a 'public review version' of ICH M11?

Because USDM v4.0 was finalized before ICH M11's own final adoption. USDM v4.0 was aligned with the M11 public review version issued 14 March 2025; the plan (per the IG) was to re-align with the final M11 release as USDM v4.1.