Answers
Document performance

How to make a
PDF-heavy site fast

Make a PDF-heavy site fast by treating it as two separate problems: the pages that list and filter the documents, which is where measurable slowness usually sits, and the documents themselves, where a minority of oversized files account for most of the download weight. Fixing the second without the first rarely changes what a visitor experiences.

On an industrial site the library is typically thousands of datasheets, installation and maintenance manuals, declarations of conformity, safety data sheets and CAD files, spanning current and superseded products across several languages. Much of what is reported as slowness is a specifying engineer unable to reach the one revision they need.

In detail

What is slow, and what is hard to find

Measure before deciding what to fix

Run field and lab measurements on the library index, a filtered result view and a product page that lists its documents. Those three templates behave differently, and an average across the site hides which one is causing the complaint.

Check the server logs alongside them. Requests concentrated on a small number of documents change the priority order considerably compared with treating the whole archive as equally urgent.

The listing pages are usually the slow part

Document libraries commonly render every row at once, generate preview thumbnails on request, and run filter queries against columns with no index. A page listing several thousand documents is slow because of the page, not because of the files it points at.

Paginate or virtualise the list, precompute thumbnails, index the fields the filters query, and cache the common filter combinations. This is generally where the largest measurable gain sits.

Optimise the documents that carry the weight

A minority of files usually account for most of the download volume: scanned legacy manuals held as images, datasheets exported from CAD with embedded high-resolution artwork, and catalogues assembled from print artwork without downsampling.

Downsample embedded images to a screen-appropriate resolution, subset fonts, and linearise the file so a reader can display the first page before the whole document has transferred.

Serve them from the right place

Deliver documents through a CDN with long cache lifetimes and range requests enabled, rather than from the origin server on every request. For a library serving distributors and specifiers across several regions, the distance saved is often larger than anything compression achieves.

See website performance for how delivery and template work are diagnosed together.

Findability is the problem behind most complaints

Holding product, part number, document type, language, market and revision as structured data rather than encoding them in a filename lets a visitor filter to the one file they need. Without it the library is a long list that has to be read.

See technical documentation portals for how that data model is built and kept current.

Check the things speed tools do not report

An untagged PDF is unreadable to a screen reader even where the surrounding site passes its accessibility checks, and a scanned manual without a text layer cannot be searched by a visitor or indexed by a search engine.

Run OCR across the scanned archive and tag the documents that matter most to buyers. Website accessibility covers how documents are assessed alongside templates.

Document library questions

How do you make a PDF-heavy site fast?

Start with the pages that list and filter the documents, since unpaginated lists, thumbnails generated on request and unindexed filter queries account for most measurable slowness. Then compress and linearise the minority of files carrying real weight, and serve everything through a CDN with long cache lifetimes. Measure each template separately before choosing.

Do PDFs slow down the pages that link to them?

Not directly, since a linked document is downloaded only when requested and does not block the page from rendering. What does slow a page is the library index around the links: rendering thousands of rows, producing previews on the fly, and running filter queries the database has no index for. That is where the measurement usually points.

Does the number of documents matter?

Less than how they are stored, queried and delivered. Several thousand well-indexed documents behind a paginated, cached library and served from a CDN perform better than a few hundred listed on one page and served from the origin. Volume becomes a problem when the data model cannot support filtering rather than at a particular file count.

Which documents should be optimised first?

The ones being requested. Server logs show which datasheets and manuals visitors and crawlers download, and that ranking rarely matches where files sit in the navigation. Scanned legacy manuals and catalogues exported from print artwork tend to be the largest, so they usually appear near the top of both lists.

Should documents be tagged for accessibility?

Where they form part of the information a buyer needs, yes, and it is frequently the larger gap. An untagged PDF is unreadable to a screen reader even where the website around it passes every automated check. Scope the work by starting with current product documentation rather than attempting the full archive at once.

What about scanned legacy manuals?

Run OCR to add a text layer, which makes them searchable by visitors and readable by search engines, then downsample the page images. For equipment still in service this often has more commercial value than the file size saving, because it is how an installer or maintenance engineer finds documentation for a machine that is no longer sold.

Document performance

Fix your document
library properly

Tell us what you have and we will establish whether it is a speed problem or a findability one.

contact us
Contact Form

Tell us
about your project

Tell us about your organization's context and the planned scope of the project.
Code Industrial, as the data controller, will process your data in order to respond to the query and/or request you submit through this contact form. Privacy Policy.
Our site uses cookies to collect information about your device and browsing activity. We use this data to improve the site, ensure security and deliver personalized content. You can manage your cookie preferences by clicking here.
Basic cookie information
This website uses cookies and/or similar technologies that store and retrieve information when you browse. In general, these technologies can serve very different purposes, such as, for example, recognizing you as a user, obtaining information about your browsing habits or personalizing the way in which the content is displayed. The specific uses we make of these technologies are described below. By default, all cookies are disabled, except for technical ones, which are necessary for the website to function. If you wish to obtain more information or exercise your data protection rights, you can consult our Cookie Policy".
Technical cookies needed Always active
Technical cookies are strictly necessary for our website to work and for you to navigate through it. These types of cookies are those that, for example, allow us to identify you, give you access to certain restricted parts of the page if necessary, or remember different options or services already selected by you, such as your privacy preferences. Therefore, they are activated by default, your authorization is not necessary.Through the configuration of your browser, you can block or alert the presence of this type of cookies, although such blocking will affect the proper functioning of the different functionalities of our website.
Analytics cookies
Analytics cookies are used to analyse website behaviour anonymously. They help us measure activity and improve the website.
Title
Popupcontent
Contact us
Code Industrial, as the data controller, will process your data in order to respond to the query and/or request you submit through this contact form. Privacy Policy.
Aceptar