Article Read Time:

9 Min

Search

Subcribe :

Train Your Team:

Our Extensions:

Join For FREE:

How to Set Up Mail Merge and Document Automation in Zoho CRM

Sending a proposal or contract out for signature usually means pulling data from your CRM by hand. You paste it into a Word/Writer document, then repeat the process for every deal that closes. Zoho CRM’s mail merge and document automation tools eliminate that step entirely. You can generate a fully populated document straight from a deal, lead, or any other record, complete with tables of line items.

This guide walks through building a mail merge template from scratch. It covers merging in data from a record and its related modules. You’ll also insert a repeating table for sub-form data and send the finished document out through Zoho Sign. It also covers how to automate the entire workflow into a single button click, the same way Zenatta sets it up for its own clients.

What You’ll Learn

  • Creating a mail merge template: where to build templates in Setup so they are reusable across every record in a module.
  • Merging record and related-module fields: how to pull data from a Deal, its related Account, and its related Contact into one document.
  • Inserting sub-form data: how to turn a line-item table like Chosen Add-Ons into a repeating table inside the document.
  • Running and reviewing the merge: the right way to generate a document from a record and review it before sending.
  • Sending for signature: setting up signer fields and routing the finished document through Zoho Sign.
  • Automating the process: how a custom function can reduce the entire workflow to one click.

Watch: Mail Merge Tutorial for Zoho CRM

Main takeaway: build mail merge templates once, from the correct module. Zoho CRM can then generate fully populated proposals, contracts, and other documents directly from any record. That includes repeating tables of sub-form data, with just a couple of clicks.

What is Mail Merge in Zoho CRM?

Mail merge in Zoho CRM lets you take a record, such as a deal or a lead, and generate a document from it. A couple of button clicks pull that record’s data into a document you populate ahead of time. Instead of manually copying a client’s name, budget, and line items into a Word document, you build a template once. From there, you can run the merge against any record in that module whenever you need a new document.

This is most commonly used from the Deals module to produce a contract or proposal. The finished document typically goes out to a client for signature, but the same mechanics apply to any module.

Preparing Your Data

Before building a template, look at what data actually lives on the record you plan to merge from. A typical Deal record might include top-level fields like proposal dates and discovery notes. It may also include a sub-form, a table of related data such as a list of chosen add-ons with categories and quantities. Knowing which fields sit at the top level versus inside a sub-form matters. Zoho CRM treats each one differently when you build the template.

Creating a Mail Merge Template

If you open the three-dot menu on a record and click Mail Merge before any templates exist, you will see an empty list. Templates are not created from the record itself. They are created in Setup, under Templates, then Mailmerge.

From there, name the template, for example Proposal for Engagement. Choose the module it should run against, such as Deals. Choosing the correct module up front matters, since it determines which fields, including fields from related modules, will be available to merge later. Getting this wrong means the template will not have access to the data you actually need.

Importing an existing document: you do not have to build a template from scratch. You can import a DOCX file and Zoho CRM will recreate most of the look and feel automatically. Expect some formatting cleanup after the import, but it generally holds up well.

Once created, the template opens in an editor comparable to Microsoft Word or Google Docs. Standard text formatting controls run along the top for headings, alignment, and styling. Build out the static parts of the document, headings, labels, and boilerplate text, the same way you would in any word processor.

Merging Fields from Related Modules

The Automate panel on the right side of the template editor lists every field available to merge. You can reopen it any time via Automate, then Configure. This includes fields from the module the template was built against. It also includes fields from any related module, such as the linked Account and Contact on a Deal.

For a field like a contact’s name, you have a choice. You can pull it from the Deal module’s lookup field, or pull it directly from the Contacts module. Pulling directly from the related module is the more reliable approach. A Deal reliably has exactly one related Account and one related Contact, which lets Zoho CRM confidently retrieve the correct name every time.

Beyond names, any top-level field on the Deal can be inserted the same way, such as a budget figure or a required completion date. It will populate automatically whenever the merge runs.

Adding Sub-Form Data as a Repeating Table

