[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
   [Expand]Product Information
   [Expand]Getting Started
   [Collapse]Graphical User Interface
    [Expand]Snap Application Elements
    [Collapse]Main Toolbar
      General Tools: File
      General Tools: Insert
      General Tools: View
      General Tools: References
      Table Tools: Design
      Table Tools: Layout
      Data Tools: Appearance
      Data Tools: Field
      Data Tools: Group
      Data Tools: List
      Data Tools: Mail Merge
      General Tools: Home
      General Tools: Page Layout
      General Tools: Review
      Chart Tools: Design
      Header and Footer Tools: Design
      Picture Tools: Format
    [Expand]Data Visualization Tools
    Supported Formats
   [Expand]Developer Guidelines
   [Expand]Data Acquisition
   [Expand]Data Shaping
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Data Tools: Mail Merge

The commands available in the Mail Merge section of the Data Tools toolbar are divided into the following categories.

Expanded Data


Large Icon

Small Icon


Data Source

Enables mail merge for a connected data source.

After enabling this mode, the data source icon is displayed in green in the Data Explorer.

There is no functionality for disabling mail merge once it has been implemented.


Invokes the FilterString Editor to filter data in a mail merge document.


Invokes the Sort dialog to sort data in a mail merge document.

Expanded Current Record



Current Record

Allows you to navigate through records in a mail merge document. You can navigate to the Next Page, the Previous Page, the First Page or the Last Page.

Expanded Publish


Large Icon

Small Icon


Finish & Merge

Finalizes a mail merge document by supplying actual values to data elements added to a document template.

This command invokes a drop-down menu to select the publishing format of a document. The following options are available.

  • Export - exports the created document to a selected third-party format;

  • Print - invokes the print dialog to adjust the page options of the document before sending it to a printer;

  • Print Preview - displays the created document in a print preview window that provides options to navigate, print and/or export the document.

After selecting the document's output format, the Export Range dialog is invoked to specify the range of data records that the document should include.

In this dialog, you can choose from the following separators to isolate different data records.

  • None;

  • Page Break;

  • Section (Next Page);

  • Section (Even Page);

  • Section (Odd Page);

  • Paragraph.

To learn how to provide custom separators, refer to the following online code example: How to provide custom separators for records of a mail-merge document.

After clicking OK, Snap starts assembling the document. To avoid application lock-ups, the document is assembled in a separate background thread.

To implement a custom progress indicator, refer to the following online code example: How to add a custom progress indicator to a Snap application.

Expanded See Also

Is this topic helpful?​​​​​​​