# Locations

<p class="doc-lead">Locations build a geographic hierarchy used on customers, suppliers, employees, and reports: Country → State → District → Area. Manage the tree from one screen with contextual New actions at each level.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<div class="doc-toc-links">
<a href="#/settings/locations?id=overview">Overview &amp; List View</a>
<a href="#/settings/locations?id=quick-start">Quick Start</a>
<a href="#/settings/locations?id=fields">Fields</a>
<a href="#/settings/locations?id=actions">Actions</a>
<a href="#/settings/locations?id=faq">FAQ</a>
<a href="#/settings/locations?id=related">Related</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview &amp; List View</h2>

Go to <b>Settings → Others → Locations</b> from the left menu.

The list is a hierarchical tree (not a flat grid). Expand countries to see states, districts, and areas. Scroll loads more rows at each level.

<!-- screenshot pending -->

<b>List columns</b>

| **Column** | **Description** |
|------------|-----------------|
| Id | Location record ID. |
| Name | Location name. |
| Code | Short code for the location. |
| Type | Country, State, District, or Area. |

<b>List actions</b>

| **Action** | **Description** |
|------------|-----------------|
| New | Add a country, or add a child at the current level (State under Country, etc.). |
| View | Read-only detail. |
| Edit | Change name or code. |
| Delete | Remove unused locations (multi-select). |

<hr class="doc-section-divider">

<h2 id="quick-start">Quick Start</h2>

<h3>1. Add countries</h3>
Click <b>New</b> at the top level and create each country.

<h3>2. Add states and below</h3>
Use <b>New</b> on a country row to add states; repeat for districts and areas.

<h3>3. Use on masters</h3>
Select Country, State, District, and Area on customer, supplier, and employee addresses.

<hr class="doc-section-divider">

<h2 id="fields">Fields</h2>

| **Field** | **Description** |
|-----------|-----------------|
| Name * | Display name at this level. |
| Code | Optional code for integrations or reports. |
| Type | Level in the hierarchy (set by where you create the record). |
| Parent | Implicit from the tree node where you clicked New. |

<hr class="doc-section-divider">

<h2 id="actions">Actions</h2>

Same as list row actions above. Suspend is not used on locations — use Delete when a level is unused.

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<p><b>Can I skip District or Area?</b></p>
<p>Create only the levels you need. Address fields on masters show the levels that exist in your tree.</p>

<p><b>Locations vs Zones?</b></p>
<p><a href="#/settings/zones">Zones</a> group districts for sales territory; Locations define the address hierarchy.</p>

<p><b>Can I rename a location level after use?</b></p>
<p>Yes. Existing addresses keep linked IDs — names update on masters and reports that display location text.</p>

<p><b>Must I create Country before State?</b></p>
<p>Build the tree top-down: Country → State → District → Area as needed. Skip levels your addresses do not use.</p>

<p><b>Do locations affect tax?</b></p>
<p>Tax rules may reference state or territory separately — locations structure addresses; tax config lives under Accounts settings.</p>

<p><b>Can I delete a district with customers?</b></p>
<p>Deletion may be blocked when customers or suppliers reference the location. Reassign addresses first.</p>

<hr class="doc-section-divider">

<h2 id="related">Related Topics</h2>

<ul>
<li><a href="#/settings/zones">Zones</a></li>
<li><a href="#/sales/customers">Customers</a></li>
<li><a href="#/purchase/suppliers">Suppliers</a></li>
</ul>
