FHIR Version Timeline
FHIR has evolved significantly since its inception. Understanding the version history helps you choose the right version for your implementation and plan for migrations.
FHIR DSTU 1 (Draft Standard for Trial Use 1)
Release Date: September 2013
This was the initial release that introduced core FHIR concepts:
- ~50 resources defined
- Basic RESTful operations (CRUD)
- XML and JSON support
Status: Deprecated - not recommended for new implementations
FHIR DSTU 2 (Draft Standard for Trial Use 2)
Release Date: October 2015
Key improvements over DSTU1:
- Expanded to ~90 resources
- Introduction of Resource profiles
- Enhanced search capabilities
- Improved conformance resources
- Operations framework introduced
Status: Legacy - some systems still in use
FHIR STU3 (Standard for Trial Use 3)
Release Date: March 2017
Major milestone with significant enhancements:
- ~130 resources
- Maturity model for resources
- Enhanced support for clinical decision support
- Bulk data access patterns
- GraphQL support
- Improved security with SMART on FHIR integration
Status: Widely adopted, many production systems
Notable Changes from DSTU2
- Major structural changes to many resources
- Breaking changes requiring migration effort
- Introduction of maturity levels (0-5)
FHIR R4 (Release 4)
Release Date: December 2019
The most significant release - first with normative content:
- First normative release (certain resources reached normative status)
- ~140 resources
- Normative resources guaranteed backward compatibility
- Enhanced bulk data operations ($export)
- Improved subscription framework
- Better support for genomics and clinical reasoning
Status: Current production standard - highly recommended
Normative Resources (Guaranteed stability)
- Patient
- Observation
- Practitioner
- Organization
- Medication
- And more core clinical resources
FHIR R4B (Release 4B)
Release Date: May 2022
A minor update maintaining R4 compatibility:
- Additional resources moved to normative status
- Bug fixes and clarifications
- No breaking changes from R4
Status: Incremental update, backward compatible with R4
FHIR R5 (Release 5)
Release Date: March 2023
The latest major release with modern capabilities:
- ~155 resources
- Enhanced subscriptions framework (topic-based subscriptions)
- Improved workflow support
- Better support for administrative and financial resources
- New resources for clinical trials and research
- Enhanced conformance and capability statements
Status: Latest version, adoption growing
Major Improvements
- Subscriptions 2.0 with topic-based approach
- Better resource linking and referencing
- Enhanced support for international health data exchange
Version Compatibility Matrix
| From Version | To Version | Migration Effort | Breaking Changes |
|---|---|---|---|
| DSTU2 | STU3 | High | Yes, significant |
| STU3 | R4 | Medium | Some resources |
| R4 | R4B | Low | None |
| R4/R4B | R5 | Medium | Some resources |
Choosing the Right Version
For new implementations, consider:
- R4 - Most widely supported, stable, excellent tooling
- R5 - Latest features, but tooling still maturing
- Check your ecosystem - What version do your trading partners use?