<h2>Introduction to Taxonomy in Content Management</h2>
Welcome to the&nbsp;Taxonomy course in Contentstack! This module will explore how taxonomy is crucial in organizing and managing content within your digital ecosystem.
<h2>Understanding Taxonomy</h2>
Taxonomy helps you categorize pieces of content within your stack to facilitate easy navigation, search, and retrieval of information. You can hierarchically organize your web properties based on your requirements, such as their purpose, target audience, or any other aspects of your business.
This systematic organization gives developers and content managers complete control over their content and helps users find relevant content more efficiently, thus improving the overall user experience.
<h2>Key Features of Taxonomy</h2>
Let's delve into the key features of Taxonomy as they apply to Contentstack:
<ol>
 <li>
 
 Structured Hierarchy:&nbsp;Taxonomies arrange terms in a hierarchical structure, simplifying the categorization and navigation of information.
 
 </li>
 <li>
 
 Categorization and Classification:&nbsp;With taxonomy, you can categorize and classify entries using terms, enabling you to group similar content elements together logically.
 
 </li>
 <li>
 
 Enhanced Search Efficiency:&nbsp;By narrowing down search results to relevant categories, taxonomy enhances search efficiency, allowing users to find the content they need quickly and effortlessly.
 
 </li>
 <li>
 
 Use the APIs to retrieve Entries tagged with Taxonomy terms in the frontend web application.
 
 </li>
</ol>
<h2>Role-based Advantages</h2>
Now, let's explore how Taxonomy benefits different roles within your organization:
<ol>
 <li>
 
 Content Managers:&nbsp;Taxonomy significantly enhances content organization and navigation for content managers. They can categorize and manage content across multiple types, making locating and maintaining specific content easier.
 
 </li>
 <li>
 
 Developers:&nbsp;For developers, Taxonomy offers a structured approach to organizing content facilitating the building and maintenance of website content. Developers can access content based on taxonomy terms using the APIs, allowing more advanced queries with the Content Delivery API.
 
 </li>
 <li>
 
 Content Editors:&nbsp;Taxonomy streamlines workflow for content editors, allowing them to navigate and categorize content intuitively due to the hierarchical structure. This boosts productivity and reduces the time spent searching for specific content.
 
 </li>
</ol>

<h2>Real-World Example: E-commerce Product Taxonomy</h2>
Imagine you are managing an e-commerce platform that sells a wide range of products, from electronics to clothing. Let's apply the principles of taxonomy to organize the product catalog effectively.
1. Structured Hierarchy:
<ul>
 <li>
 Category:&nbsp;Electronics
 <ul>
 <li>
 Subcategories:&nbsp;Smartphones, Laptops, Cameras
 </li>
 </ul>
 
 </li>
 <li>
 Category:&nbsp;Clothing
 <ul>
 <li>
 Subcategories:&nbsp;Men's Clothing, Women's Clothing, Kids' Clothing
 </li>
 </ul>
 
 </li>
 <li>
 Category:&nbsp;Home &amp; Kitchen
 <ul>
 <li>
 Subcategories:&nbsp;Furniture, Appliances, Cookware
 </li>
 </ul>
 
 </li>
</ul>
2. Categorization and Classification:
<ul>
 <li>
 Within the "Smartphones" subcategory, products can be further classified based on brands such as Apple, Samsung, or Google.
 </li>
 <li>
 In the "Men's Clothing" category, items can be categorized by type, including shirts, pants, and accessories.
 </li>
</ul>
3. Enhanced Search Efficiency:
<ul>
 <li>
 A user searching for "Samsung smartphones" can quickly find relevant products within the "Smartphones" category under the "Electronics" section, narrowing down search results.
 </li>
 <li>
 Similarly, searching for "men's shirts" will lead users to the appropriate category within the "Clothing" section.
 </li>
</ul>

Taxonomy in Content Management

Welcome to Taxonomy

Welcome To Taxonomy2 1

If you have not yet configured Postman to work with the Academy training instance, this module will help you download and setup the Contentstack Postman collections.
1.&nbsp;<a href="https://www.contentstack.com/docs/developers/apis/postman-collections">Download the Postman collections</a>
2.&nbsp;<a href="https://www.contentstack.com/docs/developers/apis/postman-collections">Download and install the Environment files for both Content Management and Content Delivery</a>
3. Create a&nbsp;<a href="https://www.contentstack.com/docs/developers/create-tokens/create-a-delivery-token">Delivery Token</a>&nbsp;for Preview and Production
4.&nbsp; Create a&nbsp;<a href="https://www.contentstack.com/docs/developers/create-tokens/generate-a-management-token">Management Token</a>

Configuring Postman with the Contentstack APIs

Using Postman and APIs in Contentstack

Using Postman Aand Apis In Contentstack2

