# Taxonomy Terms

<figure><img src="https://lh3.googleusercontent.com/hXLnyOAkf3FujFDh-SvxScEsmbsAAgROGo60nn5n-h3jcEcsWFPgPW16O34dt2yfkkzCzyC4cvCsGjc93SGcjRjLQk5i5DFvjdvscZqsdV7oG1QfAtzyOEd6z__tO2Yvarjh7pnn3w0JUQ7SB6NwEzX0lUSyUv_O1oCdZq5BUvZ8CkCYxCeTVugpQ4z6Gw" alt=""><figcaption></figcaption></figure>

## Basics

The <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `Taxonomy terms` block allows you to showcase your WordPress tags, categories, custom taxonomies and terms.

The `Taxonomy Terms` block allows you total layout and design freedom since it is based on the same principle as the <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `query` and <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `repeater` blocks.

The `Taxonomy Terms` block allows you to specify the origin of the taxonomies you want to display.

{% hint style="danger" %}
If you are working on a template or a template part and have set to source to current, make sure to enable "dynamic preview" bu clicking the icon in the top menu.
{% endhint %}

{% hint style="info" %}
When it comes to layout and design, you have a large palette of choice from columns, to inline block and flex with all the <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> styling features and properties.
{% endhint %}

<figure><img src="https://lh4.googleusercontent.com/GQnQ3PI35smvO2DjlnT8HenA81aUCw1rDpsvKgGDYOl76lgCbP8JQWEA5IRa2CqdfckWq5bY1utSZEBZ3j1N0WdKUbr_AfeKBU3G-bWmTiTse_9CwsI8H83WZZIDXuydEb25TiM8XvNeJd1zuAxPUlbLi7MUtXrdSr6AmliP2hpGA8zMP5ZNCiRdv6FBAA" alt=""><figcaption></figcaption></figure>

<details>

<summary>Add</summary>

1. Click on the ➕ ​​icon to open the Inserter Panel
2. Search for the <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `taxonomy terms` block
3. Click on the <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `taxonomy terms` block to insert it into your page

If you want to add a `repeater` inside a parent block:

1. Open the Quick Insert panel in the parent block
2. Search for the <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `taxonomy terms` block
3. Click on the <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `taxonomy terms` block to insert it into your parent block

</details>

## Taxonomy Terms Placeholder

When you add a taxonomy terms block,  a placeholder will open with "Taxonomy Terms source not set".

This means that you need to set your taxonomy terms in the Source tab of the Primary tab.

Click "+ Select Source" which will take you to the Primary tab and open up the Source dropdown. Choose between Current and Custom.

<figure><img src="https://lh3.googleusercontent.com/3UR5Gz1rvy31wj-ke4rMD7EfRMsMr2bUtY1ZYANQl7YUBljbSJvqxAgB8N86MauxcLrsPAVjQE9neEoIOw4nUbCmsbceI1xDnF1ShEqlLr-EuKdc9mya-ehbL79hMwHjnn4Ck7J6EaU0TKIFHyzCC6a6ItPQqDA2ib581BTCEj9xperEzthhCg7mHvx4IQ" alt=""><figcaption></figcaption></figure>

{% embed url="<https://youtu.be/7EP6pVPLo_I?t=422>" %}
Taxonomy Terms Block usage
{% endembed %}

With the taxonomy terms block selected, you can set up the the styling of your block, such as source, layout, colours.

## Source

<figure><img src="https://lh3.googleusercontent.com/3ny2_MSdd3jPG005efBkcFtysMaXv0hLPqBrDetQ5qnBKTbROfZPW-zmwFkI-jDNnMQCDAJ0k0AHMZ053ugfwU39phqgR56vgptx2mlekL2iqYHscDW4V0HT90oWdER8bd96wuFXnXOZYEpOYJSb24eJMEHGKw2aTWsJvsD5HC9lMqHPiILcfTzbTXrGVA" alt=""><figcaption></figcaption></figure>

You can choose between Current and Custom source properties.

***Current*** Allows you to inherit the current taxonomies and terms that belong to the specific query.

***Custom*** Gives you a choice of Post Types and Taxonomies allowing you complete freedom in showing the taxonomies and terms you want. When a custom source is selected, you are able to sort the taxonomies and terms by order and direction, while also being able to hide empty taxonomies if needed.

