---
title: "PdfPushButtonField"
canonical_url: "https://www.nutrient.io/api/python/editors/pdf/formfields/pdf-push-button-field/"
md_url: "https://www.nutrient.io/api/python/editors/pdf/formfields/pdf-push-button-field.md"
last_updated: "2026-06-09T10:32:42.528Z"
description: "Represents a push button form field in a PDF document. Push buttons respond immediately to user input without retaining a permanent value."
---

Represents a push button form field in a PDF document. Push buttons respond immediately to user input without retaining a permanent value. They are typically used to trigger actions like submit, reset, or JavaScript execution.

```python

from nutrient_sdk import PdfPushButtonField

```

**Inherits from:** [`PdfFormField`](/api/python/editors/pdf/formfields/pdf-form-field/)

## Construction

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

## Properties

### background_color

```python

@property
def background_color(self) -> Color

@background_color.setter
def background_color(self, value: Color) -> None

```

The background color of the button.

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

---

### border_color

```python

@property
def border_color(self) -> Color

@border_color.setter
def border_color(self, value: Color) -> None

```

The border color of the button.

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

---

### caption

```python

@property
def caption(self) -> str

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

```

The caption text displayed on the button.

**Type:** `str`

---

### font_color

```python

@property
def font_color(self) -> Color

@font_color.setter
def font_color(self, value: Color) -> None

```

The font color for the button caption text.

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

---

### font_name

```python

@property
def font_name(self) -> str

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

```

The font name for the button caption text.

**Type:** `str`

---

### font_size

```python

@property
def font_size(self) -> float

@font_size.setter
def font_size(self, value: float) -> None

```

The font size for the button caption text.

**Type:** `float`

---

## Inherited members

From [`PdfFormField`](../pdf-form-field/): `child`, `child_count`, `default_value`, `field_type`, `full_name`, `is_read_only`, `is_required`, `is_terminal`, `name`, `parent`, `value`, `widget`, `widget_count`, `remove_child_at`

---

## Related pages

- [All public classes import directly from the top-level package:](/api/python/editors/pdf/formfields.md)
- [Pdf Combo Box Field](/api/python/editors/pdf/formfields/pdf-combo-box-field.md)
- [Pdf Check Box Field](/api/python/editors/pdf/formfields/pdf-check-box-field.md)
- [Pdf Form Field Collection](/api/python/editors/pdf/formfields/pdf-form-field-collection.md)
- [Pdf Form Field](/api/python/editors/pdf/formfields/pdf-form-field.md)
- [Pdf List Box Field](/api/python/editors/pdf/formfields/pdf-list-box-field.md)
- [Pdf Radio Button Field](/api/python/editors/pdf/formfields/pdf-radio-button-field.md)
- [Pdf Signature Field](/api/python/editors/pdf/formfields/pdf-signature-field.md)
- [Pdf Text Field](/api/python/editors/pdf/formfields/pdf-text-field.md)