add-header-printable-on-every-page-to-list.md

title	page_title	description	type	slug	res_type
Add Header Printable on Every Page to List Data Item	Add Table Header to List Item	Learn how you may add a static Table Header that may be printed on every page to a List Data Item in Telerik Reporting.	how-to	add-header-printable-on-every-page-to-list	kb

Environment

Product	Progress® Telerik® Reporting
Report Designers	Visual Studio/Standalone Report Designer

Description

When you add a [List data item]({%slug table_template_items%}#list) in the report designer, it contains only a detail group with a [Panel]({%slug telerikreporting/designing-reports/report-structure/panel%}) inside:

In many scenarios, you may need to add and display Headers in the List that repeat on every page.

Solution

The List is a variation of the Table as explained in the article [Template Variations of the Table Report Item]({%slug table_template_items%}) and exposes the property ColumnHeadersPrintOnEveryPage. The property lets you print the Table Header on every page where the table/list appears.

By default, the List lacks the Table Header, so we must add it to use the property and display a header on every page. Here are the necessary steps:

1. Insert a Row into the List:

   • Right-click over the List to open the [Context Menu]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/tools/context-menu%})
   • Select Insert Row -> Outside Group - Above

   

   The new row is a header for your List. You may display aggregated values from the DataSource of the List like Totals, Averages, etc. This row cannot be displayed on every page.

2. Add a Parent Group to the Column group defined by the just inserted row:

   • Select the List and go to the [Group Explorer]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/tools/group-explorer%}). Ensure the Group Explorer is in Extended Mode that displays the static groups.

   • Right-click over the column group to open the Context Menu

   • Select Add Group -> Parent Group. This opens the Table Group wizard:

     

   • Add a constant value, for example, 1 as a Grouping Expression. You may need to check and uncheck the Add Header/Footer to enable the OK button that will let you proceed:

     

   The wizard adds a new Table Header to the List. This is the header that respects the ColumnHeadersPrintOnEveryPage property.

3. (optional) Delete the row we added in Step 1 if you don't need it.

See Also

• [Table Overview]({%slug telerikreporting/designing-reports/report-structure/table-crosstab-list/overview%})
• [Crosstab Areas]({%slug telerikreporting/designing-reports/report-structure/table-crosstab-list/understanding-crosstab-areas%})
• [Table Cells, Rows, and Columns]({%slug telerikreporting/designing-reports/report-structure/table-crosstab-list/understanding-table-cells,-rows-and-columns%})