# MailMerge: Starting Each Merge Block on a New Page

> Merge blocks in TX Text Control repeat based on matching data rows. Applying ParagraphFormat.PageBreakBefore to the first paragraph of a block forces each repetition onto a new page. Section breaks and column breaks within blocks provide additional layout control for merged documents.

- **Author:** Bjoern Meyer
- **Published:** 2016-09-09
- **Modified:** 2026-03-05
- **Description:** Merge blocks in TX Text Control repeat based on matching data rows. Applying ParagraphFormat.PageBreakBefore to the first paragraph of a block forces each repetition onto a new page. Section breaks and column breaks within blocks provide additional layout control for merged documents.
- **2 min read** (318 words)
- **Tags:**
  - Cloud
  - Mail Merge
  - Reporting
  - ReportingCloud
  - Tutorial
- **Web URL:** https://www.textcontrol.com/blog/2016/09/09/mailmerge-starting-each-merge-block-on-a-new-page/
- **LLMs URL:** https://www.textcontrol.com/blog/2016/09/09/mailmerge-starting-each-merge-block-on-a-new-page/llms.txt
- **LLMs-Full URL:** https://www.textcontrol.com/blog/2016/09/09/mailmerge-starting-each-merge-block-on-a-new-page/llms-full.txt

---

A merge block is repeated based on the number of matching data rows in the hierarchical data object. The complete merge block is cloned and inserted under the original location in the template. But thanks to the flexibility of the "Flow Type Layout Reporting" approach, a merge block may contain everything: A table row, a complete table, text frames and paragraphs including all paragraph settings.

And these paragraph settings can be used to realize sophisticated layouts. The property [ParagraphFormat.PageBreakBefore](https://docs.textcontrol.com/textcontrol/windows-forms/ref.txtextcontrol.paragraphformat.pagebreakbefore.property.htm) defines whether or not a paragraph is always rendered at the top of a page. If you apply this paragraph setting to the first paragraph of a merge block, the whole merge block begins at the top of a new page:

![MailMerge: Starting each merge block on a new page](https://s1-www.textcontrol.com/assets/dist/blog/2016/09/09/a/assets/mergeblock.webp "MailMerge: Starting each merge block on a new page")In the merged document, each of these block rows start at the top of a new page:

![MailMerge: Starting each merge block on a new page](https://s1-www.textcontrol.com/assets/dist/blog/2016/09/09/a/assets/merged.webp "MailMerge: Starting each merge block on a new page")If the merge block should break after the first block and the new block should be rendered on a new section, a section break can be included into the merge block. Therefore, simply set the input position to the end of the block and select *Breaks -> Next Page* from the *Page Setup* group in the *Page Layout* ribbon tab.

![MailMerge: Starting each merge block on a new page](https://s1-www.textcontrol.com/assets/dist/blog/2016/09/09/a/assets/mergeblock_section.webp "MailMerge: Starting each merge block on a new page")This can be done with page breaks, continuous section breaks or column breaks to realize different layouts.

---

## About Bjoern Meyer

As CEO, Bjoern is the visionary behind our strategic direction and business development, bridging the gap between our customers and engineering teams. His deep passion for coding and web technologies drives the creation of innovative products. If you're at a tech conference, be sure to stop by our booth - you'll most likely meet Bjoern in person. With an advanced graduate degree (Dipl. Inf.) in Computer Science, specializing in AI, from the University of Bremen, Bjoern brings significant expertise to his role. In his spare time, Bjoern enjoys running, paragliding, mountain biking, and playing the piano.

- [LinkedIn](https://www.linkedin.com/in/bjoernmeyer/)
- [X](https://x.com/txbjoern)
- [GitHub](https://github.com/bjoerntx)

---

## Related Posts

- [ReportingCloud: Uploading Templates Vs. Sending Templates Inside MergeBody](https://www.textcontrol.com/blog/2017/08/02/reportingcloud-uploading-templates-vs-sending-templates-inside-mergebody/llms.txt)
- [MailMerge: Table Headers and Repeating Blocks](https://www.textcontrol.com/blog/2017/08/01/mailmerge-table-headers-and-repeating-blocks/llms.txt)
- [ReportingCloud: Conditional Text Blocks Based on Merge Blocks](https://www.textcontrol.com/blog/2016/11/02/reportingcloud-conditional-text-blocks-based-on-merge-blocks/llms.txt)
- [Web API Test Sandbox Released on ReportingCloud Portal](https://www.textcontrol.com/blog/2016/10/07/web-api-test-sandbox-released-on-reportingcloud-portal/llms.txt)
- [ReportingCloud: New Test Parameter for Document Quota Related Endpoints](https://www.textcontrol.com/blog/2016/10/06/reportingcloud-new-test-parameter-for-document-quota-related-endpoints/llms.txt)
- [ReportingCloud: The MergeData JSON Object Format Explained](https://www.textcontrol.com/blog/2016/10/04/reportingcloud-the-mergedata-json-object-format-explained/llms.txt)
- [Creating Dynamic HTML Forms Using ReportingCloud](https://www.textcontrol.com/blog/2016/09/28/creating-dynamic-html-forms-using-reportingcloud/llms.txt)
- [Creating Reports from QuickBooks or Salesforce Data Sources Using ReportingCloud and CData Cloud Drivers](https://www.textcontrol.com/blog/2016/06/30/creating-reports-from-quickbooks-or-salesforce-data-sources-using-reportingcloud-and-cdata-cloud-drivers/llms.txt)
- [Create your First Document with ReportingCloud](https://www.textcontrol.com/blog/2019/02/19/create-your-first-document-with-reportingcloud/llms.txt)
- [ReportingCloud Monthly Payment Available](https://www.textcontrol.com/blog/2018/09/18/reportingcloud-monthly-payment-available/llms.txt)
- [Different Ways to Create Documents using Text Control Products](https://www.textcontrol.com/blog/2017/10/17/ways-to-create-documents-using-text-control-products/llms.txt)
- [Proofing Tools Available As ReportingCloud Web API Endpoints](https://www.textcontrol.com/blog/2017/08/23/proofing-tools-available-as-reportingcloud-web-api-endpoints/llms.txt)
- [All Google Fonts Now Available in ReportingCloud](https://www.textcontrol.com/blog/2017/08/22/all-google-fonts-now-available-in-reportingcloud/llms.txt)
- [New ReportingCloud MergeSettings Option: Merge HTML Content into Merge Fields](https://www.textcontrol.com/blog/2017/08/21/new-reportingcloud-mergesettings-option-merge-html-content-into-merge-fields/llms.txt)
- [Retrieving Template Information Using the ReportingCloud Web API](https://www.textcontrol.com/blog/2017/08/11/retrieving-template-information-using-the-reportingcloud-web-api/llms.txt)
- [Merging Nested Repeating Blocks in ReportingCloud](https://www.textcontrol.com/blog/2017/08/10/merging-nested-repeating-blocks-in-reportingcloud/llms.txt)
- [More Impressions from DWX Developer Week 2017](https://www.textcontrol.com/blog/2017/06/29/more-impressions-from-dwx-developer-week-2017/llms.txt)
- [DWX Developer Week 2017: First Impressions](https://www.textcontrol.com/blog/2017/06/27/dwx-developer-week-2017-first-impressions/llms.txt)
- [NDC Oslo 2017 Impressions: Part II](https://www.textcontrol.com/blog/2017/06/19/ndc-oslo-2017-impressions-part-ii/llms.txt)
- [First Day at NDC Oslo 2017: Some Impressions](https://www.textcontrol.com/blog/2017/06/15/first-day-at-ndc-oslo-2017-some-impressions/llms.txt)
- [Impressions from DevIntersection Spring in Orlando, FL](https://www.textcontrol.com/blog/2017/05/23/impressions-from-devintersection-spring-in-orlando-fl/llms.txt)
- [Impressions from Magdeburger Developer Days 2017](https://www.textcontrol.com/blog/2017/05/15/impressions-from-magdeburger-developer-days-2017/llms.txt)
- [Impressions from Dotnet Cologne 2017](https://www.textcontrol.com/blog/2017/05/08/impressions-from-dotnet-cologne-2017/llms.txt)
- [New ASP.NET MVC DocumentViewer Rolled out to the ReportingCloud Portal](https://www.textcontrol.com/blog/2017/04/22/new-aspnet-mvc-documentviewer-rolled-out-to-the-reportingcloud-portal/llms.txt)
- [New ReportingCloud Endpoint: List Available Fonts](https://www.textcontrol.com/blog/2017/03/29/new-reportingcloud-endpoint-list-available-fonts/llms.txt)
