Insert Headers and Page Numbers in a Word Document

The header is a section of the document that appears in the top margin and generally contains information such as the page number, date, and document name. With Aspose.Words REST APIs you can insert page number in Word document as well as page headers. By default, the headers are the same on each page, but we can create different headers for odd and even pages.

This post aims to achieve the following layout of the document, in which the header on the first page is different from the rest of the pages:

Before calling any Aspose REST API, we need to create Aspose Cloud account and obtain our App Key and App SID. Getting started article explains how to perform these steps.

Moreover, we need to upload the sample document to the Cloud Storage as all the operations on the document will be performed in the Cloud:

Insert Header in a Word Document

Insert Header Footer API adds headers in a document and its headerFooterType parameter can take one of the following six values:

• HeaderFirst - Header for the first page of the section.
• HeaderPrimary - Primary header, also used for odd numbered pages.
• HeaderEven - Header for even numbered pages.
• FooterFirst - Footer for the first page of the section.
• FooterPrimary - Primary footer, also used for odd numbered pages.
• FooterEven - Footer for even numbered pages.

Please use HeaderFirst value to insert header in the first page:

and HeaderPrimary value to insert header in the rest of the pages:

Since the first header is different from the others, set DifferentFirstPageHeaderFooter parameter value to true as shown below:

After the execution of above code snippet, empty paragraphs have been added to the headers of the document. Now, in oder to add text to these headers, we will use Insert Paragraph API. The code shown below is adding “Aspose” text in the first header and “Cloud File Format APIs” text in all other headers:

Apply Formatting to a Header’s Text

Formatting can be applied to a header’s text using Update Run Font API. The API accepts fontDto object in its body, whose Resource Properties’ details are given in Update font properties for text in a Word document article. The following code is setting font family of the header text to Verdana, text size to 14 and text color to black.

After making the above API calls, the input document looks as follows:

Insert Page Numbers in a Word Document

InsertPageNumbers API is used to insert page numbers in a Word document. The API accepts the following JSON object in its body:

{
  "Format": "string",
  "Alignment": "string",
  "IsTop": true,
  "SetPageNumberOnFirstPage": true
}
copy

Since we are adding page numbers in the header, we will set IsTop parameter’s value to true. However, to add page numbers in the footer, set the value to false.

Finally, we have added headers and page numbers to the document.

Suggested Post:

We also recommend reviewing the following blog posts to learn more about:

• Convert TSV to Excel Using C# .NET
• Seamless JPG to Word Conversion using .NET REST API
• Convert EPUB to Word Document (DOC, DOCX) using .NET REST API