OdooWiki OCA HUB

French States (Régions)

l10n_fr_state folder_open OCA/l10n-france open_in_new
French Localization License: AGPL-3

This module populate the table res_country_state with the french states (Régions françaises), but only the french states of mainland. If you need the overseas states, please install the module l10n_fr_department_oversea.

In the past, the module was using 3166-2:FR codifications without country prefix (more detail on Wikipedia), but unfortunately this codification hasn't been updated since 2013, so we can't use it with the new organisation of regions that was introduced on January 1st 2016. So we switched to the INSEE codification, cf Wikipedia (Codes_géographiques_de_la_France) ; by the way, this codification is also used by geonames.org.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Loads the 13 French mainland regions (Régions) into Odoo's States list for France, using the official INSEE codes. Users can then select a French region on any address form.

This module fills Odoo's built-in States/Provinces list with the French mainland regions, so that when a country is set to France, users can pick the correct region instead of typing it by hand.

  • It adds 13 regions to the res.country.state list: Grand Est, Nouvelle-Aquitaine, Auvergne-Rhône-Alpes, Bourgogne-Franche-Comté, Bretagne, Centre-Val de Loire, Corse, Île-de-France, Occitanie, Hauts-de-France, Normandie, Pays de la Loire and Provence-Alpes-Côte d'Azur.
  • Each region is stored with its INSEE code (for example 11 for Île-de-France, 84 for Auvergne-Rhône-Alpes), which is the coding used by INSEE and geonames.org.
  • The regions are linked to France (base.fr), so they appear in the State field of any address form (contacts, companies, partners) once the country is France.
  • On installation, a pre-installation step checks whether a state with the same code already exists for France; if it does, the module reuses it instead of creating a duplicate, and simply links the module's reference to the existing record.
  • The data is loaded as non-updatable, so the region names and codes are not overwritten by later updates.

Overseas French territories are not included; a separate module is needed for those. No new menus, buttons, reports or automatic business rules are added — the module only enriches the reference data used across Odoo.

Depends on

base

Required by other modules

Text generated by AI (DeepSeek) from reading the Odoo 19.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: 8 confirmed, 1 with no information of 9 versions.

Sources · Odoo 19.0

Confirmed on 2026-11-03 in branch 19.0 of OCA/l10n-france.

terminal Installation and usage

No verified information

Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.

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.