Template:Taxobox/doc

This template sets up a taxobox, a table setting out the Biological classification (taxonomy) for a group of living things with a choice of over 160 parameters. Although the implementation is complicated, it is relatively simple to use. For an example in practice, look at the edit page of "Killer whale" – []. Most parameters are optional, so if a particular entry is not relevant for your case, just leave it out. See "All parameters" for a complete list.

This guide has come out of WikiProject Tree of life.

Usage
Colors are automatically assigned based on the table below.

Plant species


Animal species


Plant higher taxon


Animal higher taxon


Name
For plants, see CorporisPublica:Naming conventions (flora).

For all other living things, the name should be the most common vernacular name when one is in widespread use, and a scientific name otherwise.
 * Common names of higher taxa are always given in sentence case and in the plural (e.g. Marine hatchetfishes).
 * Common names of species and subspecies are sometimes given in title case (e.g. White Wagtail), and sometimes in sentence case (e.g. Colorado potato beetle).

The name parameter should not be used to incorporate more than one name, e.g. a situation where both the scientific name and vernacular were to be displayed (example at Sunflower). It is only a header and not meant to be an inclusive "names" field. One will suffice.

Color
The color is automatically assigned based on the entry for regnum, virus_group. unranked_phylum or phylum, in that order; there is no need to specify it manually. If you do, be sure to use rgb or hsl format; see examples below.

The eukaryote box uses the color "rgb(224, 208, 176)", but since it is split completely into kingdoms other eukaryote groups should not.

Classification
As noted above, the classification section includes some or all of the following:


 * regnum =
 * phylum =
 * classis =
 * ordo   =
 * familia =
 * genus  =
 * species =

Each entry corresponds to a containing group, except for the last, which should be the group under consideration. Note the entries use the Latin names for the ranks, to make porting between CorporisPublicas easier. Thus the above correspond to the kingdom, phylum, class, order, family, genus, and species.

Taxoboxes should include all major ranks above the taxon described in the article, plus minor ranks that are important to understanding the classification of the taxon described in the article, or which are discussed in the article. Other minor ranks should be omitted.

For example, in the taxobox for the genus Formica, it's appropriate to include entries for tribe and subfamily, since those are an aid to understanding how Formica relates to other genera in the family Formicidae. But it wouldn't be appropriate to include the superorder Endopterygota, since all genera of ants are in that superorder; it isn't particularly interesting at this level.

Another example is the subfamily Bambusoideae, the bamboos. This subfamily probably should be mentioned in the taxobox of every bamboo species, since it is a major grouping in this context, despite its minor rank.

Minor ranks are included in the same way as major ranks, for example:


 * classis   = ...
 * subclassis = ...
 * superordo = ...
 * ordo      = ...

Note that species and subspecies should be given using the abbreviated forms of their name — e.g. H. sapiens, H. s. sapiens. The epithets should not be given by themselves. The full form of the species or subspecies name is given in the binomial or trinomial section.

See for a complete list.

Classification status
With the classification_status parameter, it is possible to introduce extra text within parentheses after "Scientific classification". For example, |classification_status=disputed will produce "Scientific classification (disputed)". See Veratalpa for a current example where this parameter is used. This parameter should only be used when the "Scientific classification" text would be misleading without it.

Divisions and sections
These ranks have different meanings in zoology and botany.

In botany:
 * Use divisio for division (a rank above class and below kingdom)
 * Use sectio for section (a rank above species and below genus)

Note: Certain very large genera, e.g. Rhododendron include subsections

In zoology:
 * Use zoodivisio for division (a rank above family and below order)
 * Use zoosectio for section (a rank above family and below order)

Unranked taxa
For each major taxon from family to phylum, you can add an unranked entry to the taxobox. The entry unranked_X appears above rank X, for example unranked_superfamilia appears above family and superfamily and below order, suborder, infraorder, etc:


 * ordo                 =
 * unranked_superfamilia =
 * familia              =

Use unranked taxa sparingly. The need to include unranked taxa generally indicates that you are following phylogenetic nomenclature. It is usually better to abbreviate the classification to the major ranks and then discuss the classification in more detail in the article.

