Document merge to generate personalized document.

Getting started with document merge in Zoho Writer

Overview

Template-based document generation in Zoho Writer allows you to automate the creation of personalized documents by connecting pre-designed templates with structured data sources such as spreadsheets, forms, CRMs, or APIs. Each template contains merge fields (placeholders) that dynamically populate with real data during generation. This enables users to produce contracts, invoices, proposals, letters, and more, at scale, without manual editing. Zoho Writer supports conditional logic, tables, and image merging, making it ideal for automating business documents efficiently and accurately.

Steps to Merge Documents in Zoho Writer   

Step 1: Create or open a merge template

Design or open the merge template in Zoho Writer that will serve as your template. To create a merge template,

Click the File menu -> New Automation Template -> Merge template
      Create from Scratch :  to create a blank template
      Create over PDF       :  to Mail Merge PDF Documents

Note : You can also convert your documents into a Merge Template using Automate tab -> Merge template.

Step 2: Select your data source

Access the "Automate" tab to choose your data source. Zoho Writer support data from Zoho Sheet, Zoho Forms, Zoho Creator, Zoho CRM, Zoho Books, Bigin, Zoho Projects. Select a data source from the options as shown in the image:

    

Step 3: Setup template with fields 

To render merge fields as specific elements (like checkboxes, images, links, etc.) in Zoho Writer, you need to set the merge field types correctly while inserting them.

1. Insert Merge Fields

Add merge fields to personalize a document with information from the data source. Set the appropriate merge field type to determine how data is displayed or behaves in the final merged document. 

2. Insert Advanced Merge Fields   

Advanced Merge Fields enhance your merge templates by allowing you to add logic, conditions, and calculations to your documents. These fields go beyond simple placeholder replacements and enable dynamic content generation based on the structure and values of your data source.

3.  Insert AutoFields

 AutoFields are dynamic fields that automatically populate standard information in your document—like dates, page numbers, document metadata, or user details—without needing to manually enter them.

 4. Insert Main Form Fields 

A main form represents the primary record or entity in your data source. Each main form field corresponds to a unique entry (like a single person, invoice, or application). These fields pull in one-to-one data—meaning one record equals one document.
           Example:  If you're sending invoices, each customer name and address would come from main form fields.

5. Insert Subform Fields As Repeat Blocks 

A subform is a set of fields linked to the main form, designed to handle repeating data—that is, multiple entries related to a single main record. Subforms help create one-to-many relationships in your document. Subforms automatically belong to a main form and will repeat for each associated entry during the merge.
Repeat blocks usually a table row, paragraph, or group of fields — to repeat once per item in a list or subform from your data source.

Step 4: Configure when to run merge 

  1. Manually / On Trigger
    Choose this option to run the merge manually by clicking 'Run Merge', or set up triggers in connected apps to automate the merge using a button, Deluge script, or API when specific app events occur.
    1. How to run merge from Zoho CRM
    2. How to run merge from Zoho Creator
    3. How to run merge from Zoho Projects
    4. How to run merge from Zoho Sprints
    5. How to run merge from Zoho Books
    6. How to run merge with Zoho Flow
  2. On Form Submission
    Automatically run the merge whenever someone submits a connected Zoho Form. You can email the generated document, let users download it, or send the data to Zoho Sheet. 
    Learn more.

  3. Scheduled / Date & Time  
    Set a specific time and date for the merge to run automatically, ideal for schedule tasks like sending reports or letters on specific date or time

  4.  External Trigger  (via webhook)
    Trigger merges programmatically via registered webhook

Step 5: Configure merge output options

Select one of the available output options to proceed with the merge. Each option lets you control how the generated document is delivered, stored, or shared based on your workflow requirements.

1. Set up Simple Merge

Simple document automation is a set of prebuilt automation flows that allow you to generate documents using one template and then, store, email, send for signing, or send as fillable form. Simple merge Output options include:

2. Set up Advanced Merge

