Ein Whitepaper liegt als PDF im Downloadbereich, dieselbe Datei steht noch einmal in einem alten Ordner und in einem Pressebereich. Eine HTML-Seite würden Sie mit einem link-Element im Kopfbereich kanonisieren. Ein PDF hat keinen solchen Kopfbereich. Für diesen Fall gibt es den Canonical im HTTP-Header: Der Server schickt die Angabe mit der Antwort, noch bevor der Inhalt der Datei beginnt. Diese Seite zeigt, wie das aussieht, wann es sinnvoll ist und wie Sie es auf Apache und nginx einrichten.
Grundlagen zum Canonical stehen im Ratgeber Canonical Tag erklärt. Was ein HTTP-Header allgemein ist, erklärt das Glossar unter HTTP-Header.
Woher die Methode stammt
Der Linktyp "canonical" ist seit April 2012 in RFC 6596 beschrieben. Dort heißt es, er bezeichne die bevorzugte Adresse unter Ressourcen mit doppeltem Inhalt [3]. Dieselbe RFC zeigt auch die Übertragung im HTTP-Header. Technische Grundlage dafür ist das Header-Feld Link, das heute in RFC 8288 geregelt ist. Es dient dazu, einen oder mehrere Links als HTTP-Header zu übertragen [4]. Ein Canonical im Header ist also dieselbe Angabe wie im HTML, nur an anderer Stelle.
So sieht die Zeile aus
In der Dokumentation steht dieses Beispiel: Der Header gehört dort zur .docx-Fassung eines Dokuments und nennt die PDF-Fassung als kanonisch [1]:
Link: <https://www.example.com/downloads/white-paper.pdf>; rel="canonical"
Die Adresse steht in spitzen Klammern, danach folgen ein Semikolon und die Angabe rel="canonical". Wie beim link-Element im HTML empfiehlt Google absolute Adressen [1]. Sie können die Zeile mit den Entwicklerwerkzeugen des Browsers im Reiter Netzwerk prüfen: Datei aufrufen, Anfrage anklicken, Antwort-Header lesen.
Noch eine Frage offen?
In der gratis Sprechstunde beantworten wir Fragen zu SEO live, jeden ersten Samstag im Monat um 18 Uhr. Oder Sie rufen einfach an.
Was Google über die Methode sagt
In der Seite "Kanonische URLs angeben" führt Google den Header als eigene Methode neben dem link-Element, Weiterleitungen und der Sitemap. Er gilt dort als starkes Signal [1]. Als Vorteile nennt Google, dass die Angabe die Seite nicht vergrößert und sich unbegrenzt viele Duplikate zuordnen lassen. Als Nachteil nennt Google den Pflegeaufwand der Zuordnungen auf großen Websites oder bei häufig wechselnden Adressen. Voraussetzung ist, dass Sie die Serverkonfiguration ändern können [1].
Eine Einschränkung steht dort ausdrücklich: "Google unterstützt diese Methode nur für Websuchergebnisse." [1] Für andere Suchbereiche sollten Sie sich also nicht darauf verlassen.
Typische Einsatzfälle
Der häufigste Fall sind PDFs, die es auch als HTML-Seite gibt. Ein Produktdatenblatt liegt als Seite im Shop und zusätzlich als PDF zum Herunterladen. Damit das PDF nicht neben der Seite in der Suche steht, verweist sein Header auf die HTML-Version. Umgekehrt kann ein PDF, das an mehreren Stellen liegt, über den Header eine seiner Kopien als Hauptadresse nennen.
Weitere Kandidaten sind Dateien, die unter mehreren Adressen ausgeliefert werden, etwa über eine eigene Download-Domain und den Hauptauftritt. Für HTML-Seiten selbst gibt es dagegen selten einen Grund, den Header zu nutzen. Das link-Element im Kopfbereich ist einfacher zu pflegen und für Redakteure im CMS sichtbar.
Einrichtung auf Apache
Auf Apache setzt das Modul mod_headers zusätzliche Header. Die Direktive Header ist in der Serverkonfiguration, im virtuellen Host, in Verzeichnisabschnitten und in der .htaccess erlaubt, sofern dort FileInfo-Überschreibungen zugelassen sind [5]. Für ein einzelnes PDF kann ein Eintrag in der .htaccess des Download-Ordners so aussehen:
<Files "white-paper.pdf">
Header set Link "<https://www.example.com/whitepaper/>; rel=\"canonical\""
</Files>
Verwenden Sie set und nicht add. Laut Apache-Dokumentation ersetzt set einen vorhandenen Header gleichen Namens, während add einen weiteren hinzufügt. Das kann zu zwei Headern mit demselben Namen führen [5]. Bei zwei Link-Headern mit unterschiedlichen Canonicals hätten Sie genau den Widerspruch, vor dem Google warnt. Testen Sie die Konfiguration vor dem Neuladen des Servers, und rufen Sie die Datei danach einmal auf, um den Header zu kontrollieren. Die Apache-Dokumentation nennt Files-Abschnitte nicht ausdrücklich als Kontext der Direktive; prüfen Sie deshalb in Ihrer Umgebung, ob der Eintrag greift.
Einrichtung auf nginx
Auf nginx übernimmt die Direktive add_header diese Aufgabe, etwa in einem location-Block für die Datei:
location = /downloads/white-paper.pdf {
add_header Link "<https://www.example.com/whitepaper/>; rel=\"canonical\"";
}
Zwei Eigenheiten sollten Sie kennen. nginx fügt den Header standardmäßig nur bei bestimmten Statuscodes hinzu, darunter 200, 301 und 304. Mit dem Parameter always kommt er bei jedem Statuscode [6]. Außerdem erbt ein location-Block die add_header-Angaben der übergeordneten Ebene nur dann, wenn er selbst keine add_header-Direktive enthält [6]. Wer im Block für das PDF den Link-Header ergänzt, verliert dort also womöglich andere Header aus der Server-Ebene, etwa Sicherheitsheader. Prüfen Sie nach der Änderung alle Header der Antwort.
Viele Dateien auf einmal
Für ein oder zwei PDFs reichen Einträge von Hand. Bei einem Downloadbereich mit Hunderten Datenblättern wird das unübersichtlich. Dann gibt es zwei Wege. Entweder liefert die Anwendung die Dateien selbst aus und setzt den Header aus ihrer Datenbank, in der für jede Datei die zugehörige Seite hinterlegt ist. Oder Sie führen in der Serverkonfiguration eine Zuordnungstabelle, aus der für jeden Dateinamen die passende Zieladresse kommt. Der erste Weg ist pflegeleichter, weil Redakteure die Zuordnung im System sehen und ändern können. Der zweite kommt ohne Programmierung aus, muss aber bei jeder neuen Datei mitgepflegt werden. Klären Sie vorher mit Ihrem Hoster, ob Sie die Serverkonfiguration überhaupt ändern dürfen. Auf vielen geteilten Servern ist nur die .htaccess zugänglich.
Fehler, die wir oft sehen
Der häufigste Fehler ist ein Widerspruch zwischen Header und HTML. Manche Server, Caching-Lösungen oder Erweiterungen setzen den Link-Header automatisch für alle Antworten, also auch für HTML-Seiten. Wenn dann im head eine andere Adresse steht, hat Google zwei verschiedene Angaben. Google weist darauf hin, dass sich bei gleichzeitiger Nutzung von HTML-Element und Header die Angaben widersprechen können, und rät generell davon ab, verschiedene kanonische URLs für dieselbe Seite anzugeben [1].
Ein zweiter Fehler sind Header, die bei einem Umzug vergessen werden. Ändert sich die Adresse der HTML-Seite, bleibt der Header in der Serverkonfiguration oft unverändert und zeigt ins Leere. Nach unserer Erfahrung gehört die Liste aller Link-Header deshalb in jede Checkliste für eine Website-Migration. Ein dritter Fehler sind relative Pfade im Header, die je nach Domain unterschiedlich aufgelöst werden.
Kontrolle in der Search Console
Ob Google die Angabe gelesen hat, zeigt das URL-Prüftool. Im Feld "Vom Nutzer angegebene kanonische URL" erscheint auch eine Angabe, die per HTTP-Header gemacht wurde [2]. Daneben steht die von Google ausgewählte kanonische URL. Ein Live-Test zeigt nur die angegebene Adresse, weil Google die eigene Wahl erst bei der Indexierung trifft [2]. Wie Sie Abweichungen systematisch suchen, beschreibt der Ratgeber Canonical-Fehler finden.
Sie möchten Ihre PDFs sauber aus der Suche halten oder gezielt hineinbringen und wissen nicht, wo Ihr Hoster die Header verwaltet? Fragen Sie in der gratis Sprechstunde. Die Umsetzung auf dem Server übernimmt SEO NW bei Bedarf im Rahmen der OnPage-Optimierung.
- Organisation Kanonische URLs angeben (doppelte URLs konsolidieren). Google Search Central. Stand 15.07.2026. abgerufen am 31.10.2026
- Organisation URL-Prüftool. Search Console-Hilfe. Stand laufend. abgerufen am 31.10.2026
- Gesetz RFC 6596: The Canonical Link Relation. IETF, M. Ohye, J. Kupke. Stand 04/2012. abgerufen am 31.10.2026
- Gesetz RFC 8288: Web Linking. IETF, M. Nottingham. Stand 10/2017. abgerufen am 31.10.2026
- Organisation Apache Module mod_headers. The Apache Software Foundation. Stand laufend. abgerufen am 31.10.2026
- Organisation Module ngx_http_headers_module. nginx. Stand laufend. abgerufen am 31.10.2026
Häufige Fragen
Wofür brauche ich einen Canonical im HTTP-Header?
Für Dateien ohne HTML-Kopf, vor allem PDFs. Dort gibt es keinen Platz für ein link-Element, der Server kann die Angabe aber mit der Antwort schicken.
Wertet Google den Header genauso wie das link-Element?
Google nennt beide Methoden starke Signale. Für den Header gilt eine Einschränkung: Google unterstützt ihn nur für Websuchergebnisse.
Kann ich Header und link-Element gleichzeitig nutzen?
Möglich ist es, aber fehleranfällig, weil sich die Angaben widersprechen können. Wenn Sie beide nutzen, müssen sie auf dieselbe Adresse zeigen.
Wie prüfe ich, ob der Header ankommt?
In den Entwicklerwerkzeugen des Browsers im Reiter Netzwerk die Antwort-Header der Datei ansehen. Ob Google die Angabe gelesen hat, zeigt das URL-Prüftool im Feld zur vom Nutzer angegebenen kanonischen URL.
Noch eine Frage offen?
In der gratis Sprechstunde beantworten wir Fragen zu SEO live, jeden ersten Samstag im Monat um 18 Uhr. Oder Sie rufen einfach an.
Zuletzt geprüft am 03.11.2026, nächste Prüfung spätestens im November 2027. Haben Sie einen Fehler entdeckt? Schreiben Sie uns.
