How do I use custom fields in agentOS document templates?
You can merge custom field data into your agentOS document templates — including system letter templates, custom document templates, and email templates — by inserting the custom field's API ID as a tag.
Custom fields can be merged into your agentOS document templates using API ID tags. This works across three template types: System Letter Templates, Custom Document Templates, and Email Templates.
If you haven't set up custom fields yet, start there before using this guide.
Finding the API ID
Every custom field has a unique API ID. You'll need this to build your tag.
- Open any record that has the custom field applied
- Click Customise Record on the right-hand side of the screen
- Select Add Your Custom Fields
- Find your field in the list — the API ID is shown in the API ID column
System Letter Templates
Custom fields can be merged into the following system letter templates:
- Tenancy Agreements
- Landlord Instructions
- Rent Chase*
*Rent Chase is hard-coded. To add custom fields to this document, contact support@agentos.com.
The tag must be entered as a single unbroken string.
|
Tag format |
Example |
|
[[CustomDataSystemAPIID]] |
[[CustomDataSystemF576216788707018896]] |
Custom Document Templates
Custom document templates use a different tag format. The structure changes depending on the record type the field sits on.
|
Tag format |
Use for |
Example |
|
[[Tenancy.CustomDataSystem.APIID]] |
Tenancies |
[[Tenancy.CustomDataSystem.F576179486900504821]] |
|
[[Tenant.CustomDataSystem.APIID]] |
Tenants |
[[Tenant.CustomDataSystem.F576179486900504821]] |
|
[[Instruction.CustomDataSystem.APIID]] |
Sales Instructions |
[[Instruction.CustomDataSystem.F576179486900504821]] |
Replace APIID with the API ID of your specific field.
Email Templates
Email tags follow a slightly different format.
|
Tag format |
Use for |
Example |
|
[Tenancy.APIID] |
Tenancy emails |
[Tenancy.F576427513096596556] |
|
[Tenant.APIID] |
Tenant emails |
[Tenant.F576427513096596556] |
Dropdown fields
If your custom field is a dropdown type, add .Value to the end of your tag:
[[CustomDataSystemF576216788707018896.Value]]
Need help? Contact support@agentos.com