# Common Components FHIR Implementation Guide

26.0.0 - Trial

Common Components FHIR Implementation Guide, published by Australian Digital Health Agency. This guide is not an authorized publication; it is the continuous build for version 26.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/AuDigitalHealth/common-components/ and changes regularly. See the Directory of published versions

## Extension: Alternate Name

Official URL: http://digitalhealth.gov.au/fhir/cc/StructureDefinition/alternate-name | Version: 26.0.0
Active as of 2026-07-14 | Computable Name: Alternate_Name
Copyright/Legal: This content is licensed under a Creative Commons Attribution 4.0 International License. See https://creativecommons.org/licenses/by/4.0/

This extension applies to PractitionerRole, and represents a name by which a practitioner chooses to be known in the context of the delivery of a specific healthcare service.

A name by which a practitioner chooses to be known in the context of the delivery of a specific healthcare service. This may differ from their registered legal name.

Context of Use

This extension may be used on the following element(s)

- Element ID: `PractitionerRole`

Usage info

Usages:

- Examples for this Extension: PractitionerRole/alternate-name-example

You can also check for usages in the FHIR IG Statistics

### Formal Views of Extension Content

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

- Differential Table
- Snapshot Table
- Statistics/References
- All

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension(4.0.1) | Alternate name for practitioner in role context
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://digitalhealth.gov.au/fhir/cc/StructureDefinition/alternate-name"
value[x] |  | 1..1 | HumanName | Alternate name
use | S | 0..1 | code | Alternate name use
family | S | 0..1 | string | Family name (often called 'Surname')
given | S | 0..* | string | Given names (not always 'first'). Includes middle names
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension(4.0.1) | Alternate name for practitioner in role context Constraints: ext-1
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url Constraints: ext-1
url |  | 1..1 | uri | "http://digitalhealth.gov.au/fhir/cc/StructureDefinition/alternate-name"
value[x] |  | 1..1 | HumanName | Alternate name
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
use | ?!S Σ | 0..1 | code | Alternate name use Binding: NameUse (required): The use of a human name.
text | Σ | 0..1 | string | Text representation of the full name
family | S Σ | 0..1 | string | Family name (often called 'Surname')
given | S Σ | 0..* | string | Given names (not always 'first'). Includes middle names This repeating element order: Given Names appear in the correct order for presenting the name
prefix | Σ | 0..* | string | Parts that come before the name This repeating element order: Prefixes appear in the correct order for presenting the name
suffix | Σ | 0..* | string | Parts that come after the name This repeating element order: Suffixes appear in the correct order for presenting the name
period | Σ | 0..1 | Period | Time period when name was/is in use
Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type HumanName: This extension applies to PractitionerRole, and represents a name by which a practitioner chooses to be known in the context of the delivery of a specific healthcare service.

Differential View

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension(4.0.1) | Alternate name for practitioner in role context
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://digitalhealth.gov.au/fhir/cc/StructureDefinition/alternate-name"
value[x] |  | 1..1 | HumanName | Alternate name
use | S | 0..1 | code | Alternate name use
family | S | 0..1 | string | Family name (often called 'Surname')
given | S | 0..* | string | Given names (not always 'first'). Includes middle names
Documentation for this format

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension(4.0.1) | Alternate name for practitioner in role context Constraints: ext-1
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url Constraints: ext-1
url |  | 1..1 | uri | "http://digitalhealth.gov.au/fhir/cc/StructureDefinition/alternate-name"
value[x] |  | 1..1 | HumanName | Alternate name
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
use | ?!S Σ | 0..1 | code | Alternate name use Binding: NameUse (required): The use of a human name.
text | Σ | 0..1 | string | Text representation of the full name
family | S Σ | 0..1 | string | Family name (often called 'Surname')
given | S Σ | 0..* | string | Given names (not always 'first'). Includes middle names This repeating element order: Given Names appear in the correct order for presenting the name
prefix | Σ | 0..* | string | Parts that come before the name This repeating element order: Prefixes appear in the correct order for presenting the name
suffix | Σ | 0..* | string | Parts that come after the name This repeating element order: Suffixes appear in the correct order for presenting the name
period | Σ | 0..1 | Period | Time period when name was/is in use
Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type HumanName: This extension applies to PractitionerRole, and represents a name by which a practitioner chooses to be known in the context of the delivery of a specific healthcare service.

Other representations of profile: CSV, Excel, Schematron

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x].use | Base | required | NameUse | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | Extension, Extension.value[x], Extension.value[x].extension, Extension.value[x].use, Extension.value[x].text, Extension.value[x].family, Extension.value[x].given, Extension.value[x].prefix, Extension.value[x].suffix, Extension.value[x].period | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | Extension, Extension.value[x].extension | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`