Resources

Learn USDM

USDM, the Unified Study Definitions Model, is the CDISC standard that describes a clinical study design as structured data instead of a document. This is a practical guide to it: what it is, what a file looks like, every class in version 4.0, and a tool for reading your own files.

The protocol says

The takes place , , .

USDM holds

{
  "id": "Encounter_3",
  "label": "Week 2",
  "environmentalSettings": [
    { "code": "C211570", "decode": "Clinic", … }
  ],
  "scheduledAtId": "Timing_3",
  "instanceType": "Encounter"
}
{
  "id": "Timing_3",
  "type": { "code": "C201356", "decode": "After", … },
  "value": "P14D",
  "relativeToScheduledInstanceId": "ScheduledActivityInstance_2",
  "windowLower": "P2D",
  "windowUpper": "P2D",
  "instanceType": "Timing"
}

One line of a schedule of activities, and the two USDM objects that hold it. Point at a phrase to see where it goes.

current version, released 3 June 2025
4.0current version, released 3 June 2025
classes in the model
86classes in the model
attributes across those classes
833attributes across those classes
the format of a USDM file
JSONthe format of a USDM file

What USDM is

A protocol is written for people. Every system that runs a study, from the EDC to the site’s visit calendar, needs the same facts from it, and today each one gets them by someone reading the document and typing. USDM is a shared data model for those facts: the arms and epochs, the visits and what happens at them, the objectives and endpoints, the eligibility criteria, the interventions, and the protocol text itself.

CDISC publishes it with TransCelerate BioPharma as the reference architecture for TransCelerate’s Digital Data Flow initiative. A study held in USDM can be passed between tools as one JSON file, rendered as an ICH M11 protocol, and used to derive the SDTM trial design datasets. The full introduction covers the five parts of the standard and its history.

Work through it in order

  1. What is USDM?The standard in plain language: what it is, who maintains it, what the five parts are and how it got to version 4.0.
  2. USDM JSON examplesOne small study, shown piece by piece: the protocol wording on one side and the USDM JSON it becomes on the other, with every line explained.
  3. The schedule of activities in USDMHow visits, activities, timelines and timings fit together. Click any cell in a working schedule to see the objects behind it.
  4. USDM object modelAll 86 classes of USDM 4.0, grouped by subject, each with its official definition, attributes, cardinalities and relationships.
  5. USDM vs SDTM, ICH M11, ODM and FHIRWhere USDM stops and the neighbouring standards start, and which one answers which question.
  6. USDM at the research siteWhat a study definition gives a site, what the site still has to build from it, and how Concordare reads and writes USDM.

How a USDM file is put together

The boxes below nest the way the JSON does: a study holds versions, a version holds designs, a design holds the schedule. Select a class to see what it is. The dashed classes are the ones it points to by id, which is how USDM links things that do not nest.

Structure
Schedule
Purpose
People

ScheduledActivityInstance

study.versions[].studyDesigns[].scheduleTimelines[].instances[]

One planned point on a timeline: these activities, at this encounter, in this epoch. It is the object that ties what to when.

CDISC definition. A scheduled occurrence of an activity event.

Points to, by id

  • defaultConditionIdScheduledInstance
  • epochIdStudyEpoch
  • activityIdsActivity
  • encounterIdEncounter
  • timelineIdScheduleTimeline
  • timelineExitIdScheduleTimelineExit
6 in the example studyFull reference →

This map shows 30 of the 86 classes. The object model reference has all of them.

Free tool

Have a USDM file? See what is in it.

The inspector lays out the schedule of activities with planned days and windows, summarises the design, and lists broken references, missing required attributes and timings it cannot read. It runs in your browser, so the file is never uploaded.

Open the inspector