![](https://lh6.googleusercontent.com/HIzuXK7DCI_p3qsXWZc3mQHE3LP2wBwAyUgguxNlSuUUZE3Q8b54mTgDQA-tIe-NlfpTrkZ4LXF7GhtQYvWMA-kAvxN39dnumyGQH-mkxrKi690FS8ZSwLRkyj9luOPanp2TOvRQdy0ysLurAzeIVILuDBwzHMemTUEOl6VatpzKpNEKYqR6oiWaudmxdw)

<details>

<summary>Modify</summary>

1. Select a <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `taxonomy terms` block
2. Open the Block Inspector
3. Navigate to the Primary tab
4. Find the Source Property
5. Select the desired Source

</details>

## Current Source

&#x20;Allows you to inherit the current taxonomies and terms that belong to the specific query.

![](https://lh3.googleusercontent.com/HTT2Yw7kmwR52yz_bfA46lVe6URFQIJRqhyK5zBahHc89wVESSOgPotxSkFSfINHX4WtmCVHPyzsUOEYOLZ4dwJbAciUngAfJ7bfBPkvR1esbOy7gF9uLtZquqA81_MvhnFszWbsegMNDiLYb-FalpYre018IxkeJb5dFqGc9mLZBTpkGWjWLhzilICevQ)

### Number

Allows you to choose how many taxonomy terms you wish to appear.

![](https://lh5.googleusercontent.com/XIXnHIdqhcXmKNSntEFCP5Iikh8o_grXAD71mrHiwDzKB1N1-JPZsPBxlkytINz9Qug6jqn4wKxpfotaMMPzkTndmeYgt7eK0swgXtCIuYkSmaydlAwKw1tO_PcOlH2X2EFC0YnQhcb06aIf3FQfAcqaCzfEHlQngmFARq4scWo_z1sOdUzOHuGWA6aPkQ)

## Custom Source

Gives you a choice of Post Types and Taxonomies allowing you complete freedom in showing the taxonomies and terms you want. When a custom source is selected, you are able to sort the taxonomies and terms by order and direction, while also being able to hide empty taxonomies if needed.

### Post Type

Allows you to choose the type of post you want to include inside the `taxonomy` and `terms` block, such as Posts.

![](https://lh6.googleusercontent.com/CdPrhLhwQ55P0ereg5sCl2oj8SLh_1KYX3Q0eatfY7lLMHgJbUUUNbOdu7_GH8gsmIEzhSEj__HDNJaBtx3-5Z_bhHBOQlDwAUaV2ciFW8fv9u20zWt39RxMVeoiPxi8rIpHmJvoCWgW1rI2z1-n2OE9EdWmmqCU3Bhsyr7g4laWwbFjNk3bXPOv1Um8bg)

<details>

<summary>Modify</summary>

1. Select a <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `taxonomy terms` block
2. Open the Block Inspector
3. Navigate to the Primary tab
4. Find the Post Type property
5. Select the desired post types

</details>

### Taxonomies

{% hint style="warning" %}
Only the taxonomies and terms from the chosen post types will appear.
{% endhint %}

Allows you to select the taxonomies you want to include.

![](https://lh4.googleusercontent.com/8irpCr33AdheFTp7-ToaTy9i2oTTi7pmIeeUxG-UyJOaPCJeglGh4DvDGYtGQCEQ68KsFJjtO3UogDvYKwBt0QRfaa4ei-0k3BA5JxJePaMXLjviZ_5v3WA_LNWG5PWu-dVI4HqQIUKOeLToMD2XejOQxhjP3rPox64rKyytc_NW3rRTwmHApAxNaesLQA)

<details>

<summary>Select</summary>

1. Select a <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `taxonomy terms` block
2. Open the Block Inspector
3. Navigate to the Primary tab
4. Find the Taxonomies property
5. Select the desired taxonomy or term

</details>

### Exclude

{% hint style="info" %}
You can exclude a single or multiple taxonomies and terms.
{% endhint %}

Allows you to exclude the taxonomies and terms you don't want to appear. This may include Categories, Tags, Navigation Menus, or specific posts or elements.

![](https://lh6.googleusercontent.com/nLLCjAsGB1emWM15eB-JB4H5VuNCz3S5DV2FmlPBjzrvra-AS6RAsh9ddD812kYJWQfT3eHFBqmNCN4KlzMh_xMPBdQpZxh6CpLqlOyH2OcoftlWcAqtnMWhNU9v0dqpT-6q2DTnLPTD77YWnJR0xFUwf-kceJNk5fKYZ8o35iLO7tKFYj4vag8unb9EbA)

<details>

<summary>Modify</summary>

1. Select a <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `taxonomy terms` block
2. Open the Block Inspector
3. Navigate to the Primary tab
4. Find the Exclude property
5. Select the taxonomies or terms to exclude

</details>

### Order By

Allows you to choose how to order the custom taxonomies you want to include, ID

<details>

<summary>Order By</summary>

ID

Author

Title

Name

Date

Modified

Parent

Random

Comment count

Relevance

</details>

![](https://lh3.googleusercontent.com/fkNs90_DJnLAo_Vmnxm7FwWLgs3keqHWIbu5n3js-SEOk6ZPFQxcPLCtCxnnef7PcaQERmMRoj-RIa3WTS2rbpzkldJFf1Va0_eKUNQdn05aJjbdmIfz4tXhB9nwsQP1lwOxe6aXPtyBJZuKD7HT23PHuGvLAy9xnMfnaNm_ET1e7z1NId5MYzwX6k6xYQ)

<details>

<summary>Modify</summary>

1. Select a <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `taxonomy terms` block
2. Open the Block Inspector
3. Navigate to the Primary tab
4. Find the Taxonomies property
5. Select the desired order by

</details>

### Direction

Allows you to choose the direction of the custom taxonomies you want to include such as unset, ascending, descending.

![](https://lh3.googleusercontent.com/Ta9JBTFqLFxGJs2i3fWoWwSuISz0IXe_ysIFBPsPZu9CSRlePigIuV_GihPhgBrKok8SZ5ZghwtXqr-jDUPJuWTlmq8g6pYP0PtYp2VuxYiz8iJahsFgqoOo120EPQp1Hx2egWgYPjuHOVs2xW9_mFJL0M8S3N-Xt_5fvziD-m5ZggAW1WdKyyOxfkm0LQ)

<details>

<summary>Select</summary>

1. Select a <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `taxonomy terms` block
2. Open the Block Inspector
3. Navigate to the Primary tab
4. Find the Direction property
5. Select the direction to apply to your taxonomies (unset, ascending, descending)

</details>

### Number

Allows you to specify the number of terms you want to display.

![](https://lh4.googleusercontent.com/Y7URsH_CaXZtgCxYLTAFlwmVkaxInSLIpVchXGiO7logeWtojsIk4Q5L_HtvJ-KvK9Q3dSJ-svKYR0NX8whw_ZG7oM7ctp_pXSc3Ghmntj1z7HO-68R_TVfa_Plt2EaGSVzq_JksSGRTSA7G8o4ZcthLh7g7dzOW_Z7mHEdHwwQgIshJ5eym2h-2W-lqRg)

<details>

<summary>Modify</summary>

1. Select a <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `taxonomy terms` block
2. Open the Block Inspector
3. Navigate to the Primary tab
4. Find the Number property
5. Enter your desired value

</details>

### Hide Empty

Allows you to hide empty taxonomies.

![](https://lh5.googleusercontent.com/baXuW3u77hawx_wLJZrVHuBRXPnR6IQJF9_8aCEcYwCGLP7bvjz2B44TvU4j09WR5Yox4MhF9eijPTPKkHaCyjTqd30mxvzXuwze3dynW5evX6j0fwLVXZ1lbxvXSOmfmDVaTDNKA2MJAbOuS8LHUrdgJoua03XjlFm9CtimDf7BuLkmxPK1r3d35P6AtA)

<details>

<summary>Enable/Disable</summary>

1. Select a <img src="https://3250709389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MS33S0eoYwMaMrLb7T_%2Fuploads%2FIFujNW2w7vGBWle7QUxI%2Ffavicon-black%20(1).png?alt=media&#x26;token=7217d37c-7da0-48b5-a775-e14b6e5de2f4" alt="" data-size="line"> `taxonomy terms` block
2. Open the Block Inspector
3. Navigate to the Primary tab
4. Find the Hide Empty property
5. Toggle the Hide Empty property

</details>

### Exclude Current

The Exclude Current property allows you to exclude the current taxonomy.

![](https://lh5.googleusercontent.com/onUXs-RG_02uqoRuEgFipkPh6WIea_Tr_3-Ggyf8Pt62v4SI8pP4kDXScxTKNRuSg4kBkQB-etS6moZcnu8WKRXAWbK6hO45XUERvCF9G6sDwoyUcknAVa6Hk7aEMWL6toLsMLeRfq4-yTTRLIEa2Sx2y5DfwZMg6HVR0H07PL2AShIOpVkOgF85gLLzzw)