Advanced Automation Flow Builder lets you to design dynamic document workflows for complex requirements like generating (merge) documents, combining them into one, and then emailing or storing them, conditionally picking templates from a set of templates for document generation, dynamically routing the generated documents through different modes of distribution like emailing, sending for signature collection, performing post document generation actions like:
    1. Combining multiple generated documents into a single file before being sent for signing.
    2. Creating dynamic folders and storing the generated documents in them, and much more.

Step 6: Preview the merge  

  1. Click Automate > Preview Merge to see how the document looks with actual data.
  2. Navigate through records to check formatting and correctness.

Step 7: Run the merge  

  1. Click Automate > Run Merge
  2. How to Track Merge Progress and Handle Errors in Zoho Writer

Troubleshooting

Problem : In CRM Email merge template to send to a contact that includes the details of a Deal and I'd like to include the Product that's been added to the deal, but Product doesn't seem to be an option in the list of Merge Fields.
Cause : It is not possible to fetch the fields from products within contacts and you must have a custom lookup field added.
Solution:  Creating a subform in the Deals module and list down the Products. You can also write a custom function to pull the details of the Product to fields within the Contacts/Deals module to include it in the email template.

Related Articles On

Merge Limits & Credits

 Merge Field  Setup

  1. How to shorten field names
  2. How to add dynamic links in merge document 
  3. How to format date fields or or subtract days/months/year from date field  in merge
  4. How to add dynamic barcode or QR code in Merge
  5. How to add dynamic text watermarks in Merge
  6. How to aggregate data in Merge  (GroupBy & Aggregate Functions)
  7. How to merge documents with Uploaded Files on Form Submission
  8. How use Work Drive Image URLs in Merge Fields

 Merge Sub-form Data 

 Merge Output 

  1. How to sequentially number generated documents from merge
  2. How to protect PDF generated from Merge
  3. How to setup merge for Zoho Form Submissions
  4. How to Merge Labels with CRM Data
  5. How to use CRM Templates in Email body and Merge Document as Attachment

Post Merge Actions

  1. How to run Custom Workflows Post Merge 
  2. How to Setup CRM Actions Post Merge

Merge Customization

