# Codelists

Some fields in the metadata standard refer to codelists to promote data interoperability. Codelists limit and standardise the possible values of the fields.

Codelists can either be open or closed:

- **Closed codelists** are intended to be comprehensive; for example, the currency codelist covers all currencies in the world.
- **Open codelists** are intended to be representative, but not comprehensive.

Publishers must use the codes in the codelists, unless no code is appropriate. If no code is appropriate and the codelist is **open**, then a publisher may use a new code outside those in the codelist. If no code is appropriate and the codelist is **closed**, then a publisher should instead create an issue in the [RDLS GitHub repository](https://github.com/GFDRR/rdl-standard/issues).

```{admonition} Extending open codelists
---
class: Tip
---
If you use new codes outside those in an open codelist, please create an issue in the [RDLS GitHub repository](https://github.com/GFDRR/rdl-standard/issues), so that the codes can be considered for inclusion in the codelist.
```

The [schema](index.md) has a `codelist` property to indicate the CSV file that defines the codes in the codelist (shown as tables below). It also has an `openCodelist` property, to indicate whether the codelist is open or closed.

Codes are case-sensitive, and are generally provided as English language camelCase. Codes must not be translated.

## Open codelists

### classification_scheme

````{dropdown} Codes

```{button-link} ../../codelists/open/classification_scheme.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/classification_scheme.csv
```

````

### conforms_to

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/open/conforms_to.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/conforms_to.csv
```

````

### damage_scale_name

````{dropdown} Codes

```{button-link} ../../codelists/open/damage_scale_name.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/damage_scale_name.csv
```

````

### engineering_demand_parameter

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/open/engineering_demand_parameter.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/engineering_demand_parameter.csv
```
````

### impact_metric

````{dropdown} Codes

```{button-link} ../../codelists/open/impact_metric.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/impact_metric.csv
```
````

### imt

The IMT codelist defines intensity measures and the hazard types to which each intensity measure applies.

````{dropdown} Codes

```{button-link} ../../codelists/open/imt.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/imt.csv
```
````

````{seealso}

For validation purposes, separate codelists for each hazard type are also provided below: 

```{contents} 
---
local:
depth: 1
---
```

````

#### imt_coastal_flood

````{dropdown} Codes

```{button-link} ../../codelists/open/imt_coastal_flood.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/open/imt_coastal_flood.csv
```
````

#### imt_convective_storm

````{dropdown} Codes

```{button-link} ../../codelists/open/imt_convective_storm.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/open/imt_convective_storm.csv
```
````

#### imt_drought

````{dropdown} Codes

```{button-link} ../../codelists/open/imt_drought.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/open/imt_drought.csv
```
````

#### imt_earthquake

````{dropdown} Codes

```{button-link} ../../codelists/open/imt_earthquake.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/open/imt_earthquake.csv
```
````

#### imt_extreme_temperature

````{dropdown} Codes

```{button-link} ../../codelists/open/imt_extreme_temperature.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/open/imt_extreme_temperature.csv
```
````

#### imt_flood

````{dropdown} Codes

```{button-link} ../../codelists/open/imt_flood.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/open/imt_flood.csv
```
````

#### imt_landslide

````{dropdown} Codes

```{button-link} ../../codelists/open/imt_landslide.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/open/imt_landslide.csv
```
````

#### imt_strong_wind

````{dropdown} Codes

```{button-link} ../../codelists/open/imt_strong_wind.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/open/imt_strong_wind.csv
```
````

#### imt_tsunami

````{dropdown} Codes

```{button-link} ../../codelists/open/imt_tsunami.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/open/imt_tsunami.csv
```
````

#### imt_volcanic

````{dropdown} Codes

```{button-link} ../../codelists/open/imt_volcanic.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/open/imt_volcanic.csv
```
````

#### imt_wildfire

````{dropdown} Codes

```{button-link} ../../codelists/open/imt_wildfire.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/open/imt_wildfire.csv
```
````

### license

````{dropdown} Codes

```{button-link} ../../codelists/open/license.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/license.csv
```
````

### location_gazetteers

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/open/location_gazetteers.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/location_gazetteers.csv
```
````

### media_type

````{dropdown} Codes

```{button-link} ../../codelists/open/media_type.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/media_type.csv
```
````

### quantity_kind

```{seealso}
[units](#units)
```

The quantity kind codelist is a subset of the codes in the [QUDT Quantity Kind Vocabulary](https://www.qudt.org/doc/DOC_VOCAB-QUANTITY-KINDS.html). It includes a code for the [currency quantity kind](https://qudt.org/vocab/quantitykind/Currency), which does not appear in the vocabulary because QUDT lists currencies in a separate graph from other quantity kinds.

````{dropdown} Codes

```{button-link} ../../codelists/open/quantity_kind.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/quantity_kind.csv
```
````

### roles

The roles codelist is based on the [ISO19115 CI_RoleCode codelist](https://standards.iso.org/iso/19115/resources/Codelists/gml/CI_RoleCode.xml) with the addition of 'world_bank_team_lead' and the omission of codes covered by the `creator`, `contact_point` and `publisher` fields.

````{dropdown} Codes

```{button-link} ../../codelists/open/roles.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/roles.csv
```
````

### units

For validation purposes, a separate unit codelist for each [quantity kind](#quantity_kind) is provided:

```{contents}
---
local:
depth: 1
---
```

Each codelist is a subset of the codes in the [QUDT Unit Vocabulary](https://www.qudt.org/doc/DOC_VOCAB-UNITS.html).

```{seealso}

[unit_currency](#unit_currency) (closed codelist)

```

#### unit_area

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/open/unit_area.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/unit_area.csv
```
````

#### unit_count

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/open/unit_count.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/unit_count.csv
```
````

#### unit_dimensionless_ratio

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/open/unit_dimensionless_ratio.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/unit_dimensionless_ratio.csv
```
````

#### unit_length

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/open/unit_length.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/unit_length.csv
```
````

#### unit_mass

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/open/unit_mass.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/unit_mass.csv
```
````

#### unit_mass_per_area

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/open/unit_mass_per_area.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/unit_mass_per_area.csv
```
````

#### unit_time

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/open/unit_time.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/unit_time.csv
```
````

#### unit_volume

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/open/unit_volume.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/open/unit_volume.csv
```
````

## Closed codelists

### analysis_type

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/closed/analysis_type.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/analysis_type.csv
```
````

### climate_scenario

````{dropdown} Codes

```{button-link} ../../codelists/closed/climate_scenario.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/climate_scenario.csv
```
````

### country

````{dropdown} Codes

```{button-link} ../../codelists/closed/country.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/country.csv
```
````

### data_calculation_type

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/closed/data_calculation_type.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/data_calculation_type.csv
```
````

### exposure_category

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/closed/exposure_category.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/exposure_category.csv
```
````

### frequency_distribution

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/closed/frequency_distribution.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/frequency_distribution.csv
```
````

### function_approach

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/closed/function_approach.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/function_approach.csv
```
````

### hazard_type

The RDLS offers a classification of hazards that are more often required in disaster risk assessments, based on the review and mapping of existing alternative definitions into one consistent framework. For more information, see [hazard taxonomies](../rdl/other-standards.md#hazard-taxonomies).

The hazard_type codelist classifies hazard phenomena by the main hazard to which they relate. Hazard phenomena can also be classified by the hazard process to which they relate. For more information, see the [process_type codelist](#process_type).

The hazard_type codelist includes a mapping from the RDLS hazard types to the hazard categories defined in the [UNDRR Hazard Information Profiles](https://www.undrr.org/publication/documents-and-publications/hazard-information-profiles-hips-2025-version).

````{dropdown} Codes

```{button-link} ../../codelists/closed/hazard_type.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/hazard_type.csv
```
````

### impact_type

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/closed/impact_type.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/impact_type.csv
```
````

### loss_type

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/closed/loss_type.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/loss_type.csv
```
````

### loss_statistic

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/closed/loss_statistic.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/loss_statistic.csv
```
````

### metric_dimension

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/closed/metric_dimension.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/metric_dimension.csv
```
````

### process_type

The process_type codelist defines hazard processes and the hazard types to which they relate. Hazard phenomena can also be the main hazard to which they relate. For more information, see the [hazard_type codelist](#hazard_type). Process types are based primarily on the [UNDRR Hazard terminology](https://www.undrr.org/publication/hazard-definition-and-classification-review-technical-report) and the codelist includes a mapping to [EM-DAT](https://www.emdat.be/) and the [UNDRR Hazard Information Profiles](https://www.undrr.org/publication/documents-and-publications/hazard-information-profiles-hips-2025-version).

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/process_type.csv
```
````

````{seealso}

For validation purposes, separate codelists for each hazard type are also provided below: 

```{contents} 
---
local:
depth: 1
---
```

````

#### process_type_convective_storm

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type_convective_storm.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/closed/process_type_convective_storm.csv
```
````

#### process_type_drought

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type_drought.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/closed/process_type_drought.csv
```
````

#### process_type_dust_sand_storm

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type_dust_sand_storm.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/closed/process_type_dust_sand_storm.csv
```
````

#### process_type_earthquake

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type_earthquake.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/closed/process_type_earthquake.csv
```
````

#### process_type_erosion

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type_erosion.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/closed/process_type_erosion.csv
```
````

#### process_type_extreme_temperature

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type_extreme_temperature.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/closed/process_type_extreme_temperature.csv
```
````

#### process_type_flood

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type_flood.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/closed/process_type_flood.csv
```
````

#### process_type_landslide

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type_landslide.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/closed/process_type_landslide.csv
```
````

#### process_type_pest_infestation

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type_pest_infestation.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/closed/process_type_pest_infestation.csv
```
````

#### process_type_sea_level_rise

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type_sea_level_rise.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/closed/process_type_sea_level_rise.csv
```
````

#### process_type_strong_wind

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type_strong_wind.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/closed/process_type_strong_wind.csv
```
````

#### process_type_tsunami

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type_tsunami.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/closed/process_type_tsunami.csv
```
````

#### process_type_volcanic

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type_volcanic.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/closed/process_type_volcanic.csv
```
````

#### process_type_wildfire

````{dropdown} Codes

```{button-link} ../../codelists/closed/process_type_wildfire.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../docs/_readthedocs/html/codelists/closed/process_type_wildfire.csv
```
````

### relationship_type

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/closed/relationship_type.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/relationship_type.csv
```
````

### risk_data_type

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/closed/risk_data_type.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/risk_data_type.csv
```
````

### seasonality

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/closed/seasonality.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/seasonality.csv
```
````

### source_type

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/closed/source_type.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/source_type.csv
```
````

### spatial_scale

````{dropdown} Codes
---
open:
---
```{button-link} ../../codelists/closed/spatial_scale.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/spatial_scale.csv
```
````

### taxonomy_ged4all

```{seealso}
[classification scheme](#classification_scheme)

```

````{dropdown} Codes

```{button-link} ../../codelists/closed/taxonomy_ged4all.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/taxonomy_ged4all.csv
```
````

### unit_currency

```{seealso}
[units](#units)

```

````{dropdown} Codes

```{button-link} ../../codelists/closed/unit_currency.csv
:color: primary
:shadow:
Download CSV file
```

```{csv-table-no-translate}
:header-rows: 1
:widths: auto
:file: ../../schema/codelists/closed/unit_currency.csv
```
````