Four versions in three years

  1. 1.0August 2022

    The base model for a structured study design. Simple designs only, and no implementation guide.

  2. 2.0June 2023

    Study timing and timelines for complex visit structures, biomedical concepts to support EDC automation, and enough protocol content to populate a protocol template. The first version with an implementation guide.

  3. 3.0April 2024

    Coverage of the draft ICH M11 protocol template, more of the SDTM trial design datasets, elements for trial registries, and cohorts for complex designs.

  4. 4.0June 2025

    Separate interventional and observational study designs, device studies, richer amendments, estimands, abbreviations, roles and interventions, aligned to the March 2025 review draft of ICH M11. Published with conformance rule specifications.

Frequently asked questions

What does USDM stand for?
USDM stands for Unified Study Definitions Model. It is a CDISC standard that describes a clinical study design as structured, machine-readable data instead of prose in a protocol document.
Who maintains USDM?
CDISC develops and publishes USDM in collaboration with TransCelerate BioPharma, as the reference architecture for TransCelerate's Digital Data Flow (DDF) initiative. The model, API specification and implementation guide are published openly in the cdisc-org/DDF-RA repository on GitHub.
What is the current version of USDM?
USDM 4.0 is the current published version. CDISC released it on 3 June 2025. Earlier versions were 1.0 (August 2022), 2.0 (June 2023) and 3.0 (April 2024). The 4.0 implementation guide says a 4.1 release is planned to align with the final ICH M11 specification.
What format is a USDM file?
A USDM file is JSON. The USDM API specification defines a wrapper object that holds one Study plus a usdmVersion, and every object inside carries an id and an instanceType naming its class. Objects that are used in more than one place are written once and referenced by id.
Is there a USDM JSON schema?
Yes, in effect. USDM's API specification is an OpenAPI document that defines the JSON for every class, including which attributes are required. It is published with the model in the cdisc-org/DDF-RA repository on GitHub, and it is what a USDM JSON file is validated against.
Where can I get a USDM example file?
Concordare publishes a complete, valid USDM 4.0 example study that can be downloaded and is explained line by line on its USDM JSON examples page. CDISC also maintains test data alongside the standard, built from publicly available protocols.
Is USDM the same as ICH M11?
No. ICH M11 is a regulatory guideline that defines a harmonised protocol template and a technical specification for exchanging protocol content. USDM is a data model for the whole study definition. USDM was aligned to cover the sections of the M11 template, so a study held in USDM can be rendered as an M11 protocol.
Is USDM the same as SDTM?
No. SDTM organises the data collected during a study for submission to regulators. USDM describes the study before any data exists: the design, the schedule, the objectives and the eligibility criteria. The two connect at the SDTM trial design datasets, which can be generated from a USDM study design.
Do I have to use USDM?
No regulator requires a submission in USDM today. It matters because it is the common format sponsors, protocol authoring tools, EDC systems and other study systems are adopting to pass a study design between them without retyping it.
How many classes are in USDM 4.0?
USDM 4.0 defines 86 classes, of which 6 are abstract parents that never appear in a file. Between them they carry 833 attributes, counting inherited ones.
How does Concordare relate to USDM?
Concordare's Clinical Trial Protocol Model (CTPM) is a digital protocol built for the operational work of running a study at a research site. USDM describes the study as the sponsor designed it; the CTPM adds what a site needs to carry it out, and generates the site's source documents, EDC build and CTMS configuration. Concordare has built a USDM 4.0 connector between the two.
Can Concordare import and export USDM?
Yes. Concordare has built a USDM 4.0 connector for the CTPM that works in both directions. A USDM JSON file from a sponsor can seed a CTPM, which the study team reviews and approves before anything is generated from it, and an approved CTPM can be exported as a USDM 4.0 file. The connector covers the core of the study design and is being demonstrated ahead of general release.

Class and attribute definitions are from the CDISC Unified Study Definitions Model v4.0, published in the DDF-RA repository and used under the CC BY 4.0 license. Explanations, examples and tools on these pages are written by Concordare Trials. Concordare Trials is not affiliated with or endorsed by CDISC, TransCelerate BioPharma or ICH. For conformance decisions, the published standard is the authority.