Introduction:&nbsp;In this module, you will learn how to create a taxonomy within Contentstack to effectively organize and structure your website's content.
Understanding Taxonomy:&nbsp;Taxonomies enable efficient content management and retrieval.&nbsp; Centrally managing taxonomies allow organizations to classify their content in a structured manner, enabling them to easily find content and also retrieve content based on the taxonomy and terms applied.&nbsp; In this course, we will look at how we can use taxonomies in Contentstack to structure and organize our content.
Step-by-Step Guide:
<ol>
 <li>
 
 Accessing Taxonomy Settings:
 <ul>
 <li>
 Log in to your Contentstack account.
 </li>
 <li>
 Navigate to the desired stack where you want to create a taxonomy.
 </li>
 <li>
 Click on the "Settings" icon (shortcut: press "S") located on the left navigation panel.
 </li>
 <li>
 Select "Taxonomy" from the settings menu. 
 </li>
 </ul>
 
 </li>
</ol>
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltff4db51667495e31/6649053a4bfb7158ef42c0f1/new-taxonomy.png" alt="new-taxonomy.png" height="auto" />

<ol>
 <li>
 
 Creating a New Taxonomy:
 <ul>
 <li>
 Once in the Taxonomy section, click on the "+ New Taxonomy" button.
 </li>
 <li>
 Enter a Name for your taxonomy. Please note that the Unique ID will be auto-generated and can be edited until the taxonomy is saved. Once saved, the UID cannot be changed.
 </li>
 <li>
 Optionally, you can add a 'Description' of your taxonomy to provide additional context.
 </li>
 <li>
 Click on "Create Taxonomy" to finalize the creation process.
 </li>
 </ul>
 
 </li>
</ol>
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltcb31202438264335/6649059b16e6bf7617590c83/new-dialog.png" alt="new-dialog.png" height="auto" />


Adding Terms to the Taxonomy:
<ul>
 <li>
 Within your newly created taxonomy, you can begin adding terms associated with the taxonomy.
 </li>
 <li>
 For example, if your taxonomy is based on "Superhero," you can create terms such as "Natural Powers," "Mystic Origins," "Scientific Experimentation," "Super Strength," etc.
 </li>
 <li>
 This step allows you to further organize and classify your content based on specific criteria.
 </li>
</ul>

<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt1cafb7dd805ee8bb/664905e8d4d02ee5f02eaba3/terms.png" alt="terms.png" height="auto" />Conclusion:&nbsp;Congratulations! You have successfully learned how to create a taxonomy within Contentstack to organize and structure your website's content. By leveraging taxonomies, you can enhance the usability and navigation of your website, providing users with a seamless browsing experience. Don't forget that&nbsp;you can also create taxonomies programmatically using the&nbsp;<a href="https://www.contentstack.com/docs/developers/apis/content-management-api#taxonomy">Create a Taxonomy API request</a>&nbsp;for added flexibility and automation.

Creating a Taxonomy

Creating a Taxonomy Walkthrough

Create Taxonomy2

After we create a Taxonomy we&nbsp; need to add it to a Content Type before we can start using it.&nbsp; To do that, we will need to edit an existing Content Type and add a new Taxonomy field.&nbsp; Currently, Contentstack allows one Taxonomy field per Content Type, and within this field it is possible to select one or more taxonomies to use for selecting and adding terms to the Entry.&nbsp; Let's take a look at a practical example to understand how we can add our Taxonomy to our Content Type.&nbsp;
1.&nbsp; Navigate to the Content Models window and edit the&nbsp;Character Content Type.
2.&nbsp; Add a new Taxonomy field<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltf9b6eb87c30d5f53/6649073a0a0de6d1a2314d19/taxonomy-content-type.png" alt="taxonomy-content-type.png" height="auto" />3. Select the Superhero Taxonomy&nbsp;

<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt023a2d4f291d753e/664907705c2483f6a6bc3484/superhero-taxonomy.png" alt="superhero-taxonomy.png" height="auto" />4. Save the Content Type

Using the Taxonomy in a Content Type

Using a Taxonomy to a Content Type Walkthrough

Add Taxonomy  To Content Type2

Welcome to the module on editing taxonomies within Contentstack! This module will explore how to easily modify your taxonomies to suit your evolving content organization needs.
Overview
Once you've created a taxonomy, you may need to make adjustments, such as updating its name or description. This module will guide you through the steps to edit a taxonomy efficiently.
Accessing Taxonomies
To begin editing a taxonomy, follow these steps:
<ol>
 <li>
 
 Log in:&nbsp;Access your Contentstack account.
 
 </li>
 <li>
 
 Navigate to Settings:&nbsp;On the left navigation panel, click on the "Settings" icon (shortcut: press "S").
 
 </li>
 <li>
 
 Select Taxonomy:&nbsp;Within the Settings section, choose the "Taxonomy" option.
 
 </li>
