Skip to main content

MailMergeOptions.NumberedListRestart Property

Sets the behavior of numbered lists when the mail merge operation is performed.

Namespace: DevExpress.XtraRichEdit.API.Native

Assembly: DevExpress.RichEdit.v24.1.Core.dll

NuGet Packages: DevExpress.RichEdit.Core, DevExpress.Win.Navigation


MailMergeNumberingRestart NumberedListRestart { get; set; }

Property Value

Type Description

An enumeration value that indicates the numbering list restart mode.

Available values:

Name Description

Continue the list numbering unless otherwise specified in the list settings (e.g, when a specific numbered list is manually restarted).


Restart a numbered list for each record.


Restart the numbered list for each record, but ignore lists that are created by applying paragraph styles with numbering (e.g., “Chapter 1”, “Chapter 2”, etc.).


To restart a numbered list for each record in a mail merge document, set this property to the Always or AlwaysExceptParagraphStyles.


When you work with large data sources, the NumberedListRestart property usage may result in a performance degradation. If your usage scenario requires the NumberedListRestart property, divide your data source into batches and use these parts in the mail merge process to obtain separate documents with small parts of your data source. You can use the FirstRecordIndex and LastRecordIndex properties to complete the task.

See Also