Street numbers and extensions

partner_street_number folder_open OCA/partner-contact open_in_new

Tools License: AGPL-3

This module extends the functionality of base_address_extended to support custom street name formats.

Further, it allows users to turn on manual entry of the components of a street name, and to bulk split/compose street names of existing partners.

auto_awesome What this module does

AI-generated from the code · Odoo 16.0

Lets you split a partner's street into street name, house number and door/extension, and rebuild the full street from those parts. Parsing and formatting rules are configured per country, with a live test tool.

This module extends the address handling of Odoo so that a street can be stored as separate parts instead of one free-text line.

On each country (Contacts > Configuration > Countries, "Street names" section) you can set a parsing rule and a formatting rule, plus a test street to preview the result immediately.
A setting in Contacts settings, "Use split fields for street name in partner form", switches the partner form between the single street field and three separate fields: street name, house number and door/extension.
When a partner's country has a parsing rule, the street text is automatically split into those three parts; when it has a formatting rule, the parts are automatically recombined into the street text.
A wizard, available from the partner list, updates existing partners in bulk: either split their street into components or rebuild the street from the components.
The Netherlands is pre-configured with a rule that recognises a street name followed by a number and an optional extension.

It touches res.partner, res.country, the settings screen and a dedicated wizard, and adds a user group controlling who sees the split fields.

Depends on

base_address_extendedbase_setupweb

Models and fields (4)

res.country · extends an existing modelpartner_street_number_regex (Parse regex), partner_street_number_format (Format expression), partner_street_number_test_value (Full street (for testing)), partner_street_number_test_result
res.partner · extends an existing model
res.config.settings · extends an existing modelgroup_partner_street_number (Use split fields for street name in partner form)
partner.street.number.wizard · new modeldirection

Text generated by AI (DeepSeek) from reading the Odoo 16.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03

Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 1 confirmed, 8 with no information of 9 versions.

Sources · Odoo 16.0

Confirmed on 2026-11-03 in branch 16.0 of OCA/partner-contact.

terminal Installation and usage

OCA documentation · Odoo 16.0

Configuration

Source · Odoo 16.0

To configure this module, you need to:

Go to the form of a country
Fill in the fields 'Parse Regex' and 'Format Expression'
'Parse Regex' should contain named groups with names street_name, street_number, street_number2 that parses the split fields from the content of the street field
'Format Expression' is an Odoo template expression that generates the content of the street field based on the split fields
You can fill in some string to test your expressions, first this string will be decomposed using 'Parse Regex', and then the parts will be joined together using 'Format Expression'. Ideally, that should yield the same value as you filled in

Usage

Source · Odoo 16.0

To use this module, you need to:

Go to a partner
Set the partner's country to a country with the street name parse regex filled
Fill in a street name supported by the country's configuration
Observe that the fields street_name, street_number and street_number2 are filled according to the country's configuration

For bulk updating partner fields (ie after you've changed the configuration of some country wrt street name parsing/formatting), use the Update partner street fields wizard, available for group Contact Creation.

In case you always want to edit the street name components manually, activate setting Use split fields for street name in partner form.

No verified information in OCA: Installation.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.