</ol>
Editing a Taxonomy
Once you've accessed the Taxonomy section, follow these steps to edit a taxonomy:
<ol>
 <li>
 
 Locate the Taxonomy:&nbsp;Identify the taxonomy you wish to edit from the list displayed.
 
 </li>
 <li>
 
 Access Edit Options:&nbsp;In the Actions column for the respective taxonomy, click on the ellipsis (three dots) icon.
 
 </li>
 <li>
 
 Initiate Editing:&nbsp;Select the "Edit" button from the options provided.
 
 </li>
</ol>
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blted5a3726271be0d9/6649083e42843219ee1989c5/edit-taxonomy.png" alt="edit-taxonomy.png" height="auto" />
Making Changes
In the Edit Taxonomy modal, you can modify the following aspects of the taxonomy:
<ul>
 <li>
 Taxonomy Name:&nbsp;Update the name of the taxonomy to reflect any changes in its purpose or scope.
 </li>
 <li>
 Description:&nbsp;Edit or add a description to provide context or additional information about the taxonomy.
 </li>
</ul>
Please note: The Taxonomy UID cannot be edited once the taxonomy is created.
Saving Changes
Once you've made the necessary edits, click the "Update" button in the Edit Taxonomy modal to save your changes.
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltd92f9c2458b232ef/6649086b6d7055d1ed4d90d9/save-edits.png" alt="save-edits.png" height="auto" />
Conclusion
In this module, you've learned how to effectively edit taxonomies within Contentstack, enabling you to adapt your content organization structure to meet your requirements better. Should you have further questions or require assistance, don't hesitate to contact our support team.

Editing a Taxonomy

Editing a Taxonomy Walkthrough

Editing A Taxonomy2

Here's a step-by-step guide for adding a taxonomy to a content type in your Contentstack account:
1. Log in to Your Contentstack Account: &nbsp; &nbsp;Open your web browser and navigate to the Contentstack login page. Enter your credentials to log in to your account.
2. Access Content Models: &nbsp; &nbsp;Once logged in, you'll be directed to your dashboard. On the left navigation panel, click the "Content Models" icon. Then, either create a new content type or select an existing one where you want to add the taxonomy.
3. Open Content Type Builder: &nbsp; &nbsp;On the "Content Type Builder" page, you'll see the fields of your selected content type. To add a new field, click the "Insert a field" (+ icon) that appears when you hover the cursor.
4. Select Taxonomy Field: &nbsp; &nbsp;From the list of available fields, choose "Taxonomy." <img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt1955decba4e089d9/664909a4dda14b775adff5fb/add-taxonomy.png" alt="add-taxonomy.png" height="auto" />
5. Configure Taxonomy Field Properties: &nbsp; &nbsp;Click on the properties (cog icon) to configure the properties of the taxonomy field.
Note:&nbsp;that the default UID for the taxonomy field is set to "taxonomies" and cannot be updated.

<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltb17fde85126bc9a8/664909d0dda14bd66fdff5ff/configure.png" alt="configure.png" height="auto" />
6. Add Taxonomy: &nbsp; &nbsp;Click the "+ Add Taxonomy" button. A dropdown menu will appear with available taxonomies within the stack. Select the taxonomy you want to add. Note: You can include multiple taxonomies within a single taxonomy field in a content type.

<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt773afb5030bd9b0c/66490a045c2483cdbcbc3488/add-taxonomy2.png" alt="add-taxonomy2.png" height="auto" />
7. Set Maximum Number of Terms: &nbsp; &nbsp;You can limit the maximum number of terms for the taxonomy field by entering a number in the "Maximum Number of Terms" field.
Note&nbsp;that the maximum number of terms allowed per entry is 25.
8. Make Field Mandatory (Optional): &nbsp; &nbsp;If you want to make this taxonomy field mandatory, disable the "Optional Field" toggle.
9. Apply Changes: &nbsp; &nbsp; Once you've configured the taxonomy field according to your requirements, click "Apply" to add the taxonomy to the content type.
11. Start Categorizing Entries: &nbsp; &nbsp; With the taxonomy field added to your content type, you can begin adding entries and categorizing them using your selected taxonomy. 10. Confirmation: &nbsp; &nbsp; Upon successful addition, you'll receive a confirmation message. You can now see the taxonomy field included in your content type.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltb0f09f2ab2af37b2/66490a375fd9afddf270e288/confirm.png" alt="confirm.png" height="auto" />By following these steps, you can seamlessly integrate taxonomy into your content types and efficiently organize your content.

Add Taxonomy to a Content Type

