OdooWiki OCA HUB

United States - Counties

l10n_us_base_county folder_open OCA/l10n-usa open_in_new
Localization License: LGPL-3

Imported from U.S. Census Bureau data. https://www.census.gov/library/publications/2011/compendia/usa-counties-2011.html

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Adds a county field to contacts and a county list for the United States, so you can record and filter addresses by county.

This module adds United States counties to Odoo. It creates a new list of counties, each linked to a state and country, and adds a 'County' field to contact addresses.

Where it appears: - A new 'Counties' menu under Contacts > Configuration > Localization, where you can see and search all counties. - On contact forms, a 'County' field appears in the address section, next to city, state and zip.

Business rules and behaviours: - County names must be unique within each state; you cannot create two counties with the same name in the same state. - When you pick a county on a contact, only counties belonging to the selected state are shown. - You cannot delete a county that is still used by a contact. - The county field is read-only for child contacts that have a parent company.

Who can do what: - All internal users can view counties. - Only administrators (system group) can create, edit or delete counties.

The module also includes a technical import routine to load county data from a U.S. Census Bureau spreadsheet, but this is not exposed as a menu or button for regular users.

Depends on

contactsl10n_us

Required by other modules

l10n_us_crm_county

Menus it adds

Counties
Models and fields (2)
  • res.partner · extends an existing modelcounty_id
  • res.country.state.county · new modelname, state_id, country_id

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. 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.

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.