Disclosure: Skyfall Labs is an official Zoho Partner. This is a cross-post of our guide; the original, with sources, is at https://www.skyfallhq.net/resources/zoho-crm-email-templates-merge-fields-blank-fixes
Short answer: a Zoho CRM email template belongs to one module, and its merge fields come from that module. Blank or missing fields usually trace back to a template built for the wrong module, a field typed by hand in the wrong syntax, or data that sits on a related record rather than the one you are emailing. Zoho's help does not publish a blank-field checklist, so the checks below are labelled as advice.
What Zoho says a template is tied to
Per Zoho's Email Templates help page, a template belongs to one module: a lead template only appears when you email leads. It says lead templates should not include contact-related fields, and the reverse. To reuse a template in another module, Zoho says to clone it and update the merge fields (such as name and company details) to match the new module.
Zoho's developer guide for templates says the same from the other direction: each template is tied to one record type, chosen when you create the template.
Source: Zoho Help: Email Templates, Zoho Help: Email and Inventory Templates (developer guide)
Insert fields from the list, do not type them
The developer guide describes inserting a field by choosing a module under Available Merge fields, picking a field from the User, Organization or Specific Module category, using Copy Merge Field value and pasting it into the body. Its example is $contacts_firstname.
Zoho's pages show more than one syntax. The help page's sample uses the form ${Leads.First Name} and ${User.First Name}, while the developer guide's email example uses the $leads_firstname style and its inventory-template example uses ${User.First Name}. The developer guide does not explain why they differ. Advice: copy fields from the picker in your own org rather than typing them from memory or from a blog.
Source: Zoho Help: Email Templates, Zoho Help: Email and Inventory Templates (developer guide)
Blank field checklist (advice)
- Is the template's module the same as the record you are sending to? A template for the wrong module either will not be offered or will pull the wrong fields.
- Does the field have a value on that record? The Zoho pages we read do not describe a fallback value for an empty field in CRM email templates, so assume an empty field renders as empty.
- Is the field on a related record, for example an Account field in a Contact template? A Zoho community thread we read reports exactly this: custom Account fields were available only when the template was set to Accounts, and after switching the template to Contacts those merge fields came out blank. That thread has no Zoho reply, so treat it as a user report, not a documented rule, and test it in your own org.
- Re-insert the field from the picker instead of editing the tag text.
- Send a real test to a record you control that has the fields filled in, rather than relying on a preview alone.
Source: Zoho Community: Email template merge fields (user thread, no Zoho reply)
Limits and where templates are used
Zoho's Email Templates help page lists a maximum template length of 200,000 characters, attachments of up to 10 files with a combined 3MB limit, a template name of up to 75 characters, and a subject of up to 150 characters. Zoho's separate developer guide gives 3MB for an attachment and 64,000 characters for the email body. These pages disagree on body length, so check the limit in your own org before relying on either figure.
The help page lists places a template can be used, including Send Mail, Mass Email, Schedule Mass Email, auto-responders, macros, workflow automation, approval processes, case escalation, web forms, auto-response rules, wizards, Blueprint and CommandCenter. It says a template linked to a workflow, case escalation, macro or similar function cannot be deleted until those links are removed. The page is inconsistent on how many features that is (it says both thirteen and ten), so treat the list as indicative.
Source: Zoho Help: Email Templates, Zoho Help: Email and Inventory Templates (developer guide)
Do not confuse email templates with mail merge
Zoho's Mail Merge Templates are a different feature, built in Zoho Writer to generate letters, forms, labels and agreements in bulk, and optionally email them. Zoho states they are available in the Standard, Professional, Enterprise and Ultimate editions and lists separate limits: up to 10 fields from a subform, up to 3 dynamic tables per template, only the first 100 related-list items fetched, a default of 1000 merges a month per organisation on Professional, Enterprise and Ultimate, a daily cap of 1000 merges, and a maximum of 1000 mail merge emails per CRM organisation per day. Zoho also says templates cannot currently be deployed from sandbox to production.
If a team says merge fields are failing in a letter run, work out first which of the two features they mean, because the limits and troubleshooting differ.
Source: Zoho Help: Mail Merge Templates
When to bring in help
If many templates were copied between modules, or workflows and Blueprints send emails using templates nobody owns, a tidy-up usually means auditing templates, the automations that use them and the fields they depend on together. Skyfall Labs does this within Zoho CRM customization. As an official Zoho Partner we have a commercial interest, so treat our view accordingly.
Frequently asked questions
Why is my Zoho CRM merge field blank?
Zoho's pages do not give a single cause. Common things to check are that the template's module matches the record, the field has a value on that record, and the data is not on a related record. Test with a real record you control.
Can I use one email template for both leads and contacts?
Zoho says templates are module-specific and that lead templates should not contain contact fields. To reuse one in another module, clone it and update the merge fields.
Can an email template use fields from a parent Account?
Zoho's pages we read do not confirm it. A community thread reports Account custom fields coming out blank in a Contacts template, with no Zoho answer. Test it in your own org.
What is the maximum size of a Zoho CRM email template?
Zoho's pages disagree. The Email Templates help page says 200,000 characters, and the developer guide says 64,000 for the body. Verify in your org.
Is mail merge the same as an email template?
No. Zoho's mail merge templates are built in Zoho Writer and have their own monthly and daily limits.
Can I deploy a mail merge template from sandbox to production?
Zoho says it is not currently supported, so templates need recreating in production.
Sources
- Zoho Help: Email Templates
- Zoho Help: Email and Inventory Templates (developer guide)
- Zoho Community: Email template merge fields (user thread, no Zoho reply)
- Zoho Help: Mail Merge Templates
Need hands-on help? Skyfall Labs offers Zoho consulting, implementation and customization. Original guide: https://www.skyfallhq.net/resources/zoho-crm-email-templates-merge-fields-blank-fixes
Top comments (1)
Useful breakdown, especially the reminder that a template belongs to a single module and that a lead template should not mix in contact fields. I also appreciate that you flag the checklist as advice rather than documented behavior, and that the two merge field syntaxes in Zoho's own pages are called out instead of glossed over. Copying fields from the picker rather than typing them seems like the simplest habit to prevent most blank outputs. When a value lives on a related record, such as the account for a contact, have you found a reliable way to surface it in the template?