Hybrid addresses in ISO 20022, explained
A hybrid address keeps Town Name and Country in structured ISO 20022 elements while allowing up to two 70-character address lines for the remaining details. It is one of the two formats SWIFT CBPR+ and SEPA continue to accept once fully unstructured addresses are retired.
Unstructured, Hybrid, Fully Structured
Every ISO 20022 postal address takes one of these shapes. From the November 2026 standards release, only hybrid and fully structured remain valid.
The whole address is carried in free-text AdrLine elements. This is the legacy MT habit carried into MX, and it creates the highest repair, screening, and rejection risk.
<AdrLine>Hauptstr. 17, 3rd Fl.</AdrLine> <AdrLine>10115 Berlin Germany</AdrLine>
Town and country move to structured fields. Up to two address lines may carry the remaining details, but structured content must not be duplicated inside those lines.
<TwnNm>Berlin</TwnNm> <Ctry>DE</Ctry> <AdrLine>Hauptstr. 17, 3rd Fl., 10115</AdrLine>
Every address component gets its own ISO 20022 element and no address line is used. This is the cleanest format for STP, sanctions screening, and audit evidence.
<StrtNm>Hauptstrasse</StrtNm> <BldgNb>17</BldgNb> <PstCd>10115</PstCd> <TwnNm>Berlin</TwnNm> <Ctry>DE</Ctry>
Format Comparison
| Dimension | Fully Unstructured | Hybrid | Fully Structured |
|---|---|---|---|
| Accepted after November 2026 | No | Yes | Yes |
| AddressLine permitted | Legacy free text | Up to 2 x 70 characters | None |
| Structured minimum | None | Town Name + Country | Every populated component |
| Duplication rule | N/A | Structured content must not repeat in AddressLine | N/A |
| STP potential | Lowest | Medium | Highest |
| Best use | Remediate before cutover | Transition traffic and incomplete counterparty data | Every flow you control |
How The Rules Tighten
5 October 2025
SEPA introduces hybrid addresses with structured town and country plus limited address lines.
22 November 2025
CBPR+ and HVPS+ follow. Banks may send structured, hybrid, or unstructured during the transition year.
14 November 2026
Fully unstructured addresses are retired. Only fully structured or hybrid remain valid.
Value-Date Rule
Future-dated instructions with a value date on or after cutover need compliant address data before they reach the network.
Hybrid Or Fully Structured?
Hybrid is acceptable, but it is a bridge. The practical target for controlled data is fully structured output with the ability to render hybrid when a scheme or counterparty requires it.
- Source data cannot yet be resolved to every structured component with confidence.
- A counterparty or corridor still supplies incomplete details.
- You need guaranteed acceptance while remediation continues.
- You control onboarding, master data, or payment assembly.
- Sanctions-screening precision and lower false positives matter.
- You need field-level audit evidence for an examiner.
Hybrid Address Questions
A hybrid address carries Town Name and Country in dedicated structured elements while allowing up to two 70-character AddressLine elements for the remaining details.
No. PMPG guidance requires non-duplication: content carried in structured elements must not appear again inside AddressLine. ioNova ARS enforces this automatically.
Yes. Hybrid remains accepted after the cutover. Fully unstructured addresses are the format being retired.
Emit the exact shape every scheme requires.
Fully structured or hybrid, per scheme and per counterparty, resolved and rule-cited in one call.