Algeria Wilayas & Communes
by Yacine Bendou https://apps.odoo.com/apps/browse?repo_maintainer_id=1164033| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 21734 |
| Technical Name |
dz_wilaya_commune_yb |
| License | LGPL-3 |
| Website | https://apps.odoo.com/apps/browse?repo_maintainer_id=1164033 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 21734 |
| Technical Name |
dz_wilaya_commune_yb |
| License | LGPL-3 |
| Website | https://apps.odoo.com/apps/browse?repo_maintainer_id=1164033 |
Algeria's Official
Wilayas & Communes
The complete, authoritative geographic dataset for Algeria — 69 wilayas and 1,541 communes, sourced from the ONS 'Code Géographique National' and 'Loi 26-06', with official names in both French and Arabic.
69 wilayas
1,541 communes
FR + AR official names
Journal Officiel sourced
The problem with other datasets
Wrong data is worse than no data
Algeria's map changed twice in seven years — 48 wilayas became 58 in December 2019 (Loi 19-12), then 58 became 69 in April 2026 (Loi 26-06). Most modules on the market are still stuck on 1984. Others guessed the 59–69 codes from daïra capitals before they were officially created. This module reads the Journal Officiel directly — no guesswork, no outdated snapshots.
Outdated wilaya counts
Loi 19-12 (Dec 2019): 48 → 58. Loi 26-06 (Apr 2026): 58 → 69. Most datasets haven't moved past 1984.
Daïras mistaken for wilayas
Aflou, Barika, Bou Saada and others appear as wilayas 59–69 in many datasets — they were daïra capitals, not wilayas, until 'Loi 26-06'.
No Arabic names
Every wilaya and commune has an official Arabic name. Shipping without them means Arabic-language users see French text in an Arabic interface.
Typical Algeria module
This moduleWhere the data comes from
Two official sources, zero guesswork
Every record traces directly to a government-issued document. Nothing is interpolated, estimated, or borrowed from unofficial third-party lists.
Code Géographique National 2021
Published by the Office National des Statistiques (ONS), this is Algeria's official geographic reference. It lists all wilayas, communes, daïras, and agglomérations with French and Arabic names, reflecting the December 2019 reform (Loi 19-12: 48 → 58 wilayas).
Journal Officiel N° 25 — Loi 26-06
Signed on 4 April 2026. 'Loi n° 26-06' creates 11 new wilayas (codes 59–69) and explicitly lists the communes belonging to each — bringing the total to 69 wilayas.
Bilingual by design
Every record carries its official name in both French and Arabic — exactly as published in the source documents.
What's inside
Everything Algeria needs — nothing more
Two data files — one for wilayas, one for communes. Both are protected with noupdate="1" so your customizations are never overwritten on upgrade.
wilaya_data.xml
All 69 Algerian wilayas, loaded into Odoo's built-in state registry.
commune_data.xml
All 1,541 communes, loaded into the city dropdown provided by 'smart_city_selection_yb'.
Bilingual by design
Every record carries its official name in both French and Arabic — exactly as published in the source documents.
What makes it different
Built right — stays right
noupdate="1" protection
All data records carry noupdate="1". If you rename a wilaya or edit a commune, Odoo will never overwrite your change on the next module upgrade.
Bilingual — FR & AR
Every wilaya and commune ships with its official French name in Title Case and its Arabic name — both sourced directly from the official reference documents.
Official ONS source
Communes sourced from the ONS CGN 2021 (Office National des Statistiques — Code Géographique National). No invented names, no guesswork.
Loi 26-06 compliant
The 69-wilaya map introduced by the Journal Officiel Loi 26-06 (April 2026) is fully reflected. Codes 01–69, no gaps, no duplicates.
69 wilayas, codes 01–69
All 69 wilayas: the original 48 (1984), plus 10 added by Loi 19-12 (December 2019), plus 11 added by Loi 26-06 (April 2026). Each assigned its official 2-digit code.
1,541 communes
Every commune in Algeria — sorted by wilaya, each linked to its parent wilaya and carrying a unique 4-digit geographic code.
4-digit geographic code
Each commune carries a unique 4-digit ONS CGN code — for example, 1601 for Alger-Centre. Searchable and filterable directly in the dropdown.
Zero code — data only
No Python, no models, no views — just two XML data files. Nothing to break, nothing to conflict with, nothing to maintain.
Step 1 — Dependency
Install the city engine first
-
1
Install smart_city_selection_yb
This module depends on
smart_city_selection_yb, which provides the city dropdown model that wilayas and communes are loaded into. Install it first from the Odoo App Store.
Step 2 — This module
Install and it's done
-
1
Drop in your addons path
Copy
dz_wilaya_commune_ybinto your Odoo addons directory alongsidesmart_city_selection_yb, then update the module list. -
2
Click Install — data loads automatically
No configuration needed. 69 wilayas and 1,541 communes are loaded immediately and available in the commune dropdown on any Algerian partner form.
How the data is structured
Communes load into the city dropdown provided by smart_city_selection_yb, and are filtered automatically when a wilaya (state) is selected on the partner form.
Use cases
Who is this built for?
Odoo Implementers
Deploying for Algerian clients? Add it to your standard kit and get accurate wilayas and communes pre-loaded from day one — no manual data entry.
Algerian Businesses
Any company managing Algerian partners, customers, or deliveries needs standardized wilaya and commune data. Stop re-typing the same locations differently every time.
Arabic-Language Deployments
Every record ships with its official Arabic name. Forms, reports, and exports display the correct Arabic designation without any additional configuration.
Government & Public Sector
Agencies that require compliance with official territorial divisions get a dataset sourced directly from the ONS and the Journal Officiel — no improvised lists.
E-Commerce & Logistics
Accurate commune data means accurate delivery addresses. Stop losing shipments to inconsistent or outdated location names across your Algerian customer base.
Algeria rewrote its map twice in seven years — 48 wilayas in 1984, then 58 in December 2019 (Loi 19-12), then 69 in April 2026 (Loi 26-06). I kept finding modules that never caught up, shipping 48 wilayas from a PDF dump, no Arabic names, commune counts that didn't add up. Every project started with a cleanup. This module reads the official sources — ONS CGN and the Journal Officiel — and ships them ready to use. Bilingual, correct, and upgrade-safe.
Technical details
Compatibility & specs
| Odoo version | 19.0 |
|---|---|
| License | LGPL-3 |
| Module type | Data only — no Python, no views, no models |
| Dependencies | base smart_city_selection_yb |
| Wilayas loaded | 69 — codes 01–69 (reflects Loi 26-06, April 2026) |
| Communes loaded | 1,541 — every commune in every wilaya |
| Geographic code | 4-digit identifier per commune (e.g. 1601 = Alger-Centre) |
| Translations | French (fr) and Arabic (ar) — official names |
| Upgrade safety | noupdate="1" — your edits are never overwritten |
| Installation | Drop in addons path and install — no manual configuration. |
Release history
Version changelog
noupdate="1" on all records — upgrade-safe by designQuestions or feedback?
Bug reports and feature suggestions are always welcome.
@ yacine.bendou.01@gmail.com
Please log in to comment on this module