# UsePdfDocumentOptions reference

Options for `usePdfDocument`. Changes apply on the next load, except `password`.

## Used by

- [Headless](https://react-pdf-viewer-chi.vercel.app/react-pdf-viewer/headless.md)

## Import

```ts
import type { UsePdfDocumentOptions } from '@kingtech/react-pdf-viewer';
```

## Properties

| Name | Type | Default | Required | Description |
| --- | --- | --- | --- | --- |
| `password` | `string` | — | No | Password for encrypted documents. Changing it reloads the document. |
| `pdfjsOptions` | `PdfJsDocumentOptions` | — | No | Per-instance `getDocument` overrides. |
| `onLoad` | `(document: PDFDocumentProxy) => void` | — | No | The document is ready. |
| `onError` | `(error: PdfViewerError) => void` | — | No | Every load failure except aborts and handled HTTP errors. |
| `requestInit` | `RequestInit` | — | No | As on `PdfViewer`. |
| `fetcher` | `(url: string, init: RequestInit) => Promise<Response>` | — | No | As on `PdfViewer`. |
| `onHttpError` | `(response: Response) => boolean \| void \| Promise<boolean \| void>` | — | No | As on `PdfViewer`. |
| `getHttpErrorMessage` | `(response: Response) => Promise<string>` | — | No | As on `PdfViewer`. |

## Source

[packages/react-pdf-viewer/src/hooks/usePdfDocument.ts](https://github.com/kiralygyula92/react-pdf-viewer/blob/main/packages/react-pdf-viewer/src/hooks/usePdfDocument.ts#L16)