Document templates and merge fields
What it's for
Templates are your own letters and agreements — site visit invitations, offer letters, NOCs, sale agreements — written once with merge fields and reused for every buyer. Built-in booking documents use the same editor.
Before you start
Permission to manage document templates (it includes making documents). Built-in booking templates need the sales templates permission.
Start from the library
- On Collections & handover → Documents, press Library (or Start from the library when you have no templates).
- Pick the market — India, Tanzania (English and Swahili side by side) or International; your country's market is shown first.
- Tick the drafts you want and press Add template. Each becomes an ordinary template you can edit. A name already in your list is skipped.
Library drafts are starting points for your lawyer, not legal advice. Details the app does not hold (registration number, signatory, bank, advance paid) are fields asked when generating.
Write a template
- Press New template, or the pencil on a template card.
- Enter the Name, Written for (A lead, A booking, A project or Nobody in particular) and Print on (the default letterhead).
- Write in the editor: headings, bold, italic, underline, alignment, lists, tables (with + row / + column), a line, links and images by web address. The HTML button edits the markup directly.
- Press Insert field to add merge fields, grouped by Company, Project, Lead, Booking and Buyer.
- Press Insert field → Ask when generating… to add your own field, such as
{{input.reference_no}}. It is asked each time a document is made.
- Check the Preview with a sample lead and project, then Create template. Later saves create a new version (Save v2, Save v3 …).
Merge fields
| Group | Examples |
| Company | {{company.name}}, {{company.address}}, {{company.phone}}, {{company.email}}, {{company.website}}, {{company.logo}}, {{today}} |
| Project | {{project.name}}, {{project.address}}, {{project.city}}, {{project.state}} |
| Lead | {{lead.name}}, {{lead.number}}, {{lead.phone}}, {{lead.email}}, {{lead.city}}, {{lead.owner}}, {{lead.stage}}, {{sales_person}} |
| Booking and buyer | {{booking.number}}, {{buyer.name}}, {{units}}, {{price_table}}, {{schedule_table}}, {{statement_table}} |
| Amounts in words | Add _words (English) or _words_sw (Swahili): {{booking.agreement_value_words}}, {{booking.grand_total_words}}, {{receipt.amount_words}} |
| Plot | {{unit.number}}, {{unit.area}}, {{unit.survey_numbers}}, {{unit.facing}}, {{unit.dimensions}}, {{unit.boundaries}}, {{unit.sketch}}, {{property_schedule}} |
Amounts in words use Indian style (lakh, crore) for India and international style otherwise. The plot sketch is drawn from the site map region linked to the unit; a unit not drawn on any map gets no sketch. Buyer ID numbers are masked.
Built-in booking templates
Integrations → Document templates holds the built-in documents (booking form, allotment letter, agreement, demand letter, receipt, possession letter …). Edit them in the same editor and set Print on: Standard header, Company letterhead, Project letterhead or Plain page. Preview uses the latest booking.
Tips and common questions
- Remove hides a template; documents already made stay.
- An unknown field prints empty — copy fields from Insert field rather than typing them.
- Scripts and unsafe styles are removed when you save.
Related: Create a document · Letterheads