---
id: "dwc_taxon_rank"
kind: "datatype"
status: "draft"
is_pii: false
categories: ["science"]
langs: ["common"]
quality: 85
url: "https://registry.apicrafter.io/datatype/dwc_taxon_rank"
---

# Darwin Core taxon rank (`dwc_taxon_rank`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

Taxonomic rank of a scientific name (Darwin Core term taxonRank): kingdom, phylum, class, order, family, genus, species and the ranks between and below them (subfamily, tribe, subspecies, variety, form). GBIF writes them in upper case (SPECIES, GENUS); checklists also use lower case or abbreviations (sp., var.).

- Parent datatype: `category`
- Personal data (PII): no
- Categories: Scientific (science)
- Countries: global
- Languages: Common to most languages (common)
- Classification: categorical

## Detection

Regular expression (Python `re`):

```
^(?:DOMAIN|SUPERKINGDOM|KINGDOM|SUBKINGDOM|SUPERPHYLUM|PHYLUM|SUBPHYLUM|SUPERCLASS|CLASS|SUBCLASS|INFRACLASS|SUPERORDER|ORDER|SUBORDER|INFRAORDER|SUPERFAMILY|FAMILY|SUBFAMILY|TRIBE|SUBTRIBE|GENUS|SUBGENUS|SECTION|SERIES|SPECIES|SUBSPECIES|VARIETY|SUBVARIETY|FORM|SUBFORM|CULTIVAR|STRAIN|UNRANKED|domain|superkingdom|kingdom|subkingdom|superphylum|phylum|subphylum|superclass|class|subclass|infraclass|superorder|order|suborder|infraorder|superfamily|family|subfamily|tribe|subtribe|genus|subgenus|section|series|species|subspecies|variety|subvariety|form|subform|cultivar|strain|unranked|Domain|Superkingdom|Kingdom|Subkingdom|Superphylum|Phylum|Subphylum|Superclass|Class|Subclass|Infraclass|Superorder|Order|Suborder|Infraorder|Superfamily|Family|Subfamily|Tribe|Subtribe|Genus|Subgenus|Section|Series|Species|Subspecies|Variety|Subvariety|Form|Subform|Cultivar|Strain|Unranked)$
```

## Examples

- `SPECIES` — GBIF occurrence
- `GENUS` — GBIF occurrence
- `subspecies` — Checklist
- `Family` — Checklist
- `ACCEPTED` (invalid example) — Taxonomic status

## Metacrafter rules

2 rules: 1 match the field name, 1 match values.

- `dwctaxonrankknown` (field, `common/science.yaml`)
- `dwctaxonrankvalue` (data, `common/science.yaml`)

## Supported by tools

- `metacrafter`

## Sources

- doc: <https://dwc.tdwg.org/terms/#dwc:taxonRank>
- wikipedia: <https://en.wikipedia.org/wiki/Taxonomic_rank>

## Quality

Score 85/100. Missing: mapping (Wikidata, Schema.org, ...), translation.

JSON: <https://registry.apicrafter.io/api/v1/datatypes/dwc_taxon_rank.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/any/science/dwc_taxon_rank.yaml>