Publish a report as two connected assets
Treat the HTML landing page and downloadable document as a coordinated evidence package. The landing page should explain the central findings, authors, methodology, publication date, coverage period, and citation format. The PDF should contain the complete research and remain accessible through a stable direct URL.
Do not place the only useful findings inside an embedded viewer. Publish meaningful text in HTML so it can be linked, indexed, and understood without executing a complex document interface.
Test document access
- The direct PDF URL returns HTTP 200 without authentication or a bot challenge.
- The response uses the correct PDF content type and a stable filename.
- The document contains selectable text; scanned pages have accurate OCR.
- The file is linked from an indexable HTML page with descriptive anchor text.
- The PDF and landing page identify the same title, publisher, authors, and date.
Design findings for retrieval
Give each headline finding a descriptive heading, a complete statement, the measured population, period, unit, and a pointer to the method or source table. Tables should have real text, labelled columns, units, notes, and sources rather than being exported as images.
Use stable figure and table labels. “Table 4: Adoption by company size, 2024–2026” is more useful than “Results”. Include the denominator and explain missing values where they could change interpretation.
Make the methodology citable
A methodology page should state who collected the data, how participants or records were selected, when collection occurred, the sample size, weighting, exclusions, definitions, limitations, and contact or correction route. If the dataset can be released, give it a stable URL and an explicit licence.
Connect metadata and visible copy
Use an accurate title and description, self-referential canonical, visible authorship, and publication dates. Where appropriate, describe the page with Article, Report, Dataset, or other relevant structured data, but only when the visible page supports those facts.
Provide a preferred citation
A short citation block reduces ambiguity: organisation, author, report title, edition or year, publisher, date, canonical landing-page URL, and document identifier if one exists. The block helps journalists and researchers as much as automated systems.
The scanned-document problem
A large share of the most authoritative material on the web — government reports, clinical guidance, standards documents, archived research — exists only as scanned images inside a PDF wrapper. To a text extractor these files are empty. The document has a title, a file size, and no content whatsoever.
This is the single largest evidence gap in most institutional publishing, and it is invisible from the inside because the file opens perfectly well on a human's screen. The test is trivial: open the PDF, try to select a sentence with your cursor. If nothing highlights, the page is a photograph and no engine can read a word of it.
There are three remedies, in descending order of quality. Best is to publish an HTML version of the document alongside the PDF — genuinely accessible, indexable, linkable at section level, and useful to screen-reader users for the same reasons. Next is to run OCR and embed a corrected text layer, which preserves the original layout while making the content extractable. Weakest, but far better than nothing, is a substantial HTML summary page carrying the key findings, figures and conclusions with a link to the full PDF.
Whichever you choose, check the result rather than assuming it worked. Automated OCR on a low-contrast scan or a multi-column layout routinely produces text that is technically extractable and semantically scrambled — column fragments interleaved, figures detached from captions, decimal points lost. Scrambled text can be worse than none, because it gets cited.
Structuring a long document for retrieval
A hundred-page report will never be retrieved whole. It will be retrieved in fragments, and the question is whether those fragments are useful.
Give every substantive section a stable anchor so it can be linked and cited at section level rather than document level. Front-load an executive summary that states the findings rather than describing the document's structure — “this report examines the relationship between X and Y” tells a retrieval system nothing, whereas “X increased by 12% between 2024 and 2026, concentrated in three sectors” is directly usable.
Keep tables as HTML wherever the document lives on the web. A table rendered as an image is the most reliable way to make your best data unusable. Where a figure genuinely must be an image, repeat the key values in the caption or in adjacent body text.
Finally, state the methodology and the limitations in their own sections. Beyond being good practice, these are exactly the passages an engine reaches for when a user asks how a finding was produced or whether it applies to their situation — questions that carry high commercial intent.
Publishing the data behind the report
Research that shows its working is cited more readily than research that asserts a conclusion, and the mechanism is straightforward: a source that can be checked is a lower-risk citation than one that cannot.
Where licensing allows, publish the underlying dataset as CSV or JSON at a stable URL, alongside a plain description of how it was collected, what the columns mean, and what it excludes. A spreadsheet with unlabelled headers and no collection note is not open data; it is a file. Describe it with Dataset structured data so the relationship between the report and its evidence is machine-readable rather than implied by page proximity.
Version the data rather than overwriting it. Analyses that cited your 2025 figures should continue to resolve to the 2025 figures, with a clear pointer to the current release. Silently replacing numbers under a stable URL breaks every citation that depended on them and is the fastest way to make your research untrustworthy to anyone checking it later.
Finally, state the limitations in the document rather than leaving them to be inferred. Sample size, collection window, known biases, and the questions the data cannot answer are precisely the passages an engine reaches for when a user asks whether a finding applies to their situation — and those questions carry high intent.
Monitor the evidence package
The same structural checks that apply to a web page apply here — the 30-signal audit checklist covers both. Track the HTML page and PDF separately. Record crawl status, canonical URL, extracted word count, OCR confidence when relevant, outbound sources, internal links, live citations, and referring pages. A PDF can receive visibility while the landing page does not, or the reverse.
If a report is image-only, publish corrected OCR or an accessible HTML summary before promoting it. Evidence that cannot be read cannot reliably support an answer.
Primary references
Common questions
Should I publish reports as PDF or HTML?+
Publish both, with HTML as the canonical version. PDF preserves layout and remains what many readers want to download and cite; HTML is what is reliably crawlable, linkable at section level, and accessible. Treating the PDF as the only artefact is the most common way authoritative research becomes invisible.
How do I tell whether my PDF is machine-readable?+
Open it and try to select a sentence with your cursor. If nothing highlights, the page is an image and contains no extractable text. This takes five seconds and catches the single largest evidence gap in institutional publishing.
Is automated OCR good enough?+
Sometimes, and it needs checking rather than assuming. OCR on low-contrast scans, multi-column layouts or tables routinely produces text that is extractable and semantically scrambled — interleaved columns, detached captions, lost decimal points. Scrambled text can be worse than none, because it gets cited.
Do figures and charts need alt text?+
Yes, and alt text alone is rarely sufficient for data. If a chart carries a finding, state the key values in the caption or in adjacent body text. Alt text serves accessibility well; a number that exists only inside an image is unavailable to any text-based system.
How should I handle paywalled or gated research?+
Publish a substantive open summary carrying the findings, methodology and limitations, with the full document gated. A gated PDF is invisible to every crawler, so the choice is not between protecting and sharing the work — it is between being citable for the summary or not being citable at all.
Does document age matter?+
Considerably, and more than most authors expect. An engine choosing between sources discounts material that cannot demonstrate currency. Publish a visible date, state the period the research covers, and record when figures were last verified — undated research loses comparisons it deserves to win.