> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.nekst.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Working with Documents on a Transaction: Folders, Signatures, Comments & Archiving

# Working with Documents on a Transaction

A transaction's **Documents** page is where you keep every file for the deal, see what's still unsigned, and leave notes for your team. This article covers everything you do on that page: adding folders, uploading and splitting files, tracking signatures, comments and archiving.

To set up the labels, templates and folders you'll use here, see [Storing & Sharing Documents](https://help.nekst.com/en-us/article/storing-and-sharing-documents-1dx5o92/).

## Add folders to a transaction

Folders group a transaction's documents by phase of the deal, like Listing paperwork and then Pending Seller paperwork.

1. Open the transaction and go to its **Documents** page.
2. Click **Add Folder** and pick one of your folders. Its labels are added as empty slots, ready for uploads.

A few things to know:

* Adding a folder is a **snapshot**. Changing the folder in Settings later doesn't change transactions that already have it.
* You can **rename** a folder on one transaction without affecting anything else. Add a folder whose name is already used and it gets "(2)" added.
* **A label only appears once per transaction.** If a folder includes a label that's already on the transaction, that label is skipped and the existing document stays where it is. **Add Labels** and **Apply Template** work the same way.
* Documents that aren't in a folder show in **Other Documents** at the top of the list.
* To move a document into a different folder, open its row's actions menu and choose **Move to Folder**.

## Upload and split documents

Click **Upload Document** on the Documents page, or inside a folder to file the upload straight into it.

* Add several files at once. Each one gets its own label and its own **Client Portal** switch.
* Pick an existing label for each file, or type a new name to create one on the spot. Leave it blank to add the file with no label.
* For a PDF, open the **Split Document** panel to pick pages one by one or by range. One PDF can become several named documents, each with its own label. Pages you leave out are discarded.

The same Split Document panel shows up when you upload a contract for **New Transaction from Contract** or **Add Workflow**, so you can trim a contract down to the pages that matter.

### Change a document's label

To give a document a different label, use **Change Label** on the document. To take the label off entirely, open the row's actions menu and choose **Remove Label**.

## Track signatures

Each label can say which parties have to sign it, and each party gets a badge showing where they stand.

### The five signing parties

* Broker (**BR**)
* Listing Agent (**LA**)
* Seller (**S**)
* Buyer Agent (**BA**)
* Buyer (**B**)

These are roles, not people. A label requires "the Seller", so the badge shows even if the seller's contact isn't filled in yet.

|| There's one badge per role. If a deal has two buyers or two sellers, they share one badge. Use a comment on the document to note who has signed and who hasn't, for example "Buyer 1 signed, waiting on Buyer 2."

### Set who signs on this transaction

Each label starts with the **Required Signatures** set in your label settings. To change them for this deal only:

* When you add a label, adjust the **Required Signatures** boxes before adding it.
* For a label already on the transaction, open the row's actions menu and choose **Required Signatures**.

Changes here never affect the label in Settings or any other transaction. If you untick a party that already has a status other than Incomplete, Nekst warns you that the status will be lost.

### Update signature status

The **Signatures** column shows one round badge per required party. Click a badge to open its status menu, then pick a colour:

* **Complete** (green): that party has signed.
* **Document Sent** (amber): sent to that party, not back yet.
* **Incomplete** (red): not signed yet. Every badge starts here.
* **Not Needed** (grey): this party doesn't have to sign on this deal after all.

![Signature badges and the status menu](https://storage.crisp.chat/users/helpdesk/website/-/f/4/3/f/f43f5e89d91dd000/document-signature-status_7oqn9n.png =500x316)

The menu shows the party and its current status, like "Broker, Document Sent". Hover over a badge to see the same thing without opening it. You can set statuses before a document is uploaded, which helps when you've sent a blank form out for signature.

To finish a document in one step, choose **Mark Fully Executed** from the row's actions menu. It sets every required party to Complete. You can do this for several labels at once with **Mass Update**, and set it back if you marked one by mistake.

A label gets a **green check** once every required party is Complete or Not Needed. A label with no required parties shows a dash in the Signatures column and counts as complete once a document is uploaded.

## Comments on a document

Keep notes on one specific document, like "Waiting on broker to approve, sent contract on 11/18", so everyone on your team knows where it stands.

* Click the speech bubble next to a label name to open its comments.
* Type your comment and click **Add Comment**. It appears at the top of the list.

![Adding a comment to a document](https://storage.crisp.chat/users/helpdesk/website/-/f/4/3/f/f43f5e89d91dd000/document-comment-add_c253b4.png =500x217)

* Once a document has comments, a blue badge on the speech bubble shows how many, and the latest comment shows in small grey text under the label name.
* You can edit or delete your own comments, but not anyone else's.

![Comment count and latest comment under the label](https://storage.crisp.chat/users/helpdesk/website/-/f/4/3/f/f43f5e89d91dd000/document-comment-view_d6x8sh.png =500x209)

|| Comments are internal. They never show in the Client Portal and are never included in a document you send.

## The document actions menu

Click the **⋯** button at the end of a document's row for:

* **Remove Label**
* **Move to Folder**
* **Required Signatures**
* **Mark Fully Executed**
* **Archive**
* **Delete File**

![The document actions menu](https://storage.crisp.chat/users/helpdesk/website/-/f/4/3/f/f43f5e89d91dd000/document-actions-menu_nbjeu.png =400x373)

## Archive old documents

When a deal falls through, archive the old folder, or a single document, from its menu. Archived items are hidden behind the **Show archived** switch and can be restored at any time.

Archiving frees up the label, so you can add the new Purchase Contract under the same label right away. Email SmartTags, attachments, the Client Portal and documents emailed into the transaction only ever use the active document, never an archived one.

If you restore a folder and one of its labels is already in use by a newer document, that document stays archived and Nekst tells you why. To switch back to the archived one, choose **Make active**. It swaps the two, so nothing is replaced without you choosing it.