Merge PDF pages

Arrange pages in your browser

Open the PDF merge playground

Add local PDFs and arrange source blocks in output order. Leave Pages empty to include every page, or enter one-based page numbers and inclusive ranges such as 5,2-4 or 3-1,1. Descending ranges and repeats are supported. Duplicate a block, choose another selection, and move it to insert pages from that PDF elsewhere. Passwords unlock the corresponding source. Choose the output filename and download a new PDF.

All processing happens in browser memory. Input files stay unchanged. The CLI and browser use the same page-selection parser and merge API.

Use the CLI

tumbler first.pdf pdf merge --pages 3,1-2,1 \
  --source second.pdf --pages 2-1 \
  --source first.pdf --pages 4 --output merged.pdf

The first file starts the first block. Each --source starts another block. --pages and --password apply to the most recent source. Omit --pages to include all its pages. Repeat a source to interleave its pages with another document. The output must be a new .pdf file; an existing destination is never overwritten.

Use the shared API

import { mergePdfDocuments, openPdfDocument, parsePdfPageSelection } from '@tumblerjs/pdf';

const first = openPdfDocument(firstBytes);
const second = openPdfDocument(secondBytes, { password: 'source-password' });
const output = mergePdfDocuments([
  { document: first, pages: parsePdfPageSelection('3,1-2,1', first.pages.length) },
  { document: second, pages: [1, 0] },
  { document: first, pages: [3] },
]);

API page indices are zero-based. The parser accepts the same one-based selections as the CLI and graphical tool. Omit pages to include the full document. Save the returned Uint8Array as a new PDF.

Embed the graphical tool

<script>
  import { PdfMerge } from '@tumblerjs/svelte/pdf';
</script>

<PdfMerge />

The default action downloads the completed PDF. Pass onmerge={(bytes, filename) => save(bytes, filename)} to handle the output yourself. The component includes file selection, source passwords, page selection, block ordering, duplication, removal, and output naming.

Content preservation

Merging copies PDF page objects and their resources rather than rasterizing or reconstructing the visible text. Page dimensions, rotation, content streams, embedded fonts and images stay in PDF form. The output is a fresh, unencrypted document. Encryption passwords authenticate the sources; they do not encrypt the result. Digital signatures cannot authenticate a newly merged document.