How to Organize and View PDF Reference Files Locally

To organize PDF reference files locally, enable Documents for a refern workspace, let the app create first-page grid previews, and add the tags or ratings that fit your project. Open any indexed PDF inside refern for continuous scrolling, embedded-text search, selection and copy, print, page controls, view rotation, and zoom.

Reference libraries rarely contain images alone. A visual development folder may also hold art books, client briefs, style guides, research papers, pattern sheets, scanned notes, or architectural specifications. Splitting those documents into a separate reader makes the library harder to browse and disconnects them from the images they support.

refern keeps PDFs beside the rest of a project without moving them into a private cloud or proprietary library. This guide shows how to enable PDF indexing, make documents easy to recognize in the grid, search them accurately, and understand the limits of the built-in viewer.

Before you start

PDFs are optional workspace content in refern. A new workspace indexes images and video by default, so you must enable Documents, add .pdf as a custom extension, or choose all files before PDFs appear. This choice belongs to the workspace and can be changed later.

Decide which folder should hold the documents. You can use a dedicated Documents folder inside an existing reference workspace, keep PDFs beside related images, or add another content root from a different drive. The files remain ordinary files at their existing locations.

The PDF viewer does not replace a document editor. It is designed for reading and reference work. Rotation changes the current view but does not modify the original document. Search and selection use text already embedded in the PDF. Scanned image-only pages are not processed with OCR.

If this is your first library, start with the first reference workspace guide before adding document categories.

Step 1: Enable PDF indexing for the workspace

Open the workspace settings and enable Documents under the file types shown. This adds PDF and other document extensions to the workspace policy. For a narrower library, add .pdf as a custom extension instead of enabling the complete Documents category.

For a new workspace, choose the file types during setup. For an existing workspace, open the workspace selector, edit the workspace, and change its file types shown. You have three practical choices:

1. Enable Documents when you keep PDFs with text files, presentations, spreadsheets, or ebooks.
2. Add .pdf as a custom extension when PDFs are the only extra document type you want.
3. Enable all files when the workspace is a complete project archive and every working file should remain visible.

After you save the policy, refern scans the workspace again. Existing PDFs enter the library without being copied or moved.

Step 2: Let first-page previews finish

Each indexed PDF enters the thumbnail queue. refern renders its first page as the grid preview, which makes a document recognizable beside images and video. The preview may appear shortly after the file itself enters the grid.

A new PDF can briefly show its file icon while thumbnail generation is still running. This is normal. The first-page preview replaces that temporary state after generation finishes.

Choose files with useful cover pages when you control the document. A clear title, project name, or large illustration makes the grid easier to scan. If the first page is not useful, assign a custom cover image from the metadata sidebar or file menu.

You can also change the grid-thumbnail matte to Default, Transparent, or a custom color. The matte changes only how the tile looks in refern. It does not alter the PDF or its generated preview.

Step 3: Organize PDFs with the rest of the project

Use folders for project structure and metadata for connections that cross folders. PDFs can receive tags, ratings, favorites, descriptions, source details, creator information, and custom metadata just like other indexed files.

A compact folder structure is usually enough:

• Project / Briefs for requirements and client documents
• Project / Research for papers, articles, and visual studies
• Project / Style guides for typography, color, and brand systems
• Project / Deliverables for final presentation documents

Tags add the relationships that folders cannot express. A document in Research might also use architecture, lighting, and materials. A style guide might use the same project and client tags as its image references.

Smart folders can collect those documents without moving them. Save ext:pdf rating:>=4 for important PDFs, or combine ext:pdf with a project tag. Saved smart folders can be nested into an organizational tree, reordered or reparented by dragging, and stored with the workspace. Each child is still its own saved search, so nesting does not make it inherit the parent's rules.

For more examples, see how to create smart folders and how to search with operators.

Step 4: Find PDFs from the library

Use ext:pdf when you need only PDF files. Library search matches PDF filenames and metadata you add in refern. It does not index the complete document text into the workspace search database.

Useful searches include:

• ext:pdf to show every indexed PDF
• ext:pdf tag:materials to find documents with a particular tag
• ext:pdf rating:>=4 to find your most useful documents
• ext:pdf sort:name to browse them in natural numeric order, with guide2.pdf before guide10.pdf

Do not use type:document when you mean only PDFs. Document and file aliases resolve to the generic file category, so they can include other opt-in file types. The exact extension operator is the precise filter.

Step 5: Read and search inside a PDF

Double-click an indexed PDF to open the native viewer. It supports continuous page scrolling, page navigation, zoom, fit-to-width, clockwise view rotation, print, opening in the default system app, and search within embedded document text.

Use the page controls to move directly to a numbered page or scroll through the document continuously. Zoom with the slider or wheel controls. Search highlights matching embedded text in the open document. You can select and copy that text when the PDF exposes it.

The viewer does not include a separate page-thumbnail sidebar. The grid preview represents the first page, while the open viewer uses continuous pages and direct page controls.

Printing is available from the normal viewer. If a PDF is open in a separate pop-out window and Print is not shown, return to the main viewer first. Password-protected or damaged PDFs may fail to open, in which case use the default system application.

Common PDF problems and fixes

Most missing PDFs come from workspace policy, unfinished thumbnail work, or documents without embedded text. Check those three conditions before rebuilding a workspace or replacing a file.

The PDF does not appear in the library

Edit the workspace and confirm that Documents, .pdf, or all files is enabled. Then run a workspace resync. A PDF outside every configured content root will not appear until that folder is added to the workspace.

The tile still shows a file icon

Wait for thumbnail generation to finish. If the queue is complete and the icon remains, verify that the PDF opens in another reader. Damaged or password-protected documents may not produce a preview.

Search finds nothing inside the open PDF

The page may be a scan or flattened image without embedded text. You can still browse it visually, but refern does not run OCR. Add a useful filename, description, and tags so the document remains discoverable from the library.

Rotation returns to the original orientation

Viewer rotation is temporary. It changes the current reading view and does not rewrite the PDF. Use a document editor when you need to save a new orientation.

Next steps

PDFs work best when they share the same project vocabulary as your images. Add a small set of tags, save one or two useful smart folders, and keep filenames descriptive enough for library search. Graphic designers can find a broader mixed-format workflow in the graphic design asset library guide.