Skip to content

FSH Authoring

FHIR Shorthand (FSH) and SUSHI provide a human-readable, version-control-friendly way to author FHIR profiles, extensions, and instances. These patterns help you write FSH that is maintainable, consistent, and reusable across profiles and projects. Good FSH practices reduce diff noise in code review and make refactoring safer.

FSH authoring patterns address code quality and maintainability:

  • Duplicated constraint blocks across profiles
  • Inconsistent terminology bindings
  • Large diffs from minor changes

The FSH Authoring provide essential capabilities:

Aliases and RuleSets

Centralise constants and reusable rule blocks to reduce duplication, improve consistency, and make refactoring safer. When terminology URLs and common constraints are defined once, changes propagate automatically.

Key Benefits: - Fewer diffs - Safer refactors

Extensions and Slicing

Constrain responsibly with clear invariants and named slices

Key Benefits: - Predictable matching