# Manage Page Breaks in Data Regions

This topic explains how to control page breaks in data groups of data regions with the NewPage property in combination with the PageBreakAtStart, PageBreakAtEnd, and BreakLocation properties.

## Content



You can control page breaks in data groups of data regions by using the **NewPage** property for data regions and its combination with the **PageBreakAtStart**, **PageBreakAtEnd**, and **BreakLocation** properties. These properties help you tune page breaks after or before a data group in your report and on which page to continue displaying the report content.

The **NewPage** property works for the data regions - List, Table, BandedList, Tablix, Container, TOC, and Chart, and has the following options.

*   Next - a default value that makes a new group start from the immediate next page of the report.
*   Odd - a new group starts from the next odd page of the report.
*   Even - a new group starts from the next even page of the report.

You can use the **NewPage** property for the following data region groups:

*   Table: Groups, Detail groups
*   Tablix: Row groups, Adjacent Row groups, Child Row groups
*   List: Detail groups
*   BandedList: Groups, Details section

### NewPage and PageBreakAtStart / PageBreakAtEnd

See the possible combinations of NewPage with the PageBreakAtStart and PageBreakAtEnd properties.

| **PageBreakAtStart** | **PageBreaktEnd** | **NewPage > Next** | **NewPage > Odd** | **NewPage > Even** |
| :-: | :-: | --- | --- | --- |
| False | False | No new page | No new page | No new page |
| False | True | A new page is added after the data region. | A new page is added after the data region and at odd page of the report. | A new page is added after the data region and at even page of the report. |
| True | False | A new page is added before the data region. | A new page is added before the data region and at odd page of the report. | A new page is added before the data region and at even page of the report. |
| True | True | A new page is added before and after the data region. | A new page is added before and after the data region and at odd page of the report. | A new page is added before and after the data region and at even page of the report. |

The image below uses a report that has a Table data region with the following properties:

*   PageBreakAtEnd > True
*   PageBreakAtStart > False
*   NewPage > Even

As a result, the report renders 10 pages, a page break is added after a table, and a new page is added after the table at an even page (Page 10).

![NewPage as Page Break](https://cdn.mescius.io/document-site-files/images/b298aea2-8cb8-4a0f-be88-4f54aa263ebd/images/design-reports/newpage.png)

After the same properties are changed as

*   PageBreakAtEnd > False
*   PageBreakAtStart > True
*   NewPage > Odd

As a result, the report renders 11 pages, a page break is added before a table (Page 2), and a new page is added at odd page of the report (Page 1).

### NewPage and BreakLocation

The **BreakLocation** property controls the break location of a data group. See the possible combination of the **NewPage** with the **BreakLocation** property.

|  | **NewPage > Next** | **NewPage > Odd** | **NewPage > Even** |
| --- | --- | --- | --- |
| **BreakLocation > None** |   No page break   |  |  |
| **BreakLocation > Start** | A page break is added before a new group. A new group starts from the next page of the report. | A page break is added before a new group. A new group starts from the next odd page of the report. | A page break is added before a new group. A new group starts from the next even page of the report. |
| **BreakLocation > End** | A page break is added after a current group. A new group starts from the next page of the report. 1 | A page break is added after a current group. A new group starts from the next odd page of the report. 1 | A page break is added before a new group. A new group starts from the next even page of the report. 1 |
| **BreakLocation > StartAndEnd** | A page break is added before and after a current group. A new group starts from the next page of the report. | A page break is added before and after a current group. A new group starts from the next odd page of the report. | A page break is added before a new group. A new group starts from the next even page of the report. |
| **BreakLocation > Between** | A page break is between groups. A new group starts from the next page of the report. 1 | A page break is between groups. A new group starts from the next odd page of the report. 1 | A page break is added before a new group. A new group starts from the next even page of the report. 1 |

1 The first group always starts on the first page.

### Multiple Data Regions Behavior

In a report with multiple data regions, the behavior of the **NewPage** property is as follows:

*   If at least one data region in a report has the **NewPage > Even**, page breaks are added with the value **Even** for all report's data regions.
*   If at least one data region in a report has the **NewPage > Odd**, page breaks are added with the value **Odd** for all report's data regions.
*   If NewPage is set to different values in data regions of a report, page breaks are added with the value **Next** for all data regions.


> type=note
> **Page report Limitation**: When multiple data regions are added to the same page, the data regions take the **Next** value; the other values (Odd, Even) are ignored.