Viruses
Viruses follow a slightly different system. They are not placed in taxa above the rank of order, and instead are treated in seven groups based on the type of nucleic acid they contain, referred to by the Roman numerals I to VII. These can be included in the taxobox using the virus_group argument. This also changes the link from scientific to virus classification, so it should not appear on boxes for non-viruses, even if it is left blank.


 * virus_group = IV

Bold/italic markup
Italicization must be done manually in all parameters. If the entry for genus or species (with manually added italics) matches the page title, then the name of the taxobox and the title of the page will be italicized. Note that if the name parameter is used the page title will not be automatically italicized. The taxobox's name will be set to exactly what is specified in name – italics must be specified manually in this case.

Genus, species, and subspecies should be italicized whenever used, as is the biological standard. For instance, we talk about the genus Homo, the species Homo sapiens, and the subspecies Homo sapiens sapiens. Higher taxa like families may or may not be italicized in different publications. The prevalent standard for CorporisPublica is not to italicize them, except in the case of viruses and other infectious particles.
 * In botany, it is important to include the rank for taxa below species. The rank is not italicized, e.g. Genus species subsp. subspecies var. variety.
 * Some bacteria that have been characterized but not formally named are given Candidatus names. These should be written in the form Candidatus Genus species, rather than italicized normally.

Bolding is used to indicate the subject of the article. The name, binomial, and trinomial arguments bold automatically. In the placement section – regnum through species – the final taxon should be bolded, as well as any higher groups that only include the final taxon. See green sulfur bacteria for an example.

Subdivisions
Groups above the rank of species (and even species if there are several notable subspecies) should usually include a list of subgroups. Use the subdivision argument for the list, separating elements by &lt;br&gt; tags, and the subdivision_ranks argument to say what rank the subgroups have. For instance, for families in an order:

Family1 Family2 Family3
 * subdivision_ranks = Families
 * subdivision      =

The templates Template:Species list and Template:Taxon list (and their variants) can help to generate these lists.

For lists with more than a few subgroups, the list can be bracketed with and, which will split the list into two columns (see Nettle example at right). In cases where a list would make the taxobox too long, or where the classification is too variable to allow a brief summary, the list should be replaced with a comment like "See text" or the subdivision section should be omitted. As a rule of thumb, when there are more than 100 subgroups the list should be in a separate article.

In cases where the classification is variable, a description like "Typical orders" or "Notable orders" may be used.

In cases where the ranks are uncertain, a description like "Subgroups" or "Taxa" may be preferable. Sometimes it is convenient to represent more than one level of classification in the list. In that case the lower level groups are moved over to the right by prefixing them with &amp;nbsp; characters – usually three for the first level of indentation, and then one to three more for each subsequent level. Major grades may also be represented by bolded headers, as on plant and heterokont. Remember, though, these should mainly be done when the intermediate rank subgroups are not worthy of separate articles; taxoboxes are too small to include too much duplicate information.

Conservation status
Conservation status may optionally be included; you can search the IUCN's database of threatened species to find the conservation status of many organisms. It is included via the status argument, which takes a code or template. It is not appropriate for prehistoric organisms – the  parameter may be a more sensible option.

code classification system (see below)) – required  – optional year of extinction – optional (only use if EX and year of extinction is known).

Use the above syntax, choosing one of the status codes from the code list below. The code may be all upper or lower case, but the cases used in the table are preferred.



The following status codes are available (the third column shows the category that is automatically added to the article):


 * {| class="wikitable"

! Status (as shown in taxobox) || Code || Category assigned
 * - bgcolor="lightsteelblue" align=left
 * Secure || secure ||
 * Domesticated || DOM || Domesticated animals
 * Least Concern (LC) || LC ||
 * Least Concern (LR/lc) || LR/lc ||
 * Near Threatened (NT) || NT ||
 * Near Threatened (LC/nt) || LR/nt ||
 * Conservation Dependent (LR/cd) || LR/cd ||
 * Vulnerable (VU) || VU ||
 * Endangered (EN) || EN || Endangered species
 * Critically Endangered || CR || Critically endangered species
 * Critically Endangered (CR), possibly extinct || PE || Critically endangered species
 * Extinct in the wild (EW) || EW || Species extinct in the wild
 * Extinct || EX ||
 * Data deficient (DD) || DD ||
 * Not evaluated (NE) || NE ||
 * Fossil || fossil ||
 * Prehistoric || pre ||
 * See text || See text ||
 * Lower Risk || LR
 * }
 * Critically Endangered (CR), possibly extinct || PE || Critically endangered species
 * Extinct in the wild (EW) || EW || Species extinct in the wild
 * Extinct || EX ||
 * Data deficient (DD) || DD ||
 * Not evaluated (NE) || NE ||
 * Fossil || fossil ||
 * Prehistoric || pre ||
 * See text || See text ||
 * Lower Risk || LR
 * }
 * Fossil || fossil ||
 * Prehistoric || pre ||
 * See text || See text ||
 * Lower Risk || LR
 * }
 * See text || See text ||
 * Lower Risk || LR
 * }
 * }


 * Notes:

