User Guide
Tenancy Agreement Generator
Before You Start
Have these details ready before you begin:
- Landlord’s full name, IC number, and address
- Tenant’s full name, IC / passport number, and address
- Property address of the rented unit
- Rental amount and deposit amounts (rental deposit + utilities deposit)
- Tenancy start date and end date
- Witness names and IC numbers — one witness for the landlord, one for the tenant
Step-by-Step
1Open the Website
Open Google Chrome or Microsoft Edge and go to the website address given to you. You will see a form to fill in.
2Fill in the Form
The form is split into sections. Click NEXT to go forward and BACK to correct a previous section.
| Section | What to fill in |
|---|---|
| Agreement Dates | Execution date, start date, duration, expiry date |
| Landlord Details | Full name, IC number, home address |
| Tenant Details | Full name, IC or passport number, address |
| Property | Full address of the rented property |
| Payment | Monthly rent (RM), rental deposit (RM), utilities deposit (RM), payment due day |
| Witnesses | Name and IC number for each witness |
| Special Conditions | Extra rules, e.g. “No pets”. Leave blank if none. |
| Inventory | Items provided, e.g. air conditioner, fridge. Leave blank if none. |
3Save Your Work — Click SAVE YAML Often!
At the final step of the form, click SAVE YAML. This saves all the information you typed into a small file on your computer (e.g. Block A Unit 5 John Doe.yaml).
Why is this useful?
- If the browser closes accidentally, your work is not lost
- Next time you open the website, load this file and all fields fill in automatically — no need to retype
- For renewals, load last year’s file, change the dates, and your new agreement is ready in minutes
Keep your YAML files in a folder on your Desktop named Agreements so they are easy to find.
4Reload a Previously Saved File
If you saved a YAML file before and want to continue or make changes:
- At the top of the form, find the file upload area (it shows a file picker button)
- Click it and select your saved
.yamlfile - All your details will fill in automatically
- Make any changes, then save again
5Preview the Agreement
Click VIEW PREVIEW at the top right of the page. A preview of the full agreement will appear. Scroll through it carefully and check all names, amounts, and dates before saving.
6Save or Print the Agreement
Inside the preview, you will see three buttons:
| Button | What it does |
|---|---|
| SAVE DOCX | Saves a Word document — can be edited or signed in Microsoft Word |
| DOWNLOAD YAML | Saves your data — reload it next time to skip re-entering everything |
| PRINT / PDF | Opens the print window — choose “Save as PDF” for a PDF file |
The file is named automatically using the property address and tenant name.
7Print on Paper
- Click PRINT / PDF
- Your browser’s print window opens
- Set Paper size to A4 and Margins to Default
- Click Print
The YAML File — Your Save File
Think of the YAML file as a save file — it stores your work so you can return to it anytime.
| Situation | What to do |
|---|---|
| First time filling in | Fill the form, click SAVE YAML at the end |
| Coming back to continue | Load the YAML file at the top of the form |
| Renewing the tenancy | Load last year’s YAML, change the dates and amounts, save new DOCX |
| Accidentally closed the browser | Load the YAML — all your data comes back |
Other Buttons
| Button | Where | What it does |
|---|---|---|
| SAVE YAML | Final step | Saves all your data for future use |
| DOWNLOAD SAMPLE | Final step | Downloads a sample file so you can see the correct format |
| Reset | Final step | Clears all fields and starts fresh (asks you to confirm first) |
Common Questions
Q: I filled in the wrong amount. Can I fix it?
Click BACK until you reach that section, correct it, then click NEXT to continue.
Q: Can I stop halfway and continue later?
Yes — click SAVE YAML before closing the browser. Next time, load that file and everything will be restored.
Q: Word says it cannot open the DOCX file.
Use PRINT / PDF and save as PDF instead. Also make sure your Microsoft Word is up to date.
Q: The PDF has cut-off text or extra blank pages.
In the print dialog, set Margins to Default and Scale to 100%. Untick “Headers and footers” if that option is available.
Q: I accidentally clicked Reset.
This cannot be undone. If you had saved a YAML file earlier, reload it to restore your data. Always save YAML before making big changes.
Q: Where is my saved YAML file?
It is saved to your Downloads folder by default. Move it to a safe folder (e.g. Desktop → Agreements) after saving so it is easy to find later.
Final Checklist
Before saving the document, check the following:
- All names spelled correctly and in full (use CAPITAL LETTERS)
- IC / passport numbers double-checked digit by digit
- Rental amount and deposit amounts are correct
- Tenancy start date and expiry date are correct
- Witness details filled in for both landlord and tenant
- Scrolled through the preview and everything looks right
- YAML file saved (so you can reload next time)
- DOCX or PDF saved and filed safely
Tenancy Agreement Generator — User Guide