---
title: "SignatureAppearance"
canonical_url: "https://www.nutrient.io/api/csharp/signing/signature-appearance/"
md_url: "https://www.nutrient.io/api/csharp/signing/signature-appearance.md"
last_updated: "2026-10-08T08:55:57.713Z"
description: "Defines the visual appearance of a signature in a PDF document. Used for both digital signatures (with certificate) and electronic signatures (visual only)."
---

Defines the visual appearance of a signature in a PDF document. Used for both digital signatures (with certificate) and electronic signatures (visual only).

```csharp

using Nutrient;

```

## Construction

```csharp

public SignatureAppearance()

```

## Properties

### FontName

```csharp

public string? FontName { get; set; }

```

The name of the font to use for text in the signature appearance.

**Type:** `string?`

### FontSize

```csharp

public float FontSize { get; set; }

```

The font size in points for text in the signature appearance.

**Type:** `float`

### ImagePath

```csharp

public string? ImagePath { get; set; }

```

The file path to an image to display in the signature appearance.

**Type:** `string?`

### ShowValidationMark

```csharp

public bool ShowValidationMark { get; set; }

```

When true, displays a validation mark icon in the signature appearance. Only applicable for digital signatures (with certificate).

**Type:** `bool`

### Text

```csharp

public string? Text { get; set; }

```

Custom text to display in the signature appearance. When set, this overrides `UseAutoGeneratedText`.

**Type:** `string?`

### TextColor

```csharp

public Color? TextColor { get; set; }

```

The color of the text in the signature appearance.

**Type:** [`Color?`](/api/csharp/types/color/)

### UseAutoGeneratedText

```csharp

public bool UseAutoGeneratedText { get; set; }

```

When true, automatically generates text from signature metadata (signer name, reason, location, date). This is the default behavior when no custom text or image is provided.

**Type:** `bool`

## Methods

### SetImageStream

```csharp

public void SetImageStream(Stream value)

```

A stream containing an image to display in the signature appearance.

**Parameters**

| Name    | Type     | Description                                    |
| ------- | -------- | ---------------------------------------------- |
| `value` | `Stream` | The value to set for the ImageStream property. |

## Resource management

```csharp

public void Dispose()

```

`SignatureAppearance` implements `IDisposable`. Call `Dispose()` or use a C# `using` declaration to release its native handle right away. If you don't, the handle is released when the object is garbage collected.

---

## Related pages

- [Signing](/api/csharp/signing.md)
- [Digital Signature Options](/api/csharp/signing/digital-signature-options.md)
- [Pkcs11 Options](/api/csharp/signing/pkcs11-options.md)
- [Signature](/api/csharp/signing/signature.md)
- [Timestamp Configuration](/api/csharp/signing/timestamp-configuration.md)