System
The criteria used by the IUCN should also be specified: (case-sensitive) iucn3.1 or iucn2.3 (deprecated for new boxes, although some taxoboxes still exist and are supported for this version)

This parameter is required in order to display the proper conservation status graphic. Failure to use this parameter will result in no graphic appearing.

Other systems are listed at CorporisPublica:Conservation status.

Referencing conservation status
To add a reference for the status, use status_ref

See IUCN2012.2 or IUCN for the arguments you need to supply to that template. And don't forget that  requires a corresponding   in the References section.

Fossil range
The stratigraphic range for groups known as fossils may also be included, using the fossil_range argument. For instance, for a group known from the Cambrian to the Permian:

Cambrian–Permian

You may wish to add a diagrammatic representation of the fossil range (as shown below), which can be created using the Fossil range template, for example: undefined fossil_range or fossil_range

For extant taxa that continue into the present day, the ending period should be set to "Recent" or as "Holocene" for Late Quaternary extinctions such as the Moa, and the current status should be indicated using the status argument.

undefined For groups that only existed during a single period, simply list it without giving a range: e.g.: fossil_range

Images
An image can be included using the argument image. It is highly recommended that an image be provided if one is available. Do not include the "File:" part of the image file name!

If an image is included, alt text should be provided using image_alt. Alt text should not repeat the caption; instead, it should describe the image to someone who can't see it (see CP:ALT).

A caption can be provided using image_caption. A caption need not be provided if it would just repeat the title of the article. It should be provided if it can convey any additional information about the image, such as the sex or life stage of the individual, the location where the picture was taken, the artist (if an engraving or other illustration), or (for higher taxa) the particular species depicted.


 * image        = Sweetbay1082.jpg
 * image_alt    = White flower surrounded by long green leaves
 * image_caption = Magnolia virginiana

By default, the image width is determined by users' default thumb size preferences. In general, it is recommended that these preferences be honoured. In some cases, however, it may be desirable to overrule the default size; this can be achieved by use of the image_width parameter. Note that the Manual of Style recommends that if the default thumb size of a lead image is to be overruled, it should be made at least 300px wide, so that users whose default thumb size is 300px do not end up with a lead image smaller than the other images in the article.


 * image        = Sweetbay1082.jpg
 * image_alt    = White flower surrounded by long green leaves
 * image_caption = Magnolia virginiana
 * image_width  = 320px

A second image may be added by use of the image2, image2_alt, image2_caption and image2_width arguments. Use this sparingly, and only when the article is long enough, and when it makes sense to include the second image here and not later in the article. Camel is a good example (a genus with two well-known representatives). A second image may also be useful for species that display sexual dimorphism so that both a male and female representative could be shown, e.g. Northern Cardinal.

Authorities
Generally, an authority should be given only for the taxa covered by the article. Higher groups which only include the article subject should also list authorities unless those are the same as for the taxa in question. In the case of species (or subspecies) the authority may be given in the binomial (or trinomial) section. Otherwise authorities may be listed in the placement section. For instance, for an order:


 * ordo =
 * ordo_authority =

The following examples illustrate the different conventions for names, dates, and punctuations in the different kingdoms.
 * Animalia
 * Original name valid: Homo sapiens Linnaeus, 1758
 * Organism reclassified: Panthera leo (Linnaeus, 1758) (originally Felis leo)
 * Plantae
 * Original name valid: Magnolia virginiana L.
 * Organism reclassified: Anacamptis pyramidalis (L.) Rich. (originally Orchis pyramidalis)
 * Bacteria
 * Original name valid: Vibrio cholerae R. Koch 1883
 * Organism reclassified: Streptococcus pneumoniae (Klein 1884) Chester 1901 (originally Micrococcus pneumoniae)
 * Old name revived: Salmonella enterica (ex Kauffmann & Edwards 1952) Le Minor & Popoff 1987