Merge Status & Control

      Create. Review. Publish.

      Write, edit, collaborate on, and publish documents to different content management platforms.

      Get Started Now


        Access your files securely from anywhere

          Zoho CRM Training Programs

          Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

          Zoho CRM Training
            Redefine the way you work
            with Zoho Workplace

              Zoho DataPrep Personalized Demo

              If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

              Zoho CRM Training

                Create, share, and deliver

                beautiful slides from anywhere.

                Get Started Now


                  Zoho Sign now offers specialized one-on-one training for both administrators and developers.

                  BOOK A SESSION







                              Quick LinksWorkflow AutomationData Collection
                              Web FormsRetailOnline Data Collection Tool
                              Embeddable FormsBankingBegin Data Collection
                              Interactive FormsWorkplaceData Collection App
                              CRM FormsCustomer ServiceForms for Solopreneurs
                              Digital FormsMarketingForms for Small Business
                              HTML FormsEducationForms for Enterprise
                              Contact FormsE-commerceForms for any business
                              Lead Generation FormsHealthcareForms for Startups
                              Wordpress FormsCustomer onboardingForms for Small Business
                              No Code FormsConstructionRSVP tool for holidays
                              Free FormsTravelFeatures for Order Forms
                              Prefill FormsNon-Profit
                              Forms for Government
                              Intake FormsLegal
                              Mobile App
                              Form DesignerHR
                              Mobile Forms
                              Card FormsFoodOffline Forms
                              Assign FormsPhotographyMobile Forms Features
                              Translate FormsReal EstateKiosk in Mobile Forms
                              Electronic FormsInsurance
                              Drag & drop form builder

                              Notification Emails for FormsAlternativesSecurity & Compliance
                              Holiday FormsGoogle Forms alternative GDPR
                              Form to PDFJotform alternativeHIPAA Forms
                              Email FormsWufoo alternativeEncrypted Forms
                              Accessible FormsTypeform alternativeSecure Forms

                              WCAG

                                          Create. Review. Publish.

                                          Write, edit, collaborate on, and publish documents to different content management platforms.

                                          Get Started Now






                                                            You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                                                Manage your brands on social media

                                                                  Use cases

                                                                  Make the most of Zoho Desk with the use cases.

                                                                   
                                                                    

                                                                  eBooks

                                                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho Desk.

                                                                   
                                                                    

                                                                  Videos

                                                                  Watch comprehensive videos on features and other important topics that will help you master Zoho Desk.

                                                                   
                                                                    

                                                                  Webinar

                                                                  Sign up for our webinars and learn the Zoho Desk basics, from customization to automation and more

                                                                   
                                                                    
                                                                  • Desk Community Learning Series


                                                                  • Meetups


                                                                  • Ask the Experts


                                                                  • Kbase


                                                                  • Resources


                                                                  • Glossary


                                                                  • Desk Marketplace


                                                                  • MVP Corner



                                                                    Zoho Sheet Resources

                                                                     

                                                                        Zoho Forms Resources


                                                                          Secure your business
                                                                          communication with Zoho Mail


                                                                          Mail on the move with
                                                                          Zoho Mail mobile application

                                                                            Stay on top of your schedule
                                                                            at all times


                                                                            Carry your calendar with you
                                                                            Anytime, anywhere




                                                                                  Zoho Sign Resources

                                                                                    Sign, Paperless!

                                                                                    Sign and send business documents on the go!

                                                                                    Get Started Now




                                                                                            Zoho TeamInbox Resources





                                                                                                      Zoho DataPrep Demo

                                                                                                      Get a personalized demo or POC

                                                                                                      REGISTER NOW


                                                                                                        Design. Discuss. Deliver.

                                                                                                        Create visually engaging stories with Zoho Show.

                                                                                                        Get Started Now









                                                                                                                            • Related Articles

                                                                                                                            • How to trigger document merge in Zoho Writer

                                                                                                                              Overview Zoho Writer document merge can be triggered in four ways: manually, on a schedule, on form submission, or via an incoming webhook. This flexibility allows you to choose the most suitable automation method—whether you want to merge documents ...
                                                                                                                            • How to merge Writer templates using Zoho Flow

                                                                                                                              We're working on a Zoho Flow-Writer integration to help you pick template documents from Writer, place merge fields on them and merge it with data from Zoho Services. Find below steps to merge Writer Documents and with Zoho Creator Form fields. Steps ...
                                                                                                                            • Configure workflow in Zoho Books with Writer's mail merge

                                                                                                                              With the Zoho Books and Zoho Writer merge integration, you can easily generate customized documents, like shipping labels or invoices, directly from your Zoho Books data. For instance, if you need to create labels for customer orders that include ...
                                                                                                                            • How to setup image type merge field in Zoho Writer

                                                                                                                              Overview The Image Field Merge feature in Zoho Writer lets you dynamically insert images (like profile photos, product images, logos, or scanned documents) into templates during a mail merge. You can map image fields from your data source—such as ...
                                                                                                                            • Configure workflow in Zoho Projects with Writer's mail merge

                                                                                                                              Zoho Writer and Zoho Projects' integration allows collaboration and document management for project teams. Project managers can automate the creation of critical documents using Zoho Writer's custom functions and workflow rules. The integration also ...
                                                                                                                              Wherever you are is as good as
                                                                                                                              your workplace

                                                                                                                                Resources

                                                                                                                                Videos

                                                                                                                                Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                                                eBooks

                                                                                                                                Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                                                Webinars

                                                                                                                                Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                                                CRM Tips

                                                                                                                                Make the most of Zoho CRM with these useful tips.



                                                                                                                                  Zoho Show Resources