Documents · PDF Toolkit
Rotating PDF Pages in the Browser: Metadata Flag or Redrawn Content?
· How it works
pdf rotation page-geometry
A PDF page can be rotated in two very different ways: by setting a flag the viewer obeys, or by transforming the drawing instructions themselves. This post explains both, what each means for the file, and how to check which one you got.
Rotated on screen, sideways in the attachment — why a viewer's rotate button often changes nothing in the file you send
A viewer rotation button can make a receipt readable for the current session while the attachment still opens sideways for everybody else. That control may change only display state. A durable correction must be written into a downloaded PDF, which is why the toolkit saves a fresh file rather than changing the browser view alone.
ToolAcre offers 90 degrees clockwise, 180 degrees, or 270 degrees, applied to every page or only named physical positions. The input must be unencrypted and no larger than 50 MB. The original remains untouched, allowing a bookkeeper to compare the corrected file before replacing any working copy.
The rotation flag — how a page can carry an instruction of 0, 90, 180 or 270 degrees that every conforming viewer applies at display time
Each selected page has a rotation angle that viewers apply while drawing it. The worker reads the current value, adds the requested quarter turn, and normalizes the sum to 0, 90, 180, or 270. Applying 90 to a page already at 90 therefore stores 180 rather than resetting it to 90.
That additive behavior is the central operational detail. A second run adds another turn, so repeating a job can turn a correct page upside down. The page list is validated against the real count, and a blank list means all pages. Nothing guesses which sheets appear sideways.
This tool does not bake rotation into content or swap page boxes
The outline presents baking rotation as an alternative, but this route does not perform it. It never transforms the page content stream, swaps stored page dimensions, or redraws the scan. Only the page rotation value changes, leaving boxes and drawing instructions as they were in the input.
Consequently, this tool cannot straighten a scan tilted by three degrees or rotate one picture inside an otherwise correct page. Those tasks require image or content transformation. Here the supported operation is deliberately constrained to whole-page multiples of ninety, which pdf-lib can write without re-encoding the page.
What each approach means for text selection, printing and later edits — and why a flag is usually reversible and lossless
Because content is not rasterized, text remains selectable and searchable, vector edges remain vectors, and embedded images retain their data. Printing and later viewing should obey the saved orientation value. The change is reversible by adding another valid quarter turn, though there is no absolute “set every page to zero” control.
Page dimensions are not swapped in storage. Orientation emerges from dimensions and the viewer-applied rotation together. A program that ignores `/Rotate` could therefore describe geometry differently, but normal PDF viewers apply it. Always check the downloaded copy in the software used by the eventual recipient or printer.
Whole document or specific pages — why a file where only the landscape tables are sideways needs per-page thinking, and where the tool page documents its options
Mixed documents need selective input. If portrait invoices are correct but landscape tables arrive sideways, enter only those physical page numbers. Leaving the box empty rotates everything and can break pages that were already upright. The range syntax accepts a single number, inclusive spans, comma lists, and an open-ended final range.
Remember that the requested turn is relative to each page’s current state. Two selected pages can start with different values and finish with different values after receiving the same addition. For complicated mixtures, perform separate passes with distinct selections, opening each result before applying another change.
Worked example — fixing a set of phone-scanned receipts where every other page is upside down
Imagine ten phone-scanned receipts where pages 2, 4, 6, 8, and 10 are upside down. Choose 180 degrees and enter those positions. The worker validates the indices, adds 180 to each existing rotation, serializes once, and returns a file named with the `-rotated.pdf` suffix.
Review all ten pages, not just the selected five. A phone gallery may have displayed source images using metadata that was not represented as expected after scanning. If one page still appears wrong, determine its current orientation and add the required turn only to that page instead of rerunning the whole set.
What this does not cover — deskewing slightly tilted scans, which is an image-processing job rather than a page rotation
Quarter-turn metadata cannot deskew a page, remove perspective from a phone photograph, improve focus, or recognize text. It also cannot turn an embedded image independently. Password-protected files stop with a protected-document error, and saving any edited copy invalidates an existing digital signature over the original bytes.
The operation does not compress the document or make it materially smaller. Since page streams are untouched, size should remain broadly similar, although fresh serialization means byte-for-byte identity is not expected. Use scanner deskew or an image editor before PDF assembly when the defect is more subtle than sideways orientation.
Saving additive /Rotate values makes the correction persistent without redrawing
Permanent here means the downloaded file contains updated additive `/Rotate` values that conforming viewers use. It does not mean the pixels were turned or page boxes rewritten. This distinction explains both the lossless result and the restriction to 0, 90, 180, and 270-degree states.
The transformation runs through pdf-lib in a Web Worker and no document bytes are uploaded. Consented production analytics is separate and excludes filenames and contents from ToolAcre events. Select pages carefully, remember that every pass adds to existing rotation, and preserve the original until the corrected file has been reviewed. A concise handoff note should name the pages and turn applied so another reviewer can distinguish intended metadata from an accidental second pass. Record the output name.