Articles in this section
Category / Section

How to mail merge Word document in Linux (Mono) in ASP.NET Core?

5 mins read

Mail merge is a process of merging data from a data source to a Word template document. Syncfusion Essential DocIO is a .NET Core Word library used to generate reports like invoice, payroll, letter, etc., by performing mail merge faster in a batch process without Microsoft Word or interop dependencies. Using this library, you can mail merge Word document in ASP.NET Core Linux.

Steps to Mail merge Word document in Linux:

  1. Execute the following command in Linux terminal to create a new ASP.NET Core Console project in Linux

    dotnet new console

create a new ASP.NET Core Console project in Linux

  1. Install the Syncfusion.DocIO.Net.Core NuGet package as a reference to your ASP.NET Core project from by execute the following command.

    dotnet add package Syncfusion.DocIO.Net.Core -v -s

Add "Syncfusion.DocIO.Net.Core" NuGet package

  1. Add the following Namespaces in Program file.
    using Syncfusion.DocIO;
    using Syncfusion.DocIO.DLS;
    using System.IO;
  1. Add the following code snippet in Program.cs file.
    //Create FileStream to opens the Word template document
    FileStream fileStreamPath = new FileStream(@"Data/Letter Formatting.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
    using(WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx))
       string[] fieldNames = { "ContactName", "CompanyName", "Address", "City", "Country", "Phone" };
       string[] fieldValues = { "Nancy Davolio", "Syncfusion", "507 - 20th Ave. E.Apt. 2A", "Seattle, WA", "USA", "(206) 555-9857-x5467" };
       //Performs the mail merge
       document.MailMerge.Execute(fieldNames, fieldValues);
       //Create FileStream to save the Word file
       FileStream outputStream = new FileStream("Result.docx", FileMode.Create, FileAccess.ReadWrite, FileShare.ReadWrite);
       //Saves the Word file
       document.Save(outputStream, FormatType.Docx);
       //Close the Word file
  1. Execute the following command to restore the NuGet packages.

    dotnet restore

Restore the NuGet packages in Linux

  1. Execute the following command in terminal to run the application ASP.NET Core application in Linux.

    dotnet run

Run ASP.NET Core application in Linux

A complete working example of mail merge Word document in Linux can be downloaded from mail merge Word

By executing the program, you will get the Word document as follows. Mailmerge output Word document

Take a moment to peruse the documentation, where you can find basic Word document processing options along with features like mail merge, merge and split documents, find and replace text in the Word document, and most importantly PDF conversion with code examples.

Explore more about the rich set of Syncfusion Word Framework features.

An online example to perform mail merge in Word document.

See Also:

How to Mail Merge Word document in ASP.NET Core

How to Mail Merge Word document in ASP.NET

How to Mail Merge Word document in ASP.NET MVC

How to Mail Merge Word document in Xamarin

How to Mail Merge Word document in Xamarin.Android

How to Mail Merge Word document in Xamarin.iOS


Starting with v16.2.0.x, if you reference Syncfusion assemblies from trial setup or from the NuGet feed, include a license key in your projects. Refer to link to learn about generating and registering Syncfusion license key in your application to use the components without trail message.



I hope you enjoyed learning about how to mail merge Word document in Linux (Mono).

You can refer to our ASP.NET Core Word feature tour page to know about its other groundbreaking feature representations and documentation, and how to quickly get started for configuration specifications. You can also explore our ASP.NET Core Word example to understand how to create and manipulate data.

For current customers, you can check out our components from the License and Downloads page. If you are new to Syncfusion, you can try our 30-day free trial to check out our other controls.

If you have any queries or require clarifications, please let us know in the comments section below. You can also contact us through our support forumsDirect-Trac, or feedback portal. We are always happy to assist you!

Did you find this information helpful?
Help us improve this page
Please provide feedback or comments
Comments (0)
Please  to leave a comment
Access denied
Access denied