Performing Nested MailMerge with Multiple Levels in RadWordsProcessing

Updated on Jun 9, 2026

Environment

Version	Product	Author
2024.3.806	RadWordsProcessing	Desislava Yordanova

Description

This article shows how to perform a MailMerge operation with multiple levels of nested data, such as a list within a list (for example, Incident > Person > Phones) in RadWordsProcessing.

Solution

To perform a nested MailMerge operation with multiple levels of data, follow these steps:

1. Prepare your data model to reflect the nested structure. In this case, the model includes the Incident, Person, and Phone classes.

2. Use the MailMerge method to merge the data with the document template. Ensure your document template has the appropriate merge fields defined for each level of data.

3. Use special merge fields (TableStart, TableEnd, RangeStart, and RangeEnd) to denote the beginning and end of each nested collection.

The following example shows how to set up your data model and perform the nested MailMerge:

Example 1: Set Up Nested Data Model and Perform MailMerge

csharp

// Define your data models.
public class Incident
{
    public string ReportNumber { get; set; }
    public List<Person> People { get; set; }
}

public class Person
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public List<Phone> Phones { get; set; }
}

public class Phone
{
    public string PhoneNumber { get; set; }
}

// Prepare the data.
var mergeData = new List<Incident>{
    new Incident{
        ReportNumber = "INC-2024-001",
        People = new List<Person>{
            new Person{
                FirstName = "John",
                LastName = "Doe",
                Phones = new List<Phone>{
                    new Phone{ PhoneNumber = "310-555-0101" },
                    new Phone{ PhoneNumber = "310-555-0102" }
                }
            },
            // Add more Person instances as needed.
        }
    }
};

// Perform the MailMerge operation.
RadFlowDocument document = new RadFlowDocument();
// Assume 'provider' is initialized and points to the appropriate document format provider.
var mailMergeResult = document.MailMerge(mergeData);

In your document template, ensure you have the corresponding merge fields:

• For the start and end of the People list: TableStart:People and TableEnd:People.

• For the start and end of the Phones list within each Person: RangeStart:Phones and RangeEnd:Phones.

• For merging individual property values, use merge fields named after the properties, such as FirstName, LastName, and PhoneNumber.

  

Generating the Table Structure in the Document

When you work with nested collections, you must dynamically create table structures that accommodate the varying lengths of these collections.

The following image shows the result of the nested MailMerge operation:

See Also

• MailMerge
• Generating a Word Document with Data Using MailMerge in RadWordsProcessing
• Populate a Table with Data Using Nested Mail Merge Functionality