---
title: "TaxonomyField"
description: "TaxonomyField"
url: "https://www.contentstack.com/docs/developers/sdks/content-management-sdk/dot-net/reference/taxonomyfield"
product: "Contentstack"
doc_type: "guide"
audience:
  - developers
  - admins
version: "current"
last_updated: "2026-11-22"
---

# TaxonomyField

## TaxonomyField

TaxonomyField describes a taxonomy field in a content type schema, with data\_type set to taxonomy. It lists the taxonomies whose terms an entry can hold, with limits for each one.

**When to Use This Class:** Use this class to let editors tag entries with terms, for example a Topics taxonomy on a blog post.

**Conceptual Role:** Acts as the Field subclass that the SDK creates for a field with data\_type set to taxonomy.

**Returns:** TaxonomyField. A taxonomy field of a schema.

## Properties

TaxonomyField inherits every property of [Field](/docs/developers/sdks/content-management-sdk/dot-net/reference/field) and adds the property below.

Name

Type

Required

Default

Description

Taxonomies

List<TaxonomyFieldBinding>?

No

null

The taxonomies the field uses, with limits. Serialized as taxonomies.

**TaxonomyFieldBinding properties.** TaxonomyFieldBinding links the field to one taxonomy. It is in the Contentstack.Management.Core.Models.Fields namespace.

Name

Type

Required

Default

Description

TaxonomyUid

string?

No

null

UID of the taxonomy. Serialized as taxonomy\_uid.

MaxTerms

int?

No

null

Highest number of terms an entry can hold from this taxonomy. Serialized as max\_terms.

Mandatory

bool

No

false

Requires at least one term from this taxonomy. Serialized as mandatory.

Multiple

bool

No

false

Lets an entry hold more than one term from this taxonomy. Serialized as multiple.

NonLocalizable

bool

No

false

Keeps the terms the same in every locale. Serialized as non\_localizable.

## Class-Level Notes

**Field settings.**

*   The [Create content type with taxonomy](/docs/developers/apis/content-management-api/content-types#create-content-type-with-taxonomy) request of the Content Management API reference shows the taxonomies list, with multiple set to true on the field.
*   Set DataType to taxonomy. The SDK reads a fetched field as TaxonomyField only when its data\_type is taxonomy.
*   The SDK always sends mandatory, multiple, and non\_localizable for each binding, with false when you leave them unset. It leaves out max\_terms when it is null.

## Method Index

TaxonomyField has no methods. Set its properties and add it to ContentModelling.Schema.

## Class-Level Snippet

The snippet below creates a content type with a taxonomy field that accepts up to five terms from a topics taxonomy.

```
using System;
using System.Collections.Generic;
using Contentstack.Management.Core;
using Contentstack.Management.Core.Exceptions;
using Contentstack.Management.Core.Models;
using Contentstack.Management.Core.Models.Fields;

ContentstackClient client = new ContentstackClient("<AUTHTOKEN>");

ContentModelling model = new ContentModelling
{
    Title = "Blog Post",
    Uid = "blog_post",
    Schema = new List<Field>
    {
        new TextboxField { DisplayName = "Title", Uid = "title", DataType = "text", Mandatory = true, Unique = true },
        new TaxonomyField
        {
            DisplayName = "Taxonomies",
            Uid = "taxonomies",
            DataType = "taxonomy",
            Multiple = true,
            Taxonomies = new List<TaxonomyFieldBinding>
            {
                new TaxonomyFieldBinding { TaxonomyUid = "topics", MaxTerms = 5, Mandatory = true, Multiple = true }
            }
        }
    }
};

try
{
    ContentstackResponse response = client.Stack("<API_KEY>").ContentType().Create(model);
    Console.WriteLine(response.OpenJsonObjectResponse()["notice"]);
}
catch (ContentstackErrorException e)
{
    // Thrown when the API rejects the request
    Console.WriteLine($"Request failed: {(int)e.StatusCode} {e.ErrorCode} {e.ErrorMessage}");
}
```

## TaxonomyField | .NET Management SDK | Contentstack

TaxonomyField in the .NET Management SDK describes a taxonomy field that tags entries with terms from one or more taxonomies.