Articles on: People management
This article is also available in:

Managing an employee's documents

Learn how, as an HR admin, you store a colleague's documents, such as a copy of their ID or a diploma. You'll also see when a document is about to expire.


Where do you find it?

Go to People → [name] → Documents.


What do you see?

All the colleague's documents are in one list, the signed contract included. Every document has the same menu with the three dots, where you edit or delete it.


Each document starts with its type, for example Contract or Identity document. Click the type to open the file. The list is ordered by type, so documents of the same kind sit together, and within a type the newest comes first. Under the type you see, if there is one, the contract the document belongs to, the description, the file name, the size and who uploaded it and when.


After the type, one label shows how long the document is valid:

  • Expired (red): the date has passed.
  • Expires in 30 days (amber): the document expires soon. See "Expiry reminders".
  • Valid until [date] (grey): there is still plenty of time.


If a document belongs to a contract, you see the contract's name under the type, for example "Product designer, from 1 Jan 2026". Click it to go to the contract. See "Linking a document to a contract".


How do you upload a document?

  1. Go to People → [name] → Documents.
  2. Click Upload document.
  3. Drag the file into the box or click to browse. You can upload pdf, Word, Excel, csv, txt, rtf, jpg and png files of up to 10 MB.
  4. Choose the Document type: Identity document, Contract, Addendum, Certificate, Absence document, Performance document, Application artifact or Other. Choose Absence document? Then it says underneath: "For example the company doctor's advice or the action plan. Never a diagnosis or a doctor's note."
  5. Does the document belong to a contract, such as the contract itself, an addendum or a non-disclosure agreement? Then choose the right contract under Contract. See "Linking a document to a contract".
  6. Add a Description if you like.
  7. Does the document expire? Fill in Valid until. See "Expiry reminders" below. If you chose a contract, you won't see this field.
  8. Shouldn't the colleague see the document? Turn on Hide from employee. You can't do that for a document that is linked to a contract.
  9. Click Upload.

Every file is scanned for viruses first. While that's happening you'll see "(scanning…)" after the name. After that you can open the document. If you see "(removed by virus scan)", the file wasn't safe and has been deleted. Ask for a clean version.


How do you edit or delete a document?

  1. Click the three dots next to the document.
  2. Choose Edit to change the type, contract, description, expiry date or visibility, then click Save.
  3. Or choose Delete and confirm.


Note: deleting is permanent. The document is gone for the colleague too.


You can't replace the file itself. Upload a new version instead and delete the old one.


Linking a document to a contract

If a document belongs to a contract, you can link it to that contract. You can do this for the type Contract, Addendum and Other. Other is for example a non-disclosure agreement, a job description or a lease car agreement. The other types are about the person themselves, and you can't link those.


You choose the contract when you upload, or later through Edit. The list shows the colleague's contracts, the newest first, with "Not linked to a contract" at the top. If you choose Contract or Addendum, Heartsome suggests the contract that is running now. If the colleague hasn't started yet, it suggests the first contract. If the colleague has left, it suggests the last one. For Other the field stays empty.


This is what a link means:

  • The Manager can open the document, just as they could already see the contract itself. Other documents stay hidden from the Manager. The Manager sees the linked document on the contract under Employment.
  • The colleague can't have it hidden: it belongs to a contract they signed themselves. If Hide from employee is already on, turn it off first.
  • The document has no valid-until date of its own. The dates come from the contract, so you don't get double or conflicting reminders. Did the document already have a date? Then you see a message before you save that it will be removed.
  • If you choose a type in Edit that you can't link, such as Identity document, the document comes off the contract.


A document the colleague uploads themselves is never linked to a contract. Only HR does that.


Files you upload on the contract or in the wizard are also documents of the type Contract, and are linked to that contract straight away. See Recording and changing contracts.


And if you delete a contract, you choose whether its documents go too. See Recording and changing contracts.


Expiry reminders

If you fill in Valid until, Heartsome keeps an eye on the date for you. This applies to documents that aren't linked to a contract. For a linked document, the dates come from the contract.

  • From 60 days before the expiry date, the document gets an orange label, such as "Expires in 30 days". A reminder also appears next to the colleague in the list on People.
  • HR admins and the account owner get a notification.
  • Once the date has passed, the document gets the red Expired label.


You set how many days in advance the reminder appears in Company Settings → Preferences → Reminder windows → Document expiry. See Setting your preferences.


Tip: has the colleague got a new ID? Upload the new document with the new date and delete the old one.



Hiding documents from the colleague

Normally the colleague sees all their own documents under You → Documents. If you turn on Hide from employee, only HR admins and the account owner can see the document. It then gets the Hidden from employee label.


You can't hide a document the colleague uploaded themselves. After all, they already have the file.


You can't hide a document that is linked to a contract either. It belongs to a contract the colleague signed themselves.


When the colleague uploads something

Colleagues can upload documents themselves via You → Documents, such as a copy of their passport. HR admins and the account owner get an email and a notification. From then on you manage it like any other document. The colleague can't edit or delete their own upload afterwards. If you upload a document for a colleague yourself, nobody gets a notification.


Who sees what?

  • HR admin and account owner: see all documents, including hidden ones, and can upload, edit and delete them.
  • The colleague: sees their own documents, except hidden ones, and can upload documents. Documents linked to a contract are always visible to the colleague.
  • Manager: doesn't see the Documents tab, because it can include absence documents. A Manager can open a document that is linked to a team member's contract, on the contract under Employment.

Updated on: 06/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!