# Taxonomy Terms
## Basics
The `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 `query` and `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 styling features and properties.
{% endhint %}
Add
1. Click on the ➕ icon to open the Inserter Panel
2. Search for the `taxonomy terms` block
3. Click on the `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 `taxonomy terms` block
3. Click on the `taxonomy terms` block to insert it into your parent block
## 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.
{% embed url="" %}
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
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.
Modify
1. Select a `taxonomy terms` block
2. Open the Block Inspector
3. Navigate to the Primary tab
4. Find the Source Property
5. Select the desired Source
## Current Source
Allows you to inherit the current taxonomies and terms that belong to the specific query.
### Number
Allows you to choose how many taxonomy terms you wish to appear.
## 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.
Modify
1. Select a `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
### 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.
Select
1. Select a `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
### 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.
Modify
1. Select a `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
### Order By
Allows you to choose how to order the custom taxonomies you want to include, ID
Order By
ID
Author
Title
Name
Date
Modified
Parent
Random
Comment count
Relevance
Modify
1. Select a `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
### Direction
Allows you to choose the direction of the custom taxonomies you want to include such as unset, ascending, descending.
Select
1. Select a `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)
### Number
Allows you to specify the number of terms you want to display.
Modify
1. Select a `taxonomy terms` block
2. Open the Block Inspector
3. Navigate to the Primary tab
4. Find the Number property
5. Enter your desired value
### Hide Empty
Allows you to hide empty taxonomies.
Enable/Disable
1. Select a `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
### Exclude Current
The Exclude Current property allows you to exclude the current taxonomy.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.cwicly.com/blocks/taxonomy-terms.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