Sub-form data, like a table of chosen add-ons, does not show up as a normal field in the Automate panel. It is not a single value; it is a table of rows. Zoho CRM handles this through repeat structures, and there are two kinds of repeating data you can merge in:

  • A sub-form that lives directly inside the record, such as line items on a quote or add-ons attached to a deal.
  • Related records from a completely separate module, such as a list of open activities connected to the record.

To insert a sub-form as a table, select it in the Automate panel and choose a repeat structure. Zoho CRM offers three options:

  • Simple repeat: rows without a header row, rarely used in practice.
  • Table for row repeats: the most common option, producing a table with a header row and one repeating row per sub-form entry, similar to line items on a quote.
  • Table for column repeats: turns each sub-form row into a column instead of a row.

After inserting a table for row repeats, the editor marks the repeating row with a colored border. The row above it holds your column labels. These labels can use whatever terminology makes sense to the client, even if it differs from the internal field name in Zoho CRM. Inside the repeating row itself, map each column to a specific sub-form field, for example category, quantity, and notes.

Mixing in parent record fields: a field from the parent Deal record can also be included inside the repeating row. It simply displays the same value in every row, since there is only one Deal for each set of sub-form entries.

Running the Merge from a Record

With the template built, open the target record, click the three-dot menu, and select Mail Merge. Choose the template you created and click Merge. Zoho CRM pulls the record’s data and retrieves the related sub-form rows. It generates the merged document and opens it in a Writer-style editor in a new tab, fully populated with real values from the record.

Run the merge from the record, not the template. You can trigger a merge from inside the template editor by selecting a record there, but this is more error-prone. Running the merge from the record’s own three-dot menu gives you a cleaner, more reliable interface.

At this stage, you can also make one-off additions to the generated document, such as typing in a purchase order number the client requested. This does not affect the underlying template. Only clicking Update Template pushes a change into every future document created from that template going forward. If an edit needs to happen often, it is usually better to create a separate template rather than repeatedly hand-editing individual documents.

Reviewing and Distributing the Document

Once a document is merged, the icon in the top right, labeled Compose by default, switches to Distribute. From here you have several options for what happens next:

OptionWhat It DoesWhen to Use It
Merge and send as a new document Creates the document and opens it for review before anything is sent. Best default choice, since it lets you catch mistakes, like an incorrect contact, before distribution.
Merge and store Saves the generated document directly into a location such as a WorkDrive folder referenced by a field on the record. Good for automatic archiving without a manual download step.
Send for signature Routes the document straight into Zoho Sign without a manual review step. Best reserved for fully automated workflows, once you trust the data is correct every time.

Reviewing before sending matters in practice. Every so often, a merge goes out to the wrong contact at the account. That is easy to fix: swap the value and re-run the merge before anything goes out. From the review screen, you can also download the document as a DOCX file if a client wants to redline it before signing.

Setting Up Signer Fields for Zoho Sign

To send a document for signature, it needs signer fields built into it first. You can add these at the template level, so every document generated from that template already has them in place.

Inside the template editor, use the signer fields panel to add each signing party, for example the client and Zenatta as the two signers. Drag each signer’s fields, typically a signature field and a date field, directly into the document body wherever they should appear.

Once configured, running Send for Sign on a merged document routes it into Zoho Sign. It is automatically loaded and sent out to the first recipient in the signing order you defined.

Automating the Entire Process

The manual workflow works well, but it involves a fair number of clicks. You mail merge, select a template, merge now, send for sign, enter an email address, then send. For teams that send the same type of document repeatedly, that entire sequence can be wrapped into a custom function behind a single button.

Zenatta uses exactly this approach internally. A Send Proposal button on the Deal record grabs the template ID and the record ID, then retrieves the related contact. It sets that contact as the signer and sends the document out through Zoho Sign automatically. The mail merge and signature mechanics stay the same; the custom function just chains the steps together so a rep only has to click once.

