---
title: "Global Fields"
description: "Global Fields"
url: "https://www.contentstack.com/docs/developers/sdks/content-management-sdk/python/reference/global-fields"
product: "Contentstack"
doc_type: "guide"
audience:
  - developers
  - admins
version: "current"
last_updated: "2026-09-20"
---

# Global Fields

## Global Fields

[Global Fields](/docs/headless-cms/about-global-field) define the reusable content structure across different parts of your website or mobile application. To start using Global Fields, you must first create its instance in the stack.

To use [Nested Global Fields](/docs/headless-cms/about-global-field#nested-global-fields), pass **API Version 3.2** as a parameter when calling global\_fields() function. You can specify the API version in one of the following ways:

*   Passing options directly:  
    
    ```
    import contentstack_management
    client = contentstack_management.Client(authtoken='auth_token')
    response = client.stack('api_key').global_fields(options={"api_version": "3.2"}).create(data)
    ```
    
*   Targeting a specific global field by UID with options:
    
    ```
    import contentstack_management
    client = contentstack_management.Client(authtoken='auth_token')
    response = client.stack('api_key').global_fields("uid", options={"api_version": "3.2"}).fetch()
    ```

## create

The create method creates a new global field in a particular stack.

```
data = {
           "global_field": {
               "title": "Servlet",
               "uid": "servlet",
           "schema": [{
                   "display_name": "Name",
                   "uid": "name",
                   "data_type": "text"
               }
       }
import contentstack_management
client = contentstack_management.Client(authtoken='auth_token')
response = client.stack('api_key').global_fields().create(data)
```

The request body

## delete

The delete method deletes an existing global field from a particular stack.

```
import contentstack_management
client = contentstack_management.Client(authtoken="authtoken")
response = client.stack('api_key').global_fields('global_field_uid').delete()
```

UID of the global field

## export

The export method exports the existing global fields from a particular stack.

```
import contentstack_management
client = contentstack_management.Client(authtoken='auth_token')
response = client.stack('api_key').global_fields().export().json()
```

## fetch

The fetch method retrieves the details of a specific global field from a particular stack.

```
import contentstack_management
client = contentstack_management.Client(authtoken='auth_token')
response = client.stack('api_key').global_fields('global_field_uid').fetch().json()
```

UID of the global field

## find

The find method retrieves the details of all global fields from a particular stack.

```
import contentstack_management
client = contentstack_management.Client(authtoken='auth_token')
response = client.stack("api_key").global_fields('global_field_uid').find().json()
```

## imports

The imports method imports the global field into a particular stack.

```
import contentstack_management
client = contentstack_management.Client(authtoken='auth_token')
response = client.stack('api_key').global_fields('global_field_uid').imports().json()
```

UID of the global field

File path of the global field to be imported

## update

The update method updates the details of an existing global field.

```
data = {
           "global_field": {
               "title": "Servlet",
               "uid": "servlet",
               "schema": [{
                   "display_name": "Name",
                   "uid": "name",
                   "data_type": "text"
               }
       }
import contentstack_management
client = contentstack_management.Client(authtoken="authtoken")
response = client.stack('api_key').global_fields('global_field_uid').update(data)
```

UID of the global field

The Request body

## Global Fields | Python Management SDK | Contentstack

Global Fields are reusable field sets you can reference across multiple content types, in the Contentstack Python Management SDK.