Hybrid address
A hybrid address is the ISO 20022 postal-address format in which Country and Town Name are carried in dedicated structured XML elements (<Ctry>, <TwnNm>), while residual content may be carried in up to two free-format <AdrLine> elements of 70 characters each. Codified as a permanent compliant option by CPMI harmonisation requirements — technical annex (February 2026), it is accepted alongside fully structured addresses from the 15 November 2026 cutover.
How Hybrid address works in practice
Hybrid is the pragmatic baseline for institutions whose source data is only partially structured. The CPMI harmonised model caps <AdrLine> at [0..2] occurrences — down from the native [0..7] — and content placed in structured elements must not be repeated in the address lines (the No-Duplication Rule). Hybrid is permanent: it has no end date and must never be described as transitional.
Source: CPMI harmonisation requirements — technical annex §0.31 / p5; §3 footnote / p6-3; CPMI harmonised ISO 20022 data requirements §0.84 / R11 / p20-6; the ioNova Postal Address Specification v2.0 §3.4.2 / §17.1.
Three formats sit side by side until the cutover: fully structured — every component in a dedicated element, no <AdrLine> used, preferred where source data permits; hybrid — the pragmatic baseline described here; and fully unstructured — everything packed into <AdrLine>, rejected in newly initiated cross-border payments from 15 November 2026.
Source: the ioNova Postal Address Specification v2.0 §7.1 Table 12; Swift, Removal of unstructured address.4 / p1-1.
A compliant hybrid address (the campaign's worked example):
<PstlAdr> <PstCd>6011</PstCd> <TwnNm>WELLINGTON</TwnNm> <Ctry>NZ</Ctry> <AdrLine>169 CUBA STREET</AdrLine> </PstlAdr>
By contrast, the fully unstructured form is rejected at point of entry from 15 November 2026:
<!-- NON-COMPLIANT from 15 November 2026 --> <PstlAdr> <AdrLine>169 CUBA STREET</AdrLine> <AdrLine>WELLINGTON 6011</AdrLine> <AdrLine>NEW ZEALAND</AdrLine> </PstlAdr>
Parent reference: ISO 20022 deadline — the structured address mandate.
Sources
Standards & regulatory sources
- Harmonised ISO 20022 data requirements for enhancing cross-border payments — technical annex — BIS Committee on Payments and Market Infrastructures (CPMI), 26 February 2026.
- Harmonised ISO 20022 data requirements for enhancing cross-border payments — updated report — BIS Committee on Payments and Market Infrastructures (CPMI), 26 February 2026.
- Hybrid Postal Address, Version 1.12 — Payments Market Practice Group (PMPG), 5 March 2026.
- ISO 20022 — Removal of unstructured address — Swift, 2026.
ioNova reference material
- ioNova ISO 20022 Postal Address — Requirements and Specifications v2.0, May 2026 — ioNova reference work consolidating the sources above. Request the specification in a demo.
See ioNova ARS in action
The complete ISO 20022 Postal Address — Requirements and Specifications Update 2026 consolidates the CPMI harmonisation requirements, the BIS PIE taskforce report, the PMPG Hybrid Postal Address whitepaper and the EPC address guidance into a single reference.
Book a demo