Best Practices

  • Build the template against the right module: this determines which related fields are available later, and it is much harder to fix after the fact.
  • Pull related data from its source module: retrieve contact and account fields directly from the Contacts and Accounts modules rather than through Deal lookup fields.
  • Standardize instead of hand-editing: if a one-off change happens often, create a dedicated template rather than repeatedly editing individual merged documents.
  • Review before you send: use Merge and Send as a New Document so you can confirm the right contact and data before it goes out.
  • Automate repetitive sends: once a workflow is proven manually, wrap it in a custom function to reduce clicks and reduce the chance of sending to the wrong recipient.

Common Mistakes to Avoid

  • Building the template against the wrong module, which limits which related fields are available to merge.
  • Triggering merges from inside the template editor instead of from the record’s own three-dot menu.
  • Clicking Update Template for a one-off edit that was only meant to apply to a single document.
  • Skipping the review step and sending straight to signature before verifying the correct contact and data.
  • Forgetting to add signer fields to the template before attempting to send a document through Zoho Sign.
  • Not accounting for pop-up blockers, which frequently interrupt the multiple new tabs the merge and sign process opens.

Frequently Asked Questions

Templates and Setup

What is mail merge in Zoho CRM?

Mail merge in Zoho CRM is a feature that lets you generate a document, such as a proposal or contract, from a pre-built template. It pulls data from a CRM record and its related modules automatically.

Which module should I create the mail merge template in?

Create the template against the module you will run the merge from, such as Deals. That module determines which fields, including related module fields, are available to merge.

Can I import an existing Word document as a mail merge template?

Yes, you can import a DOCX file into the mailmerge template editor. It will generally preserve most of the formatting, though some formatting errors typically need manual cleanup after the import.

Merging Data and Sub-Forms

Can I merge in data from related modules like the account or contact?

Yes. Any module connected to the parent record through a lookup, such as the related account or contact, is available in the Automate panel. It can be merged directly into the document.

How do I include sub-form data, like line items, in a mail merge document?

Select the sub-form in the Automate panel and choose a repeat structure such as Table for Row Repeats. Then map each sub-form column to a field inside the repeating table row.

Does editing a merged document affect the original template?

No, edits made at merge time only affect that specific generated document. Only clicking Update Template applies the change to every future document created from that template.

Sending and Signing

Why is my mail merge document not opening in a new tab?

This is almost always a browser pop-up blocker. Each step of the merge and sign process opens a new tab, and aggressive pop-up blockers frequently catch these. It can look like the merge failed when it actually just needs pop-ups enabled for the site.

What is the difference between merge and send, merge and store, and send for signature?

Merge and send creates a document you can review first. Merge and store saves it directly into a location such as WorkDrive. Send for signature routes it straight into Zoho Sign without a manual review step.

Do I need signer fields set up before sending a document through Zoho Sign?

Yes, signature and date fields for each signing party need to be added first. Add them to the template, or to the individual document, before routing it through Zoho Sign.

Can the entire mail merge and send-for-signature process be automated?

Yes. A custom function can combine template selection, record data retrieval, signer assignment, and sending through Zoho Sign into a single button click. This removes the need to click through each step manually.

Want Mail Merge and Document Automation Set Up in Your Zoho CRM?

Zenatta builds mail merge templates, sub-form repeating tables, and Zoho Sign automations like this for clients every day. If you want proposals, contracts, or other documents generating themselves straight from your CRM records, we can set it up end to end.

Talk to Zenatta

Billy Bates

Senior Web Developer

Billy is a Wordpress Developer with an eye for design. His knowledge will help our company website and client sites meet their goals. Billy and his young family have just moved to Ashland Oregon, and are looking forward to exploring the area’s amazing beer, wine, and food. He also has a passion for synthesizers and drum machines.

Lucas Sant'Anna

Consultant

With a background in Operations Research and Data Analysis, Lucas is a Brazilian programmer that likes to get stuff done quickly and reliably. In previous jobs, he implemented industrial job scheduling, fleet management and detailed long-haul route optimization – among other data-driven processes – to reach objectives of increased profit and reduced wasted resources. His goal is to make Zoho fully automated and with more meaningful data for spot-on decisions.

.

.