---
title: "Statuses & Events"
space: "Frappe Sign Documentation"
url: "http://www.buff0k.co.za/frappe-sign-docs/statuses-and-events"
updated: "2026-11-01"
---

## Request statuses

| Status | Meaning | Can be cancelled? |
| --- | --- | --- |
| **Draft** | Created, fields not yet placed. | Yes |
| **Prepared** | Fields placed (or created from a Frappe document); ready to send. | Yes |
| **Sent** | Links emailed; nobody has opened the document yet. | Yes |
| **Viewed** | At least one signer has opened the document. | Yes |
| **Partially Signed** | At least one Signer has signed, others still to sign. | Yes |
| **Changes Added** | A remark was added after someone had signed; they must re-sign. See **[Remarks & Re-signing](/frappe-sign-docs/remarks-and-re-signing)**. | Yes |
| **Completed** | Every Signer has signed; evidence generated. | No (terminal) |
| **Declined** | A signer declined. | No (terminal) |
| **Expired** | **Expires On** has passed before the request concluded. Open signers are set to **Skipped**. | No (terminal) |
| **Cancelled** | Cancelled by a sender or manager, or via Discard / Cancel. | No (terminal) |
| **Failed** | Completion processing failed. | No (terminal) |

From **Sent** onwards, the request's documents are locked. See **[Document Locking & Evidence Protection](/frappe-sign-docs/document-locking)**.

## Signer statuses

| Status | Meaning |
| --- | --- |
| **Pending** | Not yet emailed (for example, later in a sequential order). |
| **Sent** | Signing link emailed. |
| **Viewed** | Opened the document. |
| **Signed** | Completed their fields. |
| **Needs Re-Sign** | Had signed, but a remark was added afterwards. |
| **Declined** | Declined to sign. |
| **Skipped** | The request was cancelled or expired before this signer signed. |

## Event types

Each **Frappe Sign Event** has one of these types:

```text
Created                     PDF Generated
Prepared                    PDF Stamped
Sent                        Certificate Generated
Viewed                      Certificate Applied
Signed                      Tamper Check Passed
Declined                    Tamper Check Failed
Completed                   Permission Denied
Cancelled                   Signed PDF Attached To Source
Expired                     Source Document Submitted
Remark Added
```

Reminder emails are recorded as **Sent** events with a reminder flag. Events are chained by hash; the chain hash is stored on the request as **Audit Chain Hash** and printed on the audit certificate.