Customizing the Page Number
PSPDFKit supports the PDF page label feature, which means you can rewrite and change the regular absolute one-based numbering in PDF documents.
This means that a document that usually has the page numbering 1, 2, 3, 4 can be changed to have numbering like Prelude, Table of Contents, 1, 2. Page labels can be numbers, Roman numerals, or even free-text strings.
![](/images/guides/shared/customizing-pdf-pages/customizing-the-page-number/acrobat-thumbnails-46f21a33.png)
PSPDFKit fully supports page labels and will show custom labels instead of the default numbering, when available, in all places where page labels are displayed. This includes the Table of Contents view controller, the page position view, and the thumbnail views.
![](/images/guides/shared/customizing-pdf-pages/customizing-the-page-number/page-labels-android-3ab27d18.png)
You can configure page labels via Adobe Acrobat by opening the thumbnail view, right-clicking on a page, and choosing the Number Pages… menu entry.
![](/images/guides/shared/customizing-pdf-pages/customizing-the-page-number/acrobat-config-2cb82ee7.png)
Page Labels Visibility
You can disable/enable page labels through PdfActivityConfiguration
by calling hidePageLabels()
/showPageLabels()
in the PdfActivityConfiguration.Builder
. Page labels are displayed by default (if there are any — if not, regular page numbers are displayed instead).
Example:
val config = PdfActivityConfiguration.Builder(context)
.showPageLabels()
.build()
final PdfActivityConfiguration config = new PdfActivityConfiguration.Builder(context) .showPageLabels() .build();