Welcome to the module on Deleting a Taxonomy in Contentstack. In this module, we'll explore the process of removing a taxonomy from your stack.
Introduction
If you have any questions or need assistance, please contact our support team for more information.
Deleting a Taxonomy
Contentstack allows you to delete a taxonomy you've created within your stack. However, it's crucial to understand that unless you're the Owner or Admin of the stack, you cannot delete taxonomies created by other stakeholders.
Step-by-Step Guide
Let's walk through the steps to delete a taxonomy:
<ol>
 <li>
 
 Accessing Taxonomy Settings:
 <ul>
 <li>
 Log in to your Contentstack account and navigate to the stack where you want to delete a taxonomy.
 </li>
 <li>
 Click on the "Settings" icon (shortcut: press "S") located on the left navigation panel.
 </li>
 <li>
 Select "Taxonomy" from the settings options.
 </li>
 </ul>
 
 </li>
 <li>
 
 Selecting and Deleting the Taxonomy:
 <ul>
 <li>
 Identify the taxonomy you wish to delete from the list.
 </li>
 <li>
 Click on the "ellipsis" (three dots) icon in the Actions column next to the taxonomy you want to remove.
 </li>
 <li>
 From the dropdown menu, choose "Delete."
 </li>
 </ul>
 
 </li>
</ol><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt3d7ef070c8554ae8/66490ab952619d0cc1a90a6c/delete.png" alt="delete.png" height="auto" />

<ol>
 <li>
 
 Confirming Deletion:
 <ul>
 <li>
 In the prompted Delete Taxonomy modal, type "DELETE" to confirm your action.
 </li>
 <li>
 Click on the "Delete" button to finalize the deletion process.
 </li>
 </ul>
 
 </li>
</ol><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt8e1438a4941b4fbc/66490ae70b508aca6cdcfc91/delete-confirm.png" alt="delete-confirm.png" height="auto" /> Warning
It's important to understand the consequences of deleting a taxonomy:
<ul>
 <li>
 Permanent deletion of the taxonomy and removal of its association with added content types.
 </li>
 <li>
 Deletion of all terms within the taxonomy and removal from entries.
 </li>
</ul>
Additional Deletion Option
Alternatively, you can also delete a taxonomy by following these steps:
<ul>
 <li>
 Click on the "ellipsis" (three dots) at the top right corner of the taxonomy page.
 </li>
 <li>
 Select "Delete Taxonomy."
 </li>
</ul>
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blta3dc2fcc177f1e2f/66490b55428432fa191989cc/delete-confirm.png" alt="delete-confirm.png" height="auto" /> Conclusion
In conclusion, deleting a taxonomy in Contentstack involves a straightforward process, but it's essential to proceed with caution due to the permanent nature of this action. Understanding the implications of deletion ensures smooth management of your content structure.

Deleting a Taxonomy

With Contentstack, you can easily export a taxonomy in a JSON or CSV file.
To export a taxonomy, log in to your&nbsp;<a href="https://www.contentstack.com/login">Contentstack account</a>&nbsp;and perform the following steps:
<ol>
 <li>
 Go to your&nbsp;<a href="https://www.contentstack.com/docs/developers/set-up-stack/about-stack">stack</a>&nbsp;where you want to export a taxonomy, navigate to the “Settings” icon (press “S”) on the left navigation panel, and select&nbsp;Taxonomy.
 </li>
 <li>
 Select the taxonomy you want to export and click the “ellipsis” (three dots) in the&nbsp;Actions&nbsp;column.
 </li>
 <li>
 Choose the file format for exporting your taxonomy by selecting either&nbsp;Export as JSON&nbsp;or&nbsp;CSV.
 </li>
</ol>
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltdd5f3916194f4ddc/66490bbadda14b0548dff606/export.png" alt="export.png" height="auto" />This will download your taxonomy's JSON or CSV file and save it to your local storage system.

Exporting a Taxonomy

Import a Taxonomy

Import Taxonomy2

Terms serve as the primary classification elements within a taxonomy, allowing you to establish hierarchical structures and incorporate them into entries.
Example -&nbsp;In the Superhero taxonomy, we have two child terms: Origin &amp; Powers and Abilities.&nbsp; Each of these terms has two child terms.&nbsp;
Another Example -&nbsp;In a taxonomy related to "Animals," terms could include "Mammals," "Birds," "Reptiles," etc. Each of these terms represents a distinct category within the taxonomy.
Terms are used to classify and tag entry items. When creating or editing entries, users can select terms from predefined taxonomies to indicate the subject, topic, or category that the entry belongs to. This helps organize and structure entries, making searching, filtering, and managing easier.

<h1>Creating&nbsp;a Term</h1>
To&nbsp;create a term&nbsp;in Contentstack, follow these steps -
<ol>
 <li>
 
 Login to Contentstack: Go to the Contentstack&nbsp;<a href="https://www.contentstack.com/login">login page</a>&nbsp;and enter your credentials to log in to your account.
 
 </li>
 <li>
 
 Access Taxonomies: Navigate to the "Settings" icon once logged in. Under "Settings," you'll find an option for "Taxonomies." Click on it to access the Taxonomies section.
 
 </li>
 <li>
 
 Select&nbsp;a Taxonomy: In the Taxonomies section, you'll see a list of existing taxonomies, if any. Choose the taxonomy where you want to create the term.&nbsp;
 
 </li>
 <li>
 
 Add Term: After selecting the appropriate taxonomy, you'll see a button&nbsp;to "+ New Term."&nbsp;Click on it to create a new term within the selected taxonomy. We are creating a new term under the "Genre" taxonomy here.
 
 </li>
</ol><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt3e1bff326b9b32eb/66490fb052619df401a90a72/new-term.png" alt="new-term.png" height="auto" />
Enter Term Details: In the "Term Details" page, you can enter details for the new term. This typically includes:
- Term Name: Enter the name of the term. For Example -&nbsp;Fiction
- Term UID: The Unique ID is automatically populated, which you can edit.
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt68fc44593ccfb6d2/66490fdab2e852b513451914/term-details.png" alt="term-details.png" height="auto" /> Save Term: Once you've entered the required details for the term, click on the "Save"&nbsp;button to create the term.

<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltf928dc426249a726/66490ffe16e6bf4dff590ca0/save-term.png" alt="save-term.png" height="auto" /> After saving the term, you should see a confirmation message indicating that the term has been successfully created. The following shows the term "Fiction" created under the "Genre"&nbsp;taxonomy.

<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltbf49c5b76f147235/66491058acadaf2407728327/genre.png" alt="genre.png" height="auto" /> Now, if you want to create a sibling term (a term at the same level as the current term) or a child term (a term nested within the current term), you can select any one from the button dropdown as shown below.

<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt419dc0a78431e93d/664910800b508ae4bedcfc97/sibling.png" alt="sibling.png" height="auto" />
 To Create a Sibling Term -
<ol>
 <li>
 Select the&nbsp;option to "Create a Sibling Term" from the dropdown. The selected option is always "Create a Sibling Term"&nbsp;by default. Click on the button&nbsp;"Create a Sibling Term". Here, we are creating a sibling term for the term "Fiction."
 </li>
</ol><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt5bce5b24075215db/664910b13092d0fa8b63f9dc/create-sib.png" alt="create-sib.png" height="auto" />This takes you to the "Term Details" page. Enter the Term Name and Term UID. Here, we are creating&nbsp;a new sibling term,&nbsp;"Non-Fiction." <img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt0f2a0ccb99ee1bbf/66491102efc97a0b144c0a81/non-fiction.png" alt="non-fiction.png" height="auto" />Click on the "Save" button to create the term successfully.&nbsp;The following shows the term&nbsp;"Non-Fiction"&nbsp;being created under the "Genre"&nbsp;taxonomy.

<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltc88b4a3bac5dfb41/6649113f4bfb713cf742c101/non-fiction2.png" width="auto" alt="non-fiction2.png" height="auto" max-width="auto" style="max-width: auto;width: auto;height: auto;" /> You can also create a sibling term by clicking the following icon and the above steps.
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt8ecc56c1036ca4a7/664911705fd9af38df70e290/add-sibling.png" width="698" alt="add-sibling.png" height="auto" max-width="698" style="max-width: 698px;width: 698;height: auto;" />
To Create a Child Term -
<ol>
 <li>
 Select the&nbsp;option to "Create a Child Term" from the dropdown. Click on the button&nbsp;"Create a Child Term". Here, we are creating a child term for the term "Fiction."
 </li>
</ol>
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt5bcd18629f02d153/664911ae342fb50f7a62cc5c/create-child.png" width="698" alt="create-child.png" height="auto" max-width="698" style="max-width: 698px;width: 698;height: auto;" /> This takes you to the "Term Details" page. Enter the Term Name and Term UID and click the "Save" button.&nbsp;Here, we are creating&nbsp;a new child term,&nbsp;"Historical Fiction."&nbsp;The following shows the term&nbsp;" Historical Fiction"&nbsp;being created under the "Genre"&nbsp;taxonomy.
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltae145a26adaf6260/664911ec3092d022d263f9e0/term-details2.png" alt="term-details2.png" height="auto" /> You can also create a child term by clicking the following icon and the above steps.
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltf305bc137e7448fb/664912210b508a12abdcfc9f/add-child-btn.png" width="695" alt="add-child-btn.png" height="auto" max-width="695" style="max-width: 695px;width: 695;height: auto;" /> By following these steps, you can effectively create&nbsp;terms within your Contentstack account, facilitating better organization and classification of your entry items.

Creating Terms

Once you've created terms, you retain the flexibility to adjust terms, empowering you to make changes like updating their names as needed. To&nbsp;edit a&nbsp;term&nbsp;in Contentstack, follow these steps -
<ol>
 <li>
 
 Login to Contentstack: Go to the Contentstack&nbsp;<a href="https://www.contentstack.com/login">login page</a>&nbsp;and enter your credentials to log in to your account.
 
 </li>
 <li>
 
 Access Taxonomies: Navigate to the "Settings" icon once logged in. Under "Settings," you'll find an option for "Taxonomies." Click on it to access the Taxonomies section&nbsp;to access the list of taxonomies in your Contentstack organization.
 
 </li>
 <li>
 
 Choose Taxonomy: From the list of available taxonomies, select the taxonomy containing the term you want to edit. Here, we select the taxonomy&nbsp;"Genre."
 
 </li>
 <li>
 
 Locate Term: Find the term you wish to edit within the selected taxonomy. You may need to expand categories or scroll through the list to locate the specific term and click on the term you need to edit.&nbsp;Here, we will edit the term&nbsp;"Historical Fiction,"&nbsp;under the term&nbsp;"Fiction."
 
 </li>
</ol>
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blte0a2e094e2870f56/664913ed4b531e6623c327f9/edit-term1.png" alt="edit-term1.png" height="auto" />
Edit Term: When you click on the term you want to edit, it opens the "Term Details" page, where you can update the term's name. Here, we will update the name of the term&nbsp;"Historical Fiction."
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltfb2b2d57857bbb19/6649140fd4d02e180b2eac07/edit-term2.png" alt="edit-term2.png" height="auto" />
We will update the name of the term&nbsp;"Historical Fiction"&nbsp;to&nbsp;"Historical/Old Fiction."&nbsp;Click the "Update" button to update the term successfully.

<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltf83833ed72fc6e7c/6649143916e6bf5faf590ca4/edit-term3.png" width="auto" alt="edit-term3.png" height="auto" max-width="auto" style="max-width: auto;width: auto;height: auto;" />
The following shows the updated name for the term&nbsp;"Historical/Old Fiction"&nbsp;being created.

<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltf2fdd3d5eefde954/664914e452619d964ba90a76/hiatorical.png" alt="hiatorical.png" height="auto" />

Editing Terms

Within your stack, you can delete terms from a taxonomy.&nbsp;To&nbsp;delete a term&nbsp;in Contentstack, follow these steps -
<ol>
 <li>
 
 Login to Contentstack: Go to the Contentstack&nbsp;<a href="https://www.contentstack.com/login">login page</a>&nbsp;and enter your credentials to log in to your account.
 
 </li>
 <li>
 
 Access Taxonomies: Navigate to the "Settings" icon once logged in. Under "Settings," you'll find an option for "Taxonomies." Click on it to access the Taxonomies section&nbsp;to access the list of taxonomies in your Contentstack organization.
 
 </li>
 <li>
 
 Choose Taxonomy: From the list of available taxonomies, select the taxonomy containing the term you want to delete. Here, we select the taxonomy&nbsp;"Genre."
 
 </li>
 <li>
 
 Choose Term: Select the term you want to delete from the list of available terms.
 
 </li>
</ol>
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltd6b3065ffc2be7b9/664918433092d04da863f9e5/delete1.png" alt="delete1.png" height="auto" />Delete Term: Click on the ellipsis(three dots) icon on the top right corner of the page, which opens a dropdown list from which click the&nbsp;"Delete Term"&nbsp;option.


<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt53ad850417bf1712/664918684bfb71e49b42c106/delete5.png" width="auto" alt="delete5.png" height="auto" max-width="auto" style="max-width: auto;width: auto;height: auto;" />
 Click on Delete: Clicking on the "Delete Term" option opens a dialog box that asks you to confirm the delete operation. Deleting a parent term will also automatically delete its child term(s). Here, it shows that we will delete the term "Fiction," which contains the child term "Historical/Old Fiction," which will also be&nbsp;deleted. <img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blte16e4232a1532d3c/664918685fd9afd68670e295/delete3.png" width="auto" alt="delete3.png" height="auto" max-width="auto" style="max-width: auto;width: auto;height: auto;" /> After successful deletion, you can see that the "Fiction" term is deleted along with its child term, "Historical/Old Fiction." <img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt1b8e0895d4479e66/66491868a3f9df6ea1c10bba/delet2.png" alt="delet2.png" height="auto" />Following these steps, you can effectively delete terms within your Contentstack account, facilitating better organization and classification of your entry items.

Deleting Terms

Let's&nbsp;consider an example. Our stack has the following taxonomy created.We have terms inside&nbsp;Superhero, as seen in the image below.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blta2c07a004b22deaf/66491a5c52619de069a90a7a/cm1.png" alt="cm1.png" height="auto"/><h2>Get all&nbsp;taxonomies</h2>The Get All Taxonomies request provides detailed information about every taxonomy available within your company's specific stack.Example:&nbsp;Let's retrieve every taxonomy found within our stack.&nbsp;Take into consideration the example given in the Overview section.Below is the curl command for the same.&nbsp;<pre>curl --location 'https://api.contentstack.io/v3/taxonomies' \ --header 'api_key: **************' \ --header 'authorization: *******************' \ --header 'Content-Type: application/json' \ &nbsp;--data ''</pre>View the screenshot below to view the outcome of the postman call.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blte56d3a57b7d08f32/66491abb5c2483ea33bc3490/cm2.png" alt="cm2.png" height="auto"/><h2>Get a single taxonomy</h2>The "Get a single taxonomy" request provides detailed information about a single taxonomy in a given stack.Example: Consider the example given in the Overview section for this.&nbsp;Let's fetch&nbsp;superhero&nbsp;taxonomy.Below is the curl command to fetch&nbsp;superhero&nbsp;taxonomy<pre>curl --location 'https://api.contentstack.io/v3/taxonomies/superhero' \ --header 'api_key: **************' \ --header 'authorization: ****************' \ --header 'Content-Type: application/json' \ --data ''</pre>View the screenshot below to see the outcome of the postman call.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt7a5e0ccf8f22c799/66491af40bbc62953a7fabeb/cm3.png" alt="cm3.png" height="auto"/><h2>Get a single term</h2>The "Get a single term" request provides detailed information about a single term in a given taxonomy.<pre>Example:&nbsp;Consider the following example, which is provided in the Overview section. Obtain a single term from the superhero taxonomy that refers to powers and abilities.</pre><pre>curl --location 'https://api.contentstack.io/v3/taxonomies/superhero/terms/powers_and_abilities' \ --header 'api_key: ***************' \ --header 'authorization: **********************' \ --header 'Content-Type: application/json' \ --data ''</pre>View the screenshot below to see the outcome of the postman call.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt76708a5e5731c2a7/66491b500a0de6460e314d1e/cm4.png" alt="cm4.png" height="auto"/><h2>Create a term</h2>Within your stack, a term in a specific taxonomy is created via the Create a Term request.Since terms are organized hierarchically in a taxonomy, it's important to define the order when creating new terms. For instance, when creating a term at the root level, set the&nbsp;parent_uid&nbsp;as&nbsp;null&nbsp;and specify the level as 1 or above to position it in the list. To create a child term, provide the&nbsp;parent_uid&nbsp;of the parent term where you want to add the new child term and indicate the desired position within the order parameter.<h2>Creating a Term&nbsp; at the Root level</h2>When creating terms at the parent level, the request body should look like this:Example:&nbsp;We would like to&nbsp; make a new Term at the root level.&nbsp; For this, consider the example provided in the previous modules. And add the term "Films" to the "Superhero"&nbsp;taxonomy.&nbsp; Notice that the parent UID is&nbsp;null.Below is the curl command to create a term.&nbsp;<pre>curl --location 'https://api.contentstack.io/v3/taxonomies/superhero/terms' \ --header 'api_key:**************' \ --header 'authorization: ********************' \ --header 'Content-Type: application/json' \ --data '{ &nbsp; "term": { &nbsp; &nbsp; "uid": "films", &nbsp; &nbsp; "name": "Films", &nbsp; &nbsp; "parent_uid": null &nbsp; } }'</pre>View the screenshot below to see the outcome of the postman call.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blte499ee888d5dbecf/66491b9b342fb5f06e62cc64/cm5.png" alt="cm5.png" height="auto"/>The result should be a new Term 'Films' located in the Superhero Taxonomy at the root level. <img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltad086fe9c6e5a3d6/66491bc34ac76eba9f40f88c/cm6.png" alt="cm6.png" height="auto"/><h2>Creating a Term under a parent Term</h2>When creating terms at the child level, the request body should look like this:<pre>curl --location 'https://api.contentstack.io/v3/taxonomies/superhero/terms' \ --header 'api_key:**************' \ --header 'authorization: ********************' \ --header 'Content-Type: application/json' \ --data '{ &nbsp; "term": { &nbsp; &nbsp; "uid": "scientific_experimentation", &nbsp; &nbsp; "name": "Scientific Experimentation", &nbsp; &nbsp; "parent_uid": "origin" &nbsp; } }'</pre><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltb7de7c5f1d2ec22f/66491cd2a3f9dfedffc10bc2/cm7.png" alt="cm7.png" height="auto"/> The result should be a new Term located under the Origin parent term:<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt160628212409b4a6/66491d1cf445aa8b7254c5c4/cm8.png" alt="cm8.png" height="auto"/>

Content Management APIs for Taxonomy

Using the Content Management API to Read the Taxonomy Information

Taxonomy-postman-cma-read2

Creating a New Taxonomy with the Content Management API

Taxonomy-cmapi-postman-create2

Querying using the Taxonomy IN Operator

Taxonomy-content-delivery-api-query2

Querying with the Taxonomy Equals or Below Operator

Taxonomy-equal-and-below2

Use case
Breadcrumbs serve as a helpful navigation tool, enabling users to easily trace their path and understand their position within the hierarchical structure of a website, particularly useful for blogs and product listings.
Solutions
<ul>
 <li>
 The taxonomy terms hierarchy can be used to generate Breadcrumbs for Blog articles or product entries.
 </li>
 <li>
 Define the taxonomy terms in the hierarchy for product entries&nbsp;
 </li>
</ul>
<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt11ace396066f4b52/664924aaf445aaa5cb54c5f8/breadcrumbs.png" alt="breadcrumbs.png" height="auto" />
 
<ul>
 <li>
 Use this taxonomy&nbsp;hierarchy to generate breadcrumbs by using terms associated and its hierarchy and category-specific pages can be generated by making&nbsp;entries based on&nbsp;taxonomy&nbsp;Content delivery Api call&nbsp;in frontend.
 </li>
 <li>
 Also, Dynamic URLs generation for an entry based on the taxonomy hierarchy eg. e-commerce product pages are also can be done to match URL hierarchy with breadcrumbs&nbsp;
 </li>
</ul>

<h1>Advanced Search filter for Content</h1>
Use case:
We need a Blog listing page with sidebar filter for blog categories
Solution:
<ul>
 <li>
 Define a taxonomy structure and add&nbsp;nested terms for each blog category
 </li>
 <li>
 Each blog article will be tagged with the blog category term
 </li>
 <li>
 On the website we will list all blog categories with hierarchy in the sidebar and filter based on the selected combination of categories.&nbsp; The developer can make CDA API calls for blog articles filtered based on taxonomy terms. See the&nbsp;<a href="https://www.contentstack.com/docs/developers/apis/content-delivery-api#taxonomy">API guide</a>&nbsp;for more details.
 </li>
</ul>

<h1> Multi-Brand within Single stack architecture</h1>
<h3>Use case</h3>
Customer has&nbsp;one Stack and would like to accommodate multiple brand website which will have some global&nbsp;content&nbsp;
<ul>
 <li>
 
 Brand 1 Domain (https://www.brand1.com/)
 
 </li>
 <li>
 
 Brand 2&nbsp;Domain (https://www.brand2.com/)
 
 </li>
 <li>
 
 They need brand specific entries access control for brand specific custom roles&nbsp;
 
 </li>
 <li>
 
 CDA APIs to fetch brand specific content entries for each domain.
 
 </li>
</ul>
<h3>Solution Overview:</h3>
<ul>
 <li>
 
 Create a new Taxonomy to define brands
 
 </li>
 <li>
 
 In the Content Model we will add a Taxonomy field Selector for Brand&nbsp;in&nbsp;content types (Page, blog, product etc)
 
 </li>
 <li>
 
 Create an asset folder for each brand to store separate brand specific&nbsp;assets and set up asset permission in brand specific custom roles
 
 </li>
 <li>
 
 Setup custom Roles for each Brand&nbsp;Content editors with proper accessibility as per taxonomy access (upcoming enhancement in roles) and brand based asset folder access
 
 </li>
 <li>
 
 The editor will publish changes to the production&nbsp;Environment with the Taxonomy
 
 </li>
 <li>
 
 On each brand specific frontend site, the developer will make API calls with filtering content based on brand taxonomy to get pages specific to brand taxonomy&nbsp;
 
 </li>
</ul>

Use Cases for Taxonomy

Taxonomy Foundations Quiz

This course is intended to outline the Contentstack features and techniques for using the Taxonomy features with&nbsp;your content, understand the APIs, and how to leverage Taxonomy within your implementation.&nbsp; Completion of this course earns a 'badge' for this topic.!Required for this course:<ol><li>Account in Contentstack with access to a Stack as an Administrator or Developer. Create a training Stack&nbsp;<a href="https://www.contentstack.com/academy/training-instance" target="_blank">here</a>. Training stacks are available for 90 days. Alternatively, you can bootstrap a&nbsp;<a href="https://www.contentstack.com/docs/developers/cli/bootstrap-starter-apps">Starter App via the CLI</a>&nbsp;or from the&nbsp;<a href="https://app.contentstack.com/#!/marketplace/starters">Marketplace</a>.&nbsp;</li><li>Permissions to create a new Taxonomy and edit Content Types in a Stack.&nbsp;</li></ol>

Taxonomy Foundations

Skills Covered