12.5 Manage thematic layers

Thematic maps represent spatial variation of geographic distributions. Select your desired combination of indicator/data element, period and organisation unit level. If your database has coordinates and aggregated data values for these organisation units, they will appear on the map.


You must refresh the DHIS2 analytics tables to have aggregated data values available.

Thematic layers are represented by layer cards in the layer panel such as:

Along the top of the thematic card from left to right are:

In the middle of the thematic card is a legend indicating the value ranges displayed on the layer.

Along the bottom of the thematic card from left to right are:

12.5.1 Create a thematic layer

To create an event layer, choose Thematic on the Add layer selection. This opens the Events layer configuration dialog.

  1. In the DATA tab:

    • Select a data type and then select respectively the group and the target element. The available fields depend on the type of item selected.

    • Select a value from the Aggregation type field for the data values to be shown on the map. By default, “By data element” is selected. Alternative values are: Count; Average; Sum; Standard deviation; Variance; Min; Max. See also Aggregation operators .

  2. In the PERIOD tab

    • select the time span over which the thematic data is aggregated. You can select either a fixed period or a relative period.

      • Fixed period

        In the Period type field select period length, then select the target in the Period field.

      • Relative period

        In the Period type field select Relative , then select one of the relative periods, for example This month or Last year , in the Period field.

  3. In the ORG UNITS tab:

    • Select the organisation units you want to include in the layer. It is possible to select either

      • One or more specific organisation units, or

      • A relative level in the organisation unit hierarchy, with respect to the user. By selecting a User organisation unit the map data will appear differently for users at different levels in the organisation unit hierarchy.

  4. In the STYLE tab:

    • Select either Automatic or Predefined legend.

      • Automatic legend types means that the application will create a legend set for you based on your what method, number of classes, low color and high color you select. Method alludes to the size of the legend classes. Set to

        • Equal intervals

          the range of each interval will be (highest data value - lowest data value / number of classes)

        • Equal counts

          the legend creator will try to distribute the organisation units evenly.

      • If you have facilities in your thematic layer, you can set the radius for minimum and maximum values by changing the values in the Low size and High size boxes respectively.

  5. Click ADD LAYER .

12.5.2 Modify a thematic layer

  1. In the layer panel, click the edit (pencil) icon on the thematic layer card.

  2. Modify the setting on the DATA, PERIOD, ORG UNITS and STYLE tabs as desired.

  3. Click UPDATE LAYER .

12.5.3 Filter values in a thematic layer

Thematic layers have a data table option that can be toggled on or off from the thematic layer card.

The data table displays the data forming the thematic layer.

  • clicking on a title will sort the table based on that column; toggling between ascending and descending.

  • entering text or expressions into the filter fields below the titles will apply those filters to the data, and the display will adjust according to the filter. The filters are applied as follows:

    • NAME

      filter by name containing the given text

    • VALUE

      filter values by given numbers and/or ranges, for example: 2,>3&<8

    • LEGEND

      filter by legend containing the given text

    • RANGE

      filter by ranges containing the given text

    • LEVEL

      filter level by numbers and/or ranges, for example: 2,>3&<8

    • PARENT

      filter by parent names containing the given text

    • ID

      filter by IDs containing the given text

    • TYPE

      filter by GIS display types containing the given text

    • COLOR

      filter by color names containing the given text


Data table filters are temporary and are not saved with the map layers as part of the favourite.

12.5.4 Search for an organisation unit

The NAME filter field in the data table provides an effective way of searching for individual organisation units.

12.5.6 Remove thematic layer

To clear all data in a thematic layer:

  1. In the layer panel, click the delete (trash can) icon on the thematic layer card.

    The layer is removed from the current map.