---
title: "PdfTextAnnotation"
canonical_url: "https://www.nutrient.io/api/python/editors/pdf/annotations/pdf-text-annotation/"
md_url: "https://www.nutrient.io/api/python/editors/pdf/annotations/pdf-text-annotation.md"
last_updated: "2026-06-08T15:25:21.250Z"
description: "Represents a text annotation (sticky note) in a PDF document."
---

Represents a text annotation (sticky note) in a PDF document.

```python

from nutrient_sdk import PdfTextAnnotation

```

**Inherits from:** [`PdfMarkupAnnotation`](/api/python/editors/pdf/annotations/pdf-markup-annotation/)

## Construction

`PdfTextAnnotation` cannot be instantiated directly. Obtain instances through static factory methods or via other SDK classes.

## Properties

### icon_name

```python

@property
def icon_name(self) -> str

@icon_name.setter
def icon_name(self, value: str) -> None

```

The icon name for the annotation. Valid values: Comment, Key, Note, Help, NewParagraph, Paragraph, Insert

**Type:** `str`

---

### is_open

```python

@property
def is_open(self) -> bool

@is_open.setter
def is_open(self, value: bool) -> None

```

Whether the annotation popup should initially be open.

**Type:** `bool`

---

### state

```python

@property
def state(self) -> str

```

The state of the annotation (for review workflows).

**Type:** `str`

*Read-only property.*

---

### state_model

```python

@property
def state_model(self) -> str

```

The state model (e.g., "Marked", "Review").

**Type:** `str`

*Read-only property.*

---

## Inherited members

From [`PdfAnnotation`](../pdf-annotation/): `blend_mode`, `border_effect`, `border_effect_intensity`, `border_style`, `border_width`, `color`, `contents`, `index`, `is_hidden`, `is_printable`, `modification_date`, `name`, `rect`, `sub_type`, `title`

From [`PdfMarkupAnnotation`](../pdf-markup-annotation/): `creation_date`, `opacity`, `rich_text_contents`, `subject`

---

## Related pages

- [All public classes import directly from the top-level package:](/api/python/editors/pdf/annotations.md)
- [Pdf Annotation](/api/python/editors/pdf/annotations/pdf-annotation.md)
- [Pdf Circle Annotation](/api/python/editors/pdf/annotations/pdf-circle-annotation.md)
- [Pdf Line Annotation](/api/python/editors/pdf/annotations/pdf-line-annotation.md)
- [Pdf Annotation Collection](/api/python/editors/pdf/annotations/pdf-annotation-collection.md)
- [Pdf Free Text Annotation](/api/python/editors/pdf/annotations/pdf-free-text-annotation.md)
- [Pdf Link Annotation](/api/python/editors/pdf/annotations/pdf-link-annotation.md)
- [Pdf Highlight Annotation](/api/python/editors/pdf/annotations/pdf-highlight-annotation.md)
- [Pdf Markup Annotation](/api/python/editors/pdf/annotations/pdf-markup-annotation.md)
- [Pdf Redact Annotation](/api/python/editors/pdf/annotations/pdf-redact-annotation.md)
- [Pdf Shape Annotation](/api/python/editors/pdf/annotations/pdf-shape-annotation.md)
- [Pdf Square Annotation](/api/python/editors/pdf/annotations/pdf-square-annotation.md)
- [Pdf Squiggly Annotation](/api/python/editors/pdf/annotations/pdf-squiggly-annotation.md)
- [Pdf Stamp Annotation](/api/python/editors/pdf/annotations/pdf-stamp-annotation.md)
- [Pdf Strike Out Annotation](/api/python/editors/pdf/annotations/pdf-strike-out-annotation.md)
- [Pdf Underline Annotation](/api/python/editors/pdf/annotations/pdf-underline-annotation.md)
- [Pdf Widget Annotation](/api/python/editors/pdf/annotations/pdf-widget-annotation.md)