Admin: Manage geographic areas

Admin: Manage geographic areas

Work in progress. This page is published before its review is finished so you can use it now. It is being reviewed under OGC-1469, so details may still change. If something on your screen does not match, add a comment to this page.

OpenELIS 3.3.0. This page describes the Locations & Organizations admin introduced in 3.3.0 (released 20 October 2026). See also Admin: Manage organizations and Admin: Manage sampling sites.

At a glance

Purpose

Keep the list of your country's administrative areas (for example Region, Province, District and LLG) that patient addresses, organizations and sampling sites point to.

You'll end up with

Areas arranged in a tree under their parents, active and available in the Location pickers.

Who does this

Administrators. Access is set by user permissions and can be configured by your administrator.

Before you start

Geographic levels must exist before any area can be added. Most deployments load levels and areas once from the national list with Import / Export, then add or correct areas here.

Where

Main menu → Admin → Locations & Organizations → Geographic Areas

Geographic areas are the administrative divisions of the country. Each area has a name, a code and a level, and sits inside an area of the level above. They are used for patient addresses and to say where each organization and sampling site is. Pickers that filter by location include the areas beneath the one you choose.

Step 1: Browse the areas

  1. Open Main menu → Admin → Locations & Organizations → Geographic Areas. Until geographic levels exist, the list is empty and Add is unavailable.

  2. The list shows top-level areas first. Its columns are Name, Code, Level, Child areas (how many areas sit directly inside), Active and Actions. Expand a row with its arrow to load its children, or use Expand all and Collapse all.

  3. Use Search areas by name or code to find an area, and Status (Active, Inactive or All) to include inactive areas.

    Figure 1. Areas for three regions of Papua New Guinea, expanded. Each row's Actions offer the level below (Province, District, LLG) and Edit.

    Figure 1. Areas for three regions of Papua New Guinea, expanded. Each row's Actions offer the level below (Province, District, LLG) and Edit.

Step 2: Add an area

  1. To add an area inside another one, click the next level's button on the parent row, for example District + on Morobe Province. A row opens under the parent, labelled with the level and the parent (New District · Morobe Province).

  2. Enter the name (required) and an optional Code, then click Save. Save stays unavailable until a name is entered. Cancel closes the row.

    Figure 2. Adding a district inside Morobe Province.

    Figure 2. Adding a district inside Morobe Province.

  3. For a new top-level area, use Add Region (the button is named after your top level) at the top of the list.

Step 3: Edit, deactivate or reactivate an area

  1. Click Edit on an area's row to change its name or code.

  2. Use the Active switch to deactivate an area that is no longer used. Inactive areas are hidden from pickers but stay on existing records. Set Status to Inactive or All to find them again.

Tips and notes

  • A district without LLGs is fine. Organizations and sites can point to whichever level you know.

Provenance

Drafted

12 October 2026 against 3.3.0-SNAPSHOT on testing.openelis-global.org (Epic OGC-1363, Feature Doc OGC-1414).

DRIVEN: empty state (Add unavailable before levels), Expand all, opening the add-child row on Morobe Province (Save unavailable while empty, Cancel). Areas were loaded with Import / Export.

OBSERVED only: Add Region, Edit, the Active switch, Search, Status. Saving an area added on this page was not done.

1 November 2026: release note updated (3.3.0 released 20 October); organizations link now points to the merged page 1437892659. Text only, no steps re-driven.