> For the complete documentation index, see [llms.txt](https://docs.os.uk/osngd/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.os.uk/osngd/data-structure/address/address-related-components/multiple-residence.md).

# Multiple Residence

{% hint style="warning" %}
This page details upcoming data that will be provided for the new Multiple Residence Related Component in the OS NGD Address Theme from the start of October 2026 to give you early insight. The new related component won't be available via OS Select+Build (the bespoke OS NGD data download service) until the start of October when data schema version 2.0 of the Royal Mail Address Feature Types is released.

The information on this page is as accurate as possible but is subject to change before launch.
{% endhint %}

The Multiple Residence Component (also known as MR) provides data developed to identify addresses that&#x20;are delivered to a shared delivery point; this means premises with one front door, or delivery point, that has been subdivided into flats, units or other separate occupancies. Multiple residence data provide a detailed address&#x20;structure for these properties.&#x20;

For more information about multiple residence attribution, please consult chapter 18 'Multiple Residence' of the [Royal Mail Programmer's Guide](https://www.poweredbypaf.com/resources/).

{% hint style="info" %}

### Multiple Residence Component for Royal Mail Address Feature Type data schema version 2.0 onward

Customers taking data schema version 2.0 onward of the Royal Mail Address Feature Types in GeoPackage format will receive the following in their data package:

* **Feature type:** Royal Mail Address
* **Related components:** Multiple Residence, Delivery Point Alias and Other Alias

However, the three related components (Multiple Residence, Delivery Point Alias and Other Alias) will only be provided for Royal Mail Address features if the Description attribute is 'Postcode Address File'. Against all other Royal Mail Address features, the related components will be populated as null.
{% endhint %}

## Temporal filtering

The earliest date on which you can request a one-off snapshot of a date in the past for data in this feature type is 01 October 2026.&#x20;

Any data temporally filtered earlier than the specified earliest date noted above for the data schema version may contain data inconsistencies.

More information about temporal filtering is available from the [Getting started with temporal filtering guide](/osngd/getting-started/downloading-with-os-select+build/getting-started-with-data-packages/getting-started-with-temporal-filtering.md).

## Related component attributes

The following sub-sections provide details about the attributes included with this related component, their data types in the different output formats, and other important metadata about them.

### umrrn

Royal Mail's Unique Multiple Residence Reference Number (UMRRN).

* **Data Types:** Integer (GPKG), Integer (CSV)
* **Nullable:** false
* **Max Length:** 8
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### uprn

The Unique Property Reference Number (UPRN) to which a Unique Multiple Residence Reference Number (UMRRN) has been matched.

* **Data Types:** Integer (GPKG), Integer (CSV)
* **Nullable:** true
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### udprn

Unique Delivery Point Reference Number (UDPRN) assigned by Royal Mail as a persistent identifier.

* **Data Types:** Integer (GPKG), Integer (CSV)
* **Nullable:** false
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### featuretypeversiondate

Date of the feature version to which this related component applies. This is used along with the Feature Type ID attribute to join the component to the Royal Mail Address Feature Type.

* **Data Types:** Date (GPKG), Date (CSV)
* **Nullable:** false
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### multiresorganisationname

The name of the organisation operating from the Multiple Residence address.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 60
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### multiresdepartmentname

For some organisations, department name is indicated because mail is received by subdivisions of the main organisation at distinct delivery points.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 60
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### multiressubbuildingname

The sub building name and / or number are identifiers for subdivisions of properties.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 30
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### multiresbuildingname

The building name is a description applied to a single building or a small group of buildings, such as HIGHFIELD HOUSE. This also includes those building numbers that contain non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the building name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 50
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### multiresbuildingnumber

The building number is a number given to a single building or a small group of buildings, thus identifying it from its neighbours, for example, 44. Building numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Building Name or the Sub Building Name fields.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 4
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### multiresdependentthoroughfare

In certain places, for example, town centres, there are named thoroughfares within other named thoroughfares, for example, parades of shops on a high street where different parades have their own identity. For example, KINGS PARADE, HIGH STREET and QUEENS PARADE, HIGH STREET.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 80
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### multiresthoroughfare

A thoroughfare is a road, track or named access route on which there are Royal Mail delivery points, for example, HIGH STREET.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 80
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### multiresdoubledependentlocality

This is used to distinguish between similar thoroughfares or the same thoroughfare within a dependent locality. For example, Millbrook Industrial Estate and Cranford Estate in this situation: BRUNEL WAY, MILLBROOK INDUSTRIAL ESTATE, MILLBROOK, SOUTHAMPTON and BRUNEL WAY, CRANFORD ESTATE, MILLBROOK, SOUTHAMPTON.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 35
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### multiresdependentlocality

Dependent locality areas define an area within a post town. These are only necessary for postal purposes and are used to aid differentiation where there are thoroughfares of the same name in the same locality. For example, High Street in Shirley and Swaythling in this situation: HIGH STREET, SHIRLEY, SOUTHAMPTON and HIGH STREET, SWAYTHLING, SOUTHAMPTON.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 35
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### multiresposttown

The town or city in which the Royal Mail sorting office is located which services this record. There may be more than one, possibly several, sorting offices in a town or city.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Max Length:** 30
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### multirespostcode

The postcode unit that the Address is situated within. A postcode is an abbreviated form of address, made up of combinations of between five and seven alphanumeric characters. These alphanumeric characters are used by Royal Mail to help with the automated sorting of mail. A postcode may cover between 1 and 100 addresses. Postcodes (for example, NW6 4DP) are comprised of two components. The first component is the outward code (or ‘outcode’), which is the first two to four characters of a postcode, constituting the postcode area and the postcode district, for example, NW6. The outward code is the part of the postcode that enables mail to be sent from the accepting office to the correct area for delivery. The second component of a postcode is the inward code (or ‘incode’), which is the last three characters of the postcode, constituting the postcode sector and the postcode unit, for example, 4DP. The inward code is used to sort mail at the local delivery office.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Max Length:** 8
* **OS Select+Build Filterable:** Yes
* **Data Schema Version:** 2.0

### multirespostcodetype

Describes the address as a small or large user as defined by Royal Mail.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Code List Name:** [postcodetypevalue](/osngd/code-lists/code-lists-overview/postcodetypevalue.md)
* **Max Length:** 10
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### multiresdeliverypointsuffix

A two-character code uniquely identifying an individual delivery point within a postcode.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Max Length:** 2
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.os.uk/osngd/data-structure/address/address-related-components/multiple-residence.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
