.. _TaxonomyConceptsPanel:

Taxonomy Concepts Panel
^^^^^^^^^^^^^^^^^^^^^^^

The Taxonomy Concepts Panel displays a hierarchy with Concept Schemes as their roots and Concepts as tree nodes. The nodes of the hierarchy represent a broader-narrower relationship from top to bottom.

For users with edit permissions, the hierarchy can be rearranged using drag and drop, and, as usual, right-clicking on individual nodes offers further actions, see :ref:`ContextMenu`, :ref:`ExploreMenu` and :ref:`ModifyMenu`.

By default the taxonomy tree nodes are ordered by their display labels.
However, if the Home Asset (`owl:Ontology`) of the taxonomy declares a `teamwork:taxonomyTreeOrderByExpr`
then this expression will be used for ordering.
The value of this property needs to be a SPARQL expression that takes the URI (string) of the current tree
node as pre-bound variable `$value` and produces a value such as an integer that shall be used for comparison
with the other nodes.

**Toolbar Buttons**

* **Create Concept Scheme...** opens a dialog allowing you to create a new top-level concept scheme.

* **Create Concept...** opens a dialog allowing you to create a new concept at the current level of the hierarchy.

* **Quick search** can be used to navigate to concepts based on the first few characters of their label.

* **Switch to full-text search** activates a search mode in which not just the labels but any property can be found.
   This is usually slower than label-based quick search.

**Settings**

* **Show only locally defined concept schemes** filters the hierarchy so that those concept schemes that are included
  from other asset collections are hidden.

* **Also show assets marked as hidden** will, as the title says, also show those concepts that have ``dash:hidden`` set to true.

* **Display IDs instead of labels** toggles between human-friendly labels and machine-friendly qnames.


**See Also**

* :ref:`AssetsHierarchyPanel`
* :ref:`CreateConceptDialog`
* :ref:`Explore_ExportHierarchyToSpreadsheet`
* :ref:`Manage_MainClassForTaxonomies`

**Further Reading on Taxonomies**

* :ref:`working_with_taxonomies_target`

**Further Reading on TopBraid**

* :ref:`introduction`