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

# ImageField

## ImageField

ImageField describes a file field that accepts only images, with data\_type set to file. It derives from [FileField](/docs/developers/sdks/content-management-sdk/dot-net/reference/filefield) and adds dimension limits and image-specific field metadata.

**When to Use This Class:** Use this class for a field such as a banner image or an author photo, where the editor must pick an image.

**Conceptual Role:** Acts as the Field subclass that the SDK creates for a file field that has dimension, or field\_metadata.image set to true.

**Returns:** ImageField. An image field of a schema.

## Properties

ImageField inherits every property of [FileField](/docs/developers/sdks/content-management-sdk/dot-net/reference/filefield) and [Field](/docs/developers/sdks/content-management-sdk/dot-net/reference/field), and adds or replaces the properties below.

Name

Type

Required

Default

Description

Dimensions

Dimension?

No

null

Height and width limits of the image. Serialized as dimension.

FieldMetadata

[FileFieldMetadata](/docs/developers/sdks/content-management-sdk/dot-net/reference/fieldmetadata)?

No

null

Field metadata with the image flag. Replaces Field.FieldMetadata. Serialized as field\_metadata.

**Dimension properties.** Dimension holds the size limits of the image. It is in the Contentstack.Management.Core.Models.Fields namespace.

Name

Type

Required

Default

Description

Height

Dictionary<string, int?>?

No

null

Height limits keyed by min and max. Serialized as height.

Width

Dictionary<string, int?>?

No

null

Width limits keyed by min and max. Serialized as width.

## Class-Level Notes

**Field metadata.**

*   ImageField declares its own FieldMetadata property of type FileFieldMetadata, which hides Field.FieldMetadata. Set and read it through a variable of type ImageField.
*   Through a variable of type Field, FieldMetadata is the base property. On an ImageField read from a response, that base property is null, and the metadata sits in the ImageField property.
*   Set FieldMetadata.AllowOnlyImage to true to send "image": true.

## Method Index

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

## Class-Level Snippet

The snippet below creates a content type with a banner image field that accepts images at least 600 pixels wide.

```
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 ImageField
        {
            DisplayName = "Banner",
            Uid = "banner",
            DataType = "file",
            Extensions = new List<string> { "jpg", "png" },
            Dimensions = new Dimension { Width = new Dictionary<string, int?> { ["min"] = 600 } },
            FieldMetadata = new FileFieldMetadata { AllowOnlyImage = true, Description = "Shown at the top of the post" }
        }
    }
};

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}");
}
```

## ImageField | .NET Management SDK | Contentstack

ImageField in the .NET Management SDK describes a file field that accepts only images, with optional dimension limits, in a content type schema.