HTTP headers
noindex
Files and PDFs

X-Robots-Tag: Indexing also for files targeted control

The X-Robots tag is the header variant of robots instructions such as noindex. It is especially useful for files that are not HTML-<head> have – for example PDFs, image files or other documents.

Briefly explained • Last updated: 30.03.2026 • Reading time: about 2 minutes.

How the X-Robots tag works, when it makes sense and which configurations are often set incorrectly. This wiki page arranges the topic practically and shows, When priority arises, which mistakes are often and how you derive concrete measures from them.

Example: A server header overwrites the intended release

In the HTML of a page is index,follow, but the HTTP response contains X-Robots tag: noindex. Check the headers of the final destination URL and the rules of the web server, CDN or application. A correction only in the CMS text field does not eliminate the header.

The header is also suitable for PDF files and other documents without an HTML head. Control specific paths and response types after a rule change. Noindex controls indexing, but it does not replace access protection or the testing of actual search engine processing.

When X-Robots Make Sense

Whenever you cannot set indexing rules or cannot set them cleanly in the HTML.

PDFs and documents

Especially downloads, whitepapers or media files can be controlled significantly more reliably by header.

Server-side rules

Recurring file types or path patterns can be controlled centrally at the web server or CDN level.

Alternative to Meta Tag

For HTML pages, X-Robots can also work, but in practice the Meta Robots tag is often more easily visible and faster debuggable.

Frequent errors in practice

With the X-Robots tag, the problem is rarely in the idea, but in the lack of transparency.

  • Headers only on some responses: For example, not on final redirect targets.
  • Contradiction to Meta Robots: Different signals make diagnosis and prioritization difficult.
  • Only files checked, not templates: PDFs or image URLs inherit nothing automatically.
  • No visibility in the frontend: Teams overlook the header because it is not directly in the source code.

Fast checks

These tests are particularly helpful.

View response headers

Always check the final answer, not just the source URL or the CMS template.

File types go through

Which PDFs, documents or media files should really be indexable – and which ones should not?

Standardising signals

Meta Robots, X-Robots, Canonical and Status Code should support the same intention.

FAQ

Use short answers to typical practical questions about x-robots-tag correctly.

When do I use X-Robots instead of Meta Robots?

In particular, non-HTML files like PDFs or if rules are to be set centrally at the server level.

Can X-Robots set noindex?

Yes. The effect corresponds to a noindex per meta tag, except that the statement is sent in the HTTP header.

Should I set Meta Robots and X-Robots at the same time?

Only if this happens consciously and consistently. Contradictions make debugging difficult and can create unnecessary confusion.

Additional terms