Taxonomies
==========

A taxonomy is a group of taxonomy terms. It's a way to build a controlled
vocabulary in Omeka S.

A taxonomy is also an Omeka S resource (like items, item sets and media), which
means:

* it can be linked to items, item sets and media like any other Omeka S
  resource (it can be linked in annotations too);
* it can be described like any other resource (resource template, class,
  properties, annotations);
* it can have a thumbnail.

A taxonomy has a unique (among other taxonomies) identifier, called **Code**.

.. _TaxonomiesTab:

The Taxonomies tab
------------------

Taxonomies are listed in the **Taxonomies** tab (with the tags icon) in the
left-hand navigation of the administrative dashboard.

.. image:: image/taxonomies_browse.png
   :alt: Basic view of admin taxonomies page, showing a handful of taxonomy resources

This page is very similar to `The Items tab
<https://omeka.org/s/docs/user-manual/content/items/#the-items-tab>`_. Please
refer to this documentation for general information.

There are a few differences:

* There is an additional column showing the taxonomy's **Code**.
* Taxonomies can be sorted by **Code**.
* There is an additional icon to **list taxonomy terms** (tag).

Add a taxonomy
--------------

To add a new taxonomy, begin by selecting the the "Add new taxonomy" button.

Values
~~~~~~

The Values tab is where you enter metadata, such as title, description, etc.

.. image:: image/taxonomies_add_values.png
   :alt: Basic view of add taxonomy page, with no content entered

It is identical to `The Items Values tab
<https://omeka.org/s/docs/user-manual/content/items/#values>`_.

Taxonomy
~~~~~~~~

The Taxonomy tab is where you enter the taxonomy's unique identifier (**Code**)

.. image:: image/taxonomies_add_taxonomy.png
   :alt: Basic view of taxonomy tab, with no content entered

Advanced
~~~~~~~~

The Advanced tab is where you can select a thumbnail

.. image:: image/taxonomies_add_advanced.png
   :alt: Basic view of advanced tab, with no content entered