---
title: "Customizing the page number"
canonical_url: "https://www.nutrient.io/guides/ios/customizing-pdf-pages/customizing-the-page-number/"
md_url: "https://www.nutrient.io/guides/ios/customizing-pdf-pages/customizing-the-page-number.md"
last_updated: "2026-05-25T09:22:39.231Z"
description: "Learn how to customize PDF page labels in Adobe Acrobat and Nutrient for better navigation with options like numbers, Roman numerals, and custom strings."
---

This guide explains how page labels appear in Nutrient iOS SDK and how to configure them in a PDF.

For a cross-product overview of how PDF page labels work and how each Nutrient product handles them, refer to the [PDF page labels](https://www.nutrient.io/guides/pdf-page-labels.md) guide.

The PDF format has a page label feature that allows the creator of a PDF to set custom page labels such as Prelude, Table of Contents, 1, and 2 instead of the traditional serial numbering. Page labels can be numbers, Roman numerals, or even any string.

Nutrient 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.

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.

## Showing custom page labels

Nutrient supports showing custom page labels in the UI. To show custom labels in the UI, register a subclass of [`LabelParser`](https://www.nutrient.io/api/ios/documentation/pspdfkit/labelparser) and override the `pageLabelForPage(at:)` and `page(forPageLabel:partialMatching:)` methods. This does not edit the PDF itself.
---

## Related pages

- [Advanced Carthage integration](/guides/ios/miscellaneous/advanced-carthage-integration.md)
- [Advanced CocoaPods integration](/guides/ios/miscellaneous/advanced-cocoapods-integration.md)
- [Airdrop](/guides/ios/features/airdrop.md)
- [App Transport Security](/guides/ios/pspdfkit-instant/app-transport-security.md)
- [Bitcode](/guides/ios/faq/bitcode.md)
- [Carthage integration](/guides/ios/best-practices/carthage-integration.md)
- [Framework Size](/guides/ios/faq/framework-size.md)
- [About Memory Usage](/guides/ios/memory-and-storage/about-memory-usage.md)
- [Nightly Builds](/guides/ios/best-practices/nightly-builds.md)
- [Customizing the log level on iOS](/guides/ios/features/logging.md)
- [Optimize PDF documents for mobile rendering on iOS](/guides/ios/miscellaneous/optimize-pdf-documents-for-mobile-rendering.md)
- [Modifying permissions in your iOS app](/guides/ios/getting-started/permissions.md)
- [Powered By Nutrient](/guides/ios/miscellaneous/powered-by-nutrient.md)
- [Saving Data Externally](/guides/ios/memory-and-storage/saving-data-externally.md)
- [iOS PDF SDK security](/guides/ios/faq/sdk-security.md)
- [Reduce App Size](/guides/ios/best-practices/reduce-app-size.md)
- [Strategies For Multiple Bundle Ids](/guides/ios/faq/strategies-for-multiple-bundle-ids.md)
- [Third Party Compatibility](/guides/ios/miscellaneous/third-party-compatibility.md)
- [Transferring File Edits To A Server](/guides/ios/best-practices/transferring-file-edits-to-a-server.md)
- [Version Numbering](/guides/ios/best-practices/version-numbering.md)
- [Using Document Efficiently](/guides/ios/getting-started/using-document-efficiently.md)
- [Using Automatic Saving Safely](/guides/ios/best-practices/using-automatic-saving-safely.md)
- [Manage your iOS status bar with view controllers](/guides/ios/faq/view-controller-based-status-bar-appearance.md)
- [Youtube Links](/guides/ios/miscellaneous/youtube-links.md)