Discussion starter: an AI search question, posted with an answer from Niraj Raut to open the thread. If you have dealt with this on a site, reply with what you saw, especially where it differs.
- AI Search
- Site Architecture
Have you seen AI assistants cite your PDFs, docs subdomain or help centre instead of the main marketing site? Did you change anything because of it?
Disclosure: Niraj Raut, who posted this answer, runs the SEO consultancy linked at the end of it.
1 reply
-
adminAdmin
It is common, and it is usually a message about the marketing site rather than a problem with the docs. Assistants retrieve passages that answer a specific prompt, and help centres, documentation and PDFs are where companies state specifics: limits, steps, prices, integrations, requirements. Marketing pages often say “powerful, flexible and secure” and leave the details for a demo. So the useful response is not to hide the docs or force citations elsewhere. It is to make sure the cited pages are accurate, current and have a sensible path to the product, and to put the same specific facts on the marketing pages where buyers expect them.
Why assistants prefer the docs
Consider a prompt like “does [product] support SSO with Okta and what plan do I need?” The help centre answers that in two sentences. The marketing site may mention “enterprise-grade security” and a pricing table with an SSO tick box. An assistant looking for a passage that directly answers the question will pick the help article. The same pattern repeats for API limits, data retention, supported file formats, regional availability and compliance standards. It is not that assistants prefer help content as a type; they prefer content that states things plainly.
When it is a problem and when it is not
Situation Problem? Why Current help articles cited for product questions Mostly not Users get accurate answers from you; the fix is conversion paths Old PDFs cited with outdated pricing or features Yes Assistants repeat stale facts as current Docs on a subdomain with no analytics or a different setup Yes, for measurement You cannot see the traffic or its value Docs cited for commercial prompts (“best tool for X”) Partly You are present, but a buyer lands on a technical page with no context Marketing pages never cited at all A signal They probably lack the specifics buyers and assistants look for What I would change
- Find out what is cited. Bing Webmaster Tools’ AI Performance report shows page-level citations for Copilot and Bing’s AI summaries. GA4’s AI Assistant channel shows landing pages for identifiable assistant traffic. Prompt tracking fills in the rest. List the top cited pages by type.
- Fix accuracy first. Every cited page should be current. Add a “last updated” date to help articles and docs, and review the most cited pages on a schedule.
- Deal with outdated PDFs. Update the ones that matter, convert important ones to HTML, and remove or replace the rest. Where an old PDF must stay available, it can be kept out of the index with an
X-Robots-Tag: noindexheader, but that also removes it from search, so reserve it for documents that are genuinely obsolete. - Add context and paths to cited docs. A short note at the top or bottom of key articles (“New to [product]? See how teams use it for X”) and consistent navigation back to the main site. Do not clutter technical pages; one clear path is enough.
- Bring specifics to the marketing site. Feature pages that state limits, supported integrations, plan requirements, compliance standards and security details in plain text. Link to the docs for depth.
- Unify measurement. Make sure the docs and help subdomains share analytics configuration and cross-domain tracking with the main site, so sign-ups that start from a help article are attributed.
Watch for this:
Blocking docs or help pages from crawlers to push assistants towards marketing pages usually backfires. The assistant does not switch to your marketing page; it switches to a third-party page, a forum thread or a competitor that states the fact clearly. You lose the citation entirely.
Hypothetical example:
A data platform finds that assistants cite its help centre far more than its product pages, and that a 2022 PDF datasheet is still cited for pricing that changed a year ago. The team updates the datasheet as an HTML page, adds a redirect from the old PDF URL to it, adds “last reviewed” dates to the fifty most-cited help articles, and rewrites five feature pages to include the specific limits and integration details that help articles had been supplying. It also fixes cross-domain tracking so help centre visitors who later sign up are attributed. Within a quarter, assistants stop quoting the old pricing, feature pages begin to appear among cited sources for comparison prompts, and the team can finally see how many sign-ups start in the docs.
What the pattern tells you about content strategy
If assistants consistently prefer your docs, buyers probably do too once they are serious. That is evidence for a content approach in which marketing pages are more specific and more honest about capabilities and limits. It also suggests treating documentation as a first-class part of the site: well structured, crawlable, maintained and measured, rather than something managed by a separate team with different standards. Many B2B buyers never read the homepage; they read the docs page an assistant or search engine sent them to.
Keep PDFs in their place
PDFs remain useful for documents people want to download or print, such as datasheets, compliance reports and contracts. The risk is that they are harder to update and easy to forget, and they carry no navigation back to the site. For anything that changes, such as pricing, features or policies, publish the canonical version as an HTML page and treat the PDF as a download of that page. Then an assistant that cites the PDF is at least citing something you still maintain.
Being cited from your docs is a good problem. Keep those pages accurate and connected to the product, retire stale PDFs, bring the same specifics onto marketing pages, and measure the docs as part of the site rather than as a separate world.
Need help with this on your own site?
Niraj Raut works with businesses in Nepal, Australia, the UK, Europe and the US on technical SEO, ecommerce SEO, local SEO and AI search.
Add a reply Cancel reply
Replies are open to approved members. Log in or apply to join.