---
title: "Inconsistent Labels"
canonical_url: "https://www.nutrient.io/guides/ios/rendering-issues/inconsistent-labels/"
md_url: "https://www.nutrient.io/guides/ios/rendering-issues/inconsistent-labels.md"
last_updated: "2026-05-15T19:10:05.040Z"
description: "Discover effective solutions for fixing inconsistent labels in rendering issues. Improve your user experience with our comprehensive troubleshooting guide."
---

The PDF spec supports a feature called [page labels](http://www.w3.org/TR/WCAG20-TECHS/PDF17). This feature allows you to customize the page label displayed, which might be different than the logical (one-based) page label. Nutrient will properly parse this additional information and display the custom page label next to the logical page label, if found.

Custom page labels can be roman letters, strings, or simply numbers with a different offset. Sometimes the initial pages start with roman letters, and the page numbers then start later to match the page numbering in the document.

This perfectly matches Adobe Acrobat’s behavior.

Disable this feature by setting [`arePageLabelsEnabled`](https://www.nutrient.io/api/ios/documentation/pspdfkit/document/arepagelabelsenabled) to `NO`.

Access these custom page labels via [`pageLabelForPage(at:substituteWithPlainLabel:)`](https://www.nutrient.io/api/ios/documentation/pspdfkit/document/pagelabelforpage(at:substitutewithplainlabel:)).
---

## Related pages

- [A Graywhiteblack Page Is Rendered](/guides/ios/rendering-issues/a-graywhiteblack-page-is-rendered.md)
- [In Adobe Acrobat Hyperlinks Are Clickable But In Pspdfkit Some Or All Of Them Are Not Marked As Touchable](/guides/ios/rendering-issues/in-adobe-acrobat-hyperlinks-are-clickable-but-in-pspdfkit-some-or-all-of-them-are-not-marked-as-touchable.md)
- [Changing The Font Size Or Color Of Page Text](/guides/ios/customizing-pdf-pages/changing-the-font-size-or-color-of-page-text.md)
- [Understanding PDF rendering complexities](/guides/ios/troubleshooting/complexities-of-rendering-pdfs.md)
- [Fixing inconsistent font issues in PDFs](/guides/ios/rendering-issues/inconsistent-fonts.md)
- [Understanding XFA forms and their impact](/guides/ios/rendering-issues/pspdfkit-doesnt-show-the-pdf-form.md)