Authorities in scientific names are also abbreviated according to different standards for plants and animals. To decipher standard abbreviations, see For more information refer to the article on binomial nomenclature.
 * List of botanists by author abbreviation or consult the International Plant Names Index.
 * List of zoologists by author abbreviation

Diversity
In higher taxa, and taxa where the subdivision option does not indicate number of species, the diversity argument may be used. This needs to be accompanied by diversity_link which links to an appropriate page, usually a List of ... species page. See, for example, Banksia: the subdivision lists only two subgenera, so the diversity option is used to specify the number of species.


 * diversity_link = List of Quercus species
 * diversity = c. 120 species

It is not a good idea to be too precise about the number of species. New species are still being regularly described in many groups. Moreover, changing systematic treatment is liable to alter the species number even in well-known genera. Rounding off the species number and denoting this as approximate value will help decreasing maintenance.

Range maps
A range map may be included at the end of the taxobox. This uses the range_map, range_map_width, range_map_alt, and range_map_caption arguments, in the same manner as an image. See leopard (land animal), Northern Flicker (non-migratory bird), Lesser Spotted Eagle (migratory bird) and orca (water animal) for examples.


 * range_map        = Map.jpg
 * range_map_width  = 240px
 * range_map_alt    = Map showing ...
 * range_map_caption = Range of ...

You can generate maps using an appropriate blank map such as Image:BlankMap-World-noborders.png. Do not make the distribution map too large (a width of 300 to 400 should be sufficient, the purpose of the map being a rough global overview; more detailed maps can always go to the article body) and add the map to Category:Habitat maps, or, preferably, if you upload the map to Commons, to commons:Category:Animal distribution maps.

Synonyms
Where a species has synonyms, the synonyms argument may be used. This should be a list of synonyms separated by &lt;br/&gt; tags.

species1 Authority1 species2 Authority2
 * synonyms =

If the synonyms are too long to fit in a single line, you may also use a bulleted list:


 * synonyms =
 * species1 Authority1
 * species2 Authority2

The first format is preferred for clarity.


 * Please note: style element is not recommended in CorporisPublica:WikiProject Check CorporisPublica, see discussion CorporisPublica talk:WikiProject Check CorporisPublica.

Nomenclator Zoologicus has data for all but the most recently established animal genera. This may be hard to understand for non-specialists, but it is a comprehensive source for the authorship of genus names, both valid ones and junior synonyms. Sometimes one will note that a new name has been established because the older, original name was "preoccupied". This means it has already been established for another taxon of the same rank in the same kingdom before – even if that name is now a synonym too. Taxa that preoccupy a name can be linked in the Synonyms section, such as Stenorhynchus here.

Use synonyms_ref to give references for the synonym list, for example: synonyms_ref

Type species
When the type species of a genus (or larger grouping) is known, the type_species and type_species_authority can be used. For animal entries, the type species should be the original binomial name of the type species, but linked to its current article, and the authority should be plain (no parenthesis). See Mirza for a type species example.


 * type_species          = the original name of the species that was initially used to describe the genus, without regard to its present-day nomenclature
 * type_species_authority =

This follows ICZN Recommendation 67B; be aware that this means the taxon used by the genus' original author – even if it is now invalid, e.g. a junior synonym. Ideally, it should only be used if the genus' original description can be verified first-hand. As per the following example given by the ICZN:

"Astacus marinus Fabricius, 1775, one of the nominal species originally included in the decapod crustacean genus Homarus Weber, 1795, was subsequently designated by Fowler (1912) as the type species of Homarus. The type species is, and should be cited as, Astacus marinus Fabricius, 1775. Astacus marinus Fabricius is currently synonymized with Cancer gammarus Linnaeus, 1758, but the latter is not the type species of Homarus and should not be cited as such. If mention of the type species is required it should be made in some such manner as 'Type species Astacus marinus Fabricius, 1775, a junior synonym of Cancer gammarus Linnaeus, 1758'; or 'Type species Astacus marinus Fabricius, 1775, now regarded as a synonym of Homarus gammarus (Linnaeus, 1758)'."

If you do not completely understand what this all means, please do not use this parameter. Instead, if possible denote the type species in the species listing, for example with a

(type species)

after the species' (currently valid) name.

Italic page titles
If the value of genus, species, or binomial exactly matches the title of the page, and name is unspecified, the taxobox and page title will be italicized automatically. If necessary, it is also possible to force the page title to display in italics using the Italic title template.

If the name parameter is present, then the taxobox will display whatever is in name; the page title will NOT be italicized unless italic title is used.

Complete blank template
This section gives all parameters in the order that they will appear in the taxobox. No taxobox should use all of these. Keep it short!

All parameters
The full list of parameters is illustrated inside the infobox above, in the "Complete blank template".




 * color -      || typical color code
 * name -       || name defaults to
 * status -     || conservation status code
 * status_system - || status-system type
 * status_ref - || status reference
 * regnum -     || (standard) kingdom name
 * phylum -     || (standard) phylum name
 * classis -    || (standard) class name
 * ordo   -     || (standard) order name
 * familia -    || (standard) family name
 * genus  -     || (standard) genus name
 * species -    || (standard) species name
 * fossil_range - || (as shown at top of box)
 * image           - || (as shown in box)
 * image_width     - || (as shown in box)
 * image_alt       - || (as shown in box)
 * image_caption   - || (as shown in box)
 * image2          - || (as shown in box)
 * image2_width    - || (as shown in box)
 * image2_alt      - || (as shown in box)
 * image2_caption  - || (as shown in box)
 * classification_status - || (as shown in box)
 * virus_group     - || (as shown in box)
 * superdomain     - || (as shown in box)
 * superdomain_authority - || (as shown in box)
 * unranked_superdomain - || (as shown in box)
 * unranked_superdomain_ authority - || (as shown in box)
 * domain                - || (as shown in box)
 * domain_authority      - || (as shown in box)
 * unranked_regnum       - || (as shown in box)
 * unranked_regnum_ authority - || (as shown in box)
 * superregnum           - || (as shown in box)
 * superregnum_authority - || (as shown in box)
 * regnum_authority      - || (as shown in box)
 * subregnum             - || (as shown in box)
 * subregnum_authority   - || (as shown in box)
 * unranked_phylum       - || (as shown in box)
 * unranked_phylum_ authority - || (as shown in box)
 * superdivisio          - || (as shown in box)
 * superdivisio_authority - || (as shown in box)
 * superphylum           - || (as shown in box)
 * superphylum_authority - || (as shown in box)
 * divisio               - || (as shown in box)
 * divisio_authority     - || (as shown in box)
 * unranked_divisio      - || (as shown in box)
 * unranked_divisio_ authority - || (as shown in box)
 * phylum_authority      - || (as shown in box)
 * subdivisio            - || (as shown in box)
 * subdivisio_authority  - || (as shown in box)
 * subphylum             - || (as shown in box)
 * subphylum_authority   - || (as shown in box)
 * infraphylum           - || (as shown in box)
 * infraphylum_authority - || (as shown in box)
 * microphylum           - || (as shown in box)
 * microphylum_authority - || (as shown in box)
 * nanophylum            - || (as shown in box)
 * nanophylum_authority  - || (as shown in box)
 * unranked_classis      - || (as shown in box)
 * unranked_classis_ authority - || (as shown in box)
 * superclassis          - || (as shown in box)
 * superclassis_authority - || (as shown in box)
 * classis_authority     - || (as shown in box)
 * unranked_subclassis   - || (as shown in box)
 * unranked_subclassis_ authority   - || (as shown in box)
 * subclassis            - || (as shown in box)
 * subclassis_authority  - || (as shown in box)
 * unranked_infraclassis - || (as shown in box)
 * unranked_infraclassis_ authority - || (as shown in box)
 * infraclassis          - || (as shown in box)
 * infraclassis_authority - || (as shown in box)
 * unranked_ordo         - || (as shown in box)
 * unranked_ordo_authority - || (as shown in box)
 * magnordo              - || (as shown in box)
 * magnordo_authority    - || (as shown in box)
 * superordo             - || (as shown in box)
 * superordo_authority   - || (as shown in box)
 * ordo_authority        - || (as shown in box)
 * subordo               - || (as shown in box)
 * subordo_authority     - || (as shown in box)
 * infraordo             - || (as shown in box)
 * infraordo_authority   - || (as shown in box)
 * parvordo              - || (as shown in box)
 * parvordo_authority    - || (as shown in box)
 * zoodivisio            - || (as shown in box)
 * zoodivisio_authority  - || (as shown in box)
 * zoosectio             - || (as shown in box)
 * zoosectio_authority   - || (as shown in box)
 * zoosubsectio          - || (as shown in box)
 * zoosubsectio_authority - || (as shown in box)
 * unranked_superfamilia - || (as shown in box)
 * unranked_superfamilia_ authority - || (as shown in box)
 * superfamilia          - || (as shown in box)
 * superfamilia_authority - || (as shown in box)
 * familia_authority     - || (as shown in box)
 * subfamilia            - || (as shown in box)
 * subfamilia_authority  - || (as shown in box)
 * unranked_tribus       - || (as shown in box)
 * unranked_tribus_ authority - || (as shown in box)
 * supertribus           - || (as shown in box)
 * supertribus_authority - || (as shown in box)
 * tribus                - || (as shown in box)
 * tribus_authority      - || (as shown in box)
 * subtribus             - || (as shown in box)
 * subtribus_authority   - || (as shown in box)
 * alliance              - || (as shown in box)
 * alliance_authority    - || (as shown in box)
 * unranked_genus        - || (as shown in box)
 * unranked_genus_ authority - || (as shown in box)
 * genus_authority       - || (as shown in box)
 * subgenus              - || (as shown in box)
 * subgenus_authority    - || (as shown in box)
 * sectio                - || (as shown in box)
 * sectio_authority      - || (as shown in box)
 * subsectio             - || (as shown in box)
 * subsectio_authority   - || (as shown in box)
 * series                - || (as shown in box)
 * series_authority      - || (as shown in box)
 * subseries             - || (as shown in box)
 * subseries_authority   - || (as shown in box)
 * species_group         - || (as shown in box)
 * species_group_authority - || (as shown in box)
 * species_subgroup      - || (as shown in box)
 * species_subgroup_ authority - || (as shown in box)
 * species_complex       - || (as shown in box)
 * species_complex_ authority - || (as shown in box)
 * species_authority     - || (as shown in box)
 * subspecies            - || (as shown in box)
 * subspecies_authority  - || (as shown in box)
 * variety               - || (as shown in box)
 * variety_authority     - || (as shown in box)
 * diversity             - || (as shown in box)
 * diversity_link        - || (as shown in box)
 * binomial              - || (as shown in box)
 * binomial_authority    - || (as shown in box)
 * trinomial             - || (as shown in box)
 * trinomial_authority   - || (as shown in box)
 * type_species          - || (as shown in box)
 * type_species_authority - || (as shown in box)
 * subdivision           - || (as shown in box)
 * subdivision_ranks     - || (as shown in box)
 * type_strain           - || (as shown in box)
 * range_map          - || 1st map, bottom of box
 * range_map_width    - || 1st map width as 200px
 * range_map_alt      - || 1st map ALT= text
 * range_map_caption  - || 1st caption, under picture
 * binomial2          - || (as shown in box)
 * binomial2_authority - || (as shown in box)
 * range_map2         - || 2nd map in box
 * range_map2_width   - || 2nd map width as 200px
 * range_map2_alt     - || 2nd map ALT= text
 * range_map2_caption - || 2nd map caption
 * binomial3          - || (as shown in box)
 * binomial3_authority - || (as shown in box)
 * range_map3         - || 3rd map in box
 * range_map3_width   - || 3rd map width as 200px
 * range_map3_alt     - || 3rd map ALT= text
 * range_map3_caption - || 3rd maq caption
 * binomial4          - || (as shown in box)
 * binomial4_authority - || (as shown in box)
 * range_map4         - || 4th map in box
 * range_map4_width   - || 4th map width as 200px
 * range_map4_alt     - || 4th map ALT= text
 * range_map4_caption - || 4th map caption
 * synonyms_ref - || reference for synonyms
 * synonyms    - || (as at bottom of box)
 * }
 * }

Articles lacking taxoboxes
For articles lacking taxoboxes, add Template:Missing-taxobox to the talk page. This may be done by typing   or    at the top of the talk page.