# Headers and Footers > Add headers, footers and Page x of y numbers in C# with ServerTextControl: first-page and odd or even headers, section headers, restarted numbering and removal. - **Product:** TX Text Control .NET Server - **Section:** Documentation - **Kind:** Topic - **Path:** TX Text Control .NET Server > Document Processing > Headers and Footers - **5169 words** - **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-server/document-processing/headers-footers/ - **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-server/document-processing/headers-footers/llms.txt - **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-server/document-processing/headers-footers/llms-full.txt --- A letterhead on the first page, a report title at the top of every page and "Page 3 of 12" at the bottom are headers and footers. `ServerTextControl` adds them to a whole document or to single sections, gives the first page and the even pages versions of their own, fills them with page number fields and removes them from documents you load. [Create a Document](https://docs.textcontrol.com/tx-text-control-dotnet-server/getting-started/document-processing/create/llms-full.txt) adds a first header with a line of text. The code of each example goes into *Program.cs* of a console application and runs on its own. A section is a part of a document with its own page settings; [Sections](https://docs.textcontrol.com/tx-text-control-dotnet-server/document-processing/sections/llms-full.txt) explains how to insert one. ### How Headers and Footers Work A header or footer is a [HeaderFooter](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfooter/llms-full.txt) object. It has its own [Selection](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfooter/selection-property/llms-full.txt) and its own collections, such as [Paragraphs](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfooter/paragraphs-property/llms-full.txt), [Tables](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfooter/tables-property/llms-full.txt) and [Images](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfooter/images-property/llms-full.txt), so you insert and format text in it the same way as in the main text. Headers and footers belong to a [HeaderFooterCollection](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfootercollection/llms-full.txt), which you get in two places: - **For the document,** [ServerTextControl.HeadersAndFooters](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/servertextcontrol/headersandfooters-property/llms-full.txt). A header added here goes to the first section, and every other section receives a header that is connected to the header of its previous section. Connected headers always have the same content. - **For one section,** [Section.HeadersAndFooters](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/section/headersandfooters-property/llms-full.txt). Use this collection as soon as a document has more than one section: through the document's collection, most collections of a `HeaderFooter` are then `null`. Both collections have the same methods. [Add](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfootercollection/add-method/llms-full.txt) adds a header or footer and returns `true` if it was added, [GetItem](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfootercollection/getitem-method/llms-full.txt) returns one that has been added, and [Remove](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfootercollection/remove-method/llms-full.txt) removes it. Each takes a value of [HeaderFooterType](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfootertype/enumeration/llms-full.txt), and `Add` and `Remove` accept several values combined, such as `HeaderFooterType.Header | HeaderFooterType.Footer`: | Type | Appears on | |---|---| | `Header`, `Footer` | All pages. If the document or section has an even header or footer, the odd pages | | `FirstPageHeader`, `FirstPageFooter` | The first page of the document or section | | `EvenHeader`, `EvenFooter` | The even pages. Adding an even header also creates the odd header, because the two only exist together | | `All` | All headers and footers, for `Add` and `Remove` | There is no separate setting for a different first page or for different odd and even pages: a document has them when it contains headers or footers of these types. [HeaderFooter.Distance](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfooter/distance-property/llms-full.txt) sets the position in twips, 1/1440 inch. For a header, it is the distance from the top of the page to the top of the header; for a footer, from the bottom of the page to the bottom of the footer. The default is 567 twips, which is 1 cm. ### Add a Footer With Page Numbers A [PageNumberField](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/pagenumberfield/llms-full.txt) shows the number of the page it's on. It can only be used in a header or footer, and you add it through [HeaderFooter.PageNumberFields](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfooter/pagenumberfields-property/llms-full.txt). The following program creates a document of several pages with the footer "Page x of y": ```csharp using TXTextControl; using (ServerTextControl tx = new ServerTextControl()) { tx.Create(); // Enough text for several pages for (int i = 1; i <= 150; i++) { tx.Selection.Text = "This is paragraph " + i + " of the sample document.\r\n"; } // Add a footer to the document and get it tx.HeadersAndFooters.Add(HeaderFooterType.Footer); HeaderFooter footer = tx.HeadersAndFooters.GetItem(HeaderFooterType.Footer); // "Page x of y": text, the page number, text, the number of pages footer.Selection.Text = "Page "; footer.PageNumberFields.Add(new PageNumberField(1, NumberFormat.ArabicNumbers)); footer.Selection.Text = " of "; PageNumberField numberOfPages = new PageNumberField(); numberOfPages.ShowNumberOfPages = true; footer.PageNumberFields.Add(numberOfPages); // Center the paragraph of the footer footer.Selection.ParagraphFormat.Alignment = HorizontalAlignment.Center; // 720 twips = 0.5 inch from the bottom of the page footer.Distance = 720; tx.Save("page-numbers.pdf", StreamType.AdobePDF); } ``` The code works as follows: - `Add` adds a footer of the type `Footer`, and `GetItem` returns it. - `footer.Selection.Text` inserts text at the input position of the footer, like `tx.Selection.Text` in the main text. - [PageNumberFieldCollection.Add](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/pagenumberfieldcollection/add-method/llms-full.txt) inserts a page number field at the input position of the footer. The [constructor](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/pagenumberfield/constructor/llms-full.txt) takes the number of the first page and a [NumberFormat](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/numberformat/enumeration/llms-full.txt) value. - [ShowNumberOfPages](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/pagenumberfield/shownumberofpages-property/llms-full.txt) makes the second field show the total number of pages instead of the page number. - `Selection.ParagraphFormat.Alignment` centers the paragraph of the footer. Open *page-numbers.pdf*: every page shows its number and the number of pages at the bottom. The fields update when the number of pages changes. Page number fields are compatible with MS Word and are kept in DOCX, DOC and RTF documents. ![The bottom of the first page of page-numbers.pdf: the last paragraphs of the page and the centered footer "Page 1 of 3".](https://docs.textcontrol.com/assets/img/tx-text-control-dotnet-server/footer-page-x-of-y.fcd11224.webp) [NumberFormat](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/pagenumberfield/numberformat-property/llms-full.txt) sets how the page number is written: `ArabicNumbers` (1, 2, 3), `Letters` (a, b, c), `CapitalLetters` (A, B, C), `RomanNumbers` (I, II, III) or `SmallRomanNumbers` (i, ii, iii). ### Use a Cover Page and Odd and Even Headers A report often has a cover page without a header and different headers on odd and even pages. The following program adds an empty first page header and an even header, which also creates the odd header: ```csharp using TXTextControl; using (ServerTextControl tx = new ServerTextControl()) { tx.Create(); for (int i = 1; i <= 200; i++) { tx.Selection.Text = "This is paragraph " + i + ".\r\n"; } // A header for the first page, which stays empty tx.HeadersAndFooters.Add(HeaderFooterType.FirstPageHeader); // An even header; the odd header is created with it tx.HeadersAndFooters.Add(HeaderFooterType.EvenHeader); // Header returns the odd header once an even header exists HeaderFooter oddHeader = tx.HeadersAndFooters.GetItem(HeaderFooterType.Header); oddHeader.Selection.Text = "Annual Report"; oddHeader.Selection.ParagraphFormat.Alignment = HorizontalAlignment.Right; HeaderFooter evenHeader = tx.HeadersAndFooters.GetItem(HeaderFooterType.EvenHeader); evenHeader.Selection.Text = "Text Control, LLC"; tx.Save("odd-even-headers.pdf", StreamType.AdobePDF); } ``` The first page has no header text. From the second page on, even pages show "Text Control, LLC" on the left, and odd pages show "Annual Report" on the right. ### Give a Section Its Own Header A new section starts with the settings of the previous section, including its headers and footers, and its headers are connected to the previous ones. To give a section a header with different content, get the header from the section and set [ConnectedToPrevious](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfooter/connectedtoprevious-property/llms-full.txt) to `false` before you change its text: ```csharp using TXTextControl; using (ServerTextControl tx = new ServerTextControl()) { tx.Create(); tx.Selection.Text = "Chapter 1\r\nThe first chapter."; tx.Sections.Add(SectionBreakKind.BeginAtNewPage); tx.Selection.Text = "Chapter 2\r\nThe second chapter."; // Section 2 receives a header that is connected to section 1 tx.HeadersAndFooters.Add(HeaderFooterType.Header); // With more than one section, get the headers from the sections HeaderFooter header1 = tx.Sections[1].HeadersAndFooters.GetItem(HeaderFooterType.Header); HeaderFooter header2 = tx.Sections[2].HeadersAndFooters.GetItem(HeaderFooterType.Header); // Connected headers always have the same content header2.ConnectedToPrevious = false; header1.Selection.Text = "Chapter 1"; header2.Selection.Text = "Chapter 2"; foreach (Section section in tx.Sections) { foreach (HeaderFooter headerFooter in section.HeadersAndFooters) { Console.WriteLine($"Section {section.Number}: {headerFooter.Type}, connected: {headerFooter.ConnectedToPrevious}"); } } tx.Save("section-headers.pdf", StreamType.AdobePDF); } ``` The code works as follows: - [Sections.Add](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/sectioncollection/add-method/llms-full.txt) inserts a section break, and the second chapter starts on a new page. - `tx.Sections[1]` and `tx.Sections[2]` return the sections by their number, which starts at 1. - `header2.ConnectedToPrevious = false` separates the header of the second section from the first, so each header keeps its own text. - [HeaderFooter.Type](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfooter/type-property/llms-full.txt) returns the type of each header or footer the loop finds. ### Restart Page Numbers in a Section Page numbers continue from section to section. [SectionFormat.RestartPageNumbering](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/sectionformat/restartpagenumbering-property/llms-full.txt) restarts them at the beginning of a section, with the number that the page number field's [StartNumber](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/pagenumberfield/startnumber-property/llms-full.txt) sets. The following program numbers the pages of an appendix with Roman numbers, starting at I: ```csharp using TXTextControl; using (ServerTextControl tx = new ServerTextControl()) { tx.Create(); tx.Selection.Text = "Main part of the document."; tx.Sections.Add(SectionBreakKind.BeginAtNewPage); tx.Selection.Text = "Appendix"; Section appendix = tx.Sections[2]; appendix.Format.RestartPageNumbering = true; // A footer for the appendix only appendix.HeadersAndFooters.Add(HeaderFooterType.Footer); HeaderFooter footer = appendix.HeadersAndFooters.GetItem(HeaderFooterType.Footer); footer.ConnectedToPrevious = false; footer.Selection.Text = "Appendix page "; footer.PageNumberFields.Add(new PageNumberField(1, NumberFormat.RomanNumbers)); tx.Save("appendix.pdf", StreamType.AdobePDF); } ``` ### Read and Remove Headers and Footers Documents that you load bring their headers and footers along. To list them, loop through the sections and their collections. The following program prints the type, the distance and the text of every header and footer of *Documents/sample.docx* and then removes all of them: ```csharp using TXTextControl; using (ServerTextControl tx = new ServerTextControl()) { tx.Create(); tx.Load("Documents/sample.docx", StreamType.WordprocessingML); foreach (Section section in tx.Sections) { foreach (HeaderFooter headerFooter in section.HeadersAndFooters) { Console.WriteLine($"Section {section.Number}: {headerFooter.Type}, distance {headerFooter.Distance} twips"); foreach (Paragraph paragraph in headerFooter.Paragraphs) { Console.WriteLine(" " + paragraph.Text); } } } // Remove all headers and footers of every section foreach (Section section in tx.Sections) { section.HeadersAndFooters.Remove(HeaderFooterType.All); } tx.Save("no-headers.docx", StreamType.WordprocessingML); } ``` `Remove` works for single types too. `Remove(HeaderFooterType.Header)` removes the header, and the even header with it if there is one. `Remove(HeaderFooterType.EvenHeader)` removes only the even header, and the odd header becomes the header of all pages. ### Other Content in Headers and Footers - **Images and watermarks.** `HeaderFooter.Images` adds images to a header or footer. An image placed behind the text of a header is repeated on every page of the section, which is how the blog article [Generating and Adding Watermarks to Documents using C#](https://www.textcontrol.com/blog/2023/12/20/generating-and-adding-watermarks-to-documents-using-csharp/) adds a watermark to each section. [Watermarks](https://docs.textcontrol.com/tx-text-control-dotnet-server/pdf/watermarks/llms-full.txt) covers watermarks in PDF documents. - **Fields.** [HeaderFooter.ApplicationFields](https://docs.textcontrol.com/tx-text-control-dotnet-server/reference/txtextcontrol/headerfooter/applicationfields-property/llms-full.txt) contains the fields of a header or footer, such as merge fields. As for the main text, set `LoadSettings.ApplicationFieldFormat` before you load a Word document, otherwise the collection is empty. [Fields](https://docs.textcontrol.com/tx-text-control-dotnet-server/document-processing/fields/llms-full.txt) describes the kinds of fields. - **Merge fields in templates.** `MailMerge` fills merge fields in headers and footers as well. When several records are merged into one document, each record starts a new section; the blog article [Merging Multiple Records with First-Page Headers and Footers](https://www.textcontrol.com/blog/2025/04/14/merging-multiple-records-with-first-page-headers-and-footers/) shows how `ConnectedToPrevious` gives each record's first page its own header data. ### Next Steps - [Sections](https://docs.textcontrol.com/tx-text-control-dotnet-server/document-processing/sections/llms-full.txt): insert sections with their own page size, orientation and columns. - [Fields](https://docs.textcontrol.com/tx-text-control-dotnet-server/document-processing/fields/llms-full.txt): work with the other fields of a document. - [Merge Fields](https://docs.textcontrol.com/tx-text-control-dotnet-server/mail-merge/fields/llms-full.txt): fill fields in headers and footers with data. - [Headers and Footers](https://docs.textcontrol.com/tx-text-control-dotnet-server/document-editor/headers-footers/llms-full.txt) in the Document Editor: add headers and footers from JavaScript. --- ## Nearby - **Previous:** [Charts and Barcodes](https://docs.textcontrol.com/tx-text-control-dotnet-server/document-processing/charts-barcodes/llms-full.txt) - **Next:** [Sections](https://docs.textcontrol.com/tx-text-control-dotnet-server/document-processing/sections/llms-full.txt)