---
title: "Terms"
description: "Terms"
url: "https://www.contentstack.com/docs/developers/sdks/content-management-sdk/python/reference/terms"
product: "Contentstack"
doc_type: "guide"
audience:
  - developers
  - admins
version: "current"
last_updated: "2026-06-08"
---

# Terms

## Terms

Terms serve as the primary classification elements within a taxonomy, allowing you to establish hierarchical structures and incorporate them into entries.

**Note:** The Terms feature is currently released as part of an Early Access program and may not be available to all users. For more information, you can reach out to our [support](<mailto: support@contentstack.com>) team.

## ancestors

The ancestors method retrieves information about a specific term in the taxonomy.

```
import contentstack_management
client = contentstack_management.Client(authtoken='your_authtoken')
result = client.stack('api_key').taxonomy('taxonomy_uid').terms('terms_uid').ancestors().json()
```

UID of the term

## create

The create method lets you create a new term to your taxonomy.

```
data ={
       "term": {
           "uid": "term_1",
           "name": "Term 1"
       },
       "parent_uid": null
       }
import contentstack_management
client = contentstack_management.Client(authtoken='your_authtoken')
result = client.stack('api_key').taxonomy('taxonomy_uid').terms().create(data)
```

The request body to be sent in the call.

## delete

The delete method lets you remove an existing term from your taxonomy.

```
import contentstack_management
client = contentstack_management.Client(authtoken='your_authtoken')
result = result = client.stack('api_key').taxonomy('taxonomy_uid').terms('terms_uid').delete('taxonomy_uid')
```

UID of the term

## descendants

The descendants method retrieves the information about a specific term in your taxonomy.

```
import contentstack_management
client = contentstack_management.Client(authtoken='your_authtoken')
result = client.stack('api_key').taxonomy('taxonomy_uid').terms('terms_uid').descendants().json()
```

UID of the term

## fetch

The fetch method retrieves the information about a specific taxonomy in your stack.

```
import contentstack_management
client = contentstack_management.Client(authtoken='your_authtoken')
result = client.stack('api_key').taxonomy('taxonomy_uid').terms('terms_uid').fetch()
```

UID of the term

## find

The find method retrieves the list of all terms available for a taxonomy.

```
import contentstack_management
client = contentstack_management.Client(authtoken='your_authtoken')
result = client.stack("api_key").taxonomy("taxonomy_uid").terms().find()
```

UID of the term

## move

The move method lets you update the details of a specific term in the taxonomy.

```
data ={
       "term": {
           "uid": "term_1"
       },
       "parent_uid": null
       }
       Under an existing Term:
       {
       "term": {
           "uid": "term_3"
       },
       "parent_uid": "term_1"
       }
import contentstack_management
client = contentstack_management.Client(authtoken='your_authtoken')
result = client.stack('api_key').taxonomy("taxonomy_uid").terms('terms_uid').move(data).json()
```

UID of the term

The request body to be sent in the call.

## search

The search method retrieves the information about specified terms in the taxonomy.

```
import contentstack_management
client = contentstack_management.Client(authtoken='your_authtoken')
result = client.stack('api_key').taxonomy('taxonomy_uid').terms('terms_uid').search("terms_string")
```

The string of UIDs of the terms you want to search for.

## update

The update method updates a resource with the given data and terms UID.

```
data ={
       "term": {
           "name": "Term 1"
       }
       }
import contentstack_management
client = contentstack_management.Client(authtoken='your_authtoken')
result = client.stack('api_key').taxonomy("taxonomy_uid").terms('terms_uid').update(data)
```

UID of the term.

The data to be sent in the request body

## Terms | Python Management SDK | Contentstack

Terms are the primary classification elements of a taxonomy, enabling hierarchical structures in entries, in the Python Management SDK.