Download-Link öffnet PDF statt zu speichern: download und Header
Kurz gesagt: Wenn ein „Herunterladen“-Knopf auf Ihrer Website eine PDF-Preisliste oder ein Datenblatt im Browser öffnet statt es zu speichern, entscheidet nicht der Knopf allein, sondern das Zusammenspiel aus dem HTML-Attribut „download“ und der Server-Kopfzeile „Content-Disposition“. Laut MDN (abgerufen November 2026) funktioniert das download-Attribut nur für Dateien auf derselben Domain. Liegen die Dateien auf einem Speicherdienst, einem CDN oder einer anderen Subdomain, wird das Attribut ignoriert. Dann hilft nur die Kopfzeile Content-Disposition mit dem Wert „attachment“, die der Server mitschicken muss.
Warum das Verhalten so uneinheitlich wirkt
Viele Betriebe stellen Unterlagen zum Herunterladen bereit: Preislisten, Produktdatenblätter, Montageanleitungen, Offertvorlagen, Pressefotos. Auf dem eigenen Computer öffnet sich die Datei vielleicht in einem neuen Tab, auf dem Telefon einer Kundin wird sie gespeichert, bei einem Kollegen erscheint ein Dialog. Das wirkt zufällig, folgt aber Regeln.
MDN schreibt dazu, dass Browser Downloads je nach Browser, Benutzereinstellungen und weiteren Faktoren unterschiedlich behandeln. Die Nutzerin wird vielleicht gefragt, die Datei wird vielleicht automatisch gespeichert, oder sie öffnet sich in einer externen Anwendung oder im Browser. Sie können das Verhalten also beeinflussen, aber nicht vollständig erzwingen.
Ein Beispiel zur Veranschaulichung: Ein Schreiner in Luzern bietet auf seiner Website Pflegeanleitungen für Massivholzmöbel als PDF an. Die Dateien liegen seit dem Relaunch auf einem externen Speicherdienst. Seitdem öffnen sie sich im Browser, und Kundinnen finden sie später nicht mehr im Download-Ordner.
Das download-Attribut und seine Grenze
Mit dem Attribut download an einem Link teilen Sie dem Browser mit, dass er die verlinkte Datei als Download behandeln soll. Laut MDN kann das Attribut einen Dateinamen enthalten oder leer bleiben:
- Ohne Wert schlägt der Browser selbst einen Namen vor, abgeleitet aus der Kopfzeile Content-Disposition, dem letzten Teil der Adresse oder dem Dateityp.
- Mit Wert wird dieser als Dateiname vorgeschlagen. Schrägstriche werden laut MDN in Unterstriche umgewandelt, und Browser passen Zeichen an, die Dateisysteme nicht erlauben.
Die entscheidende Einschränkung steht in einem Hinweis bei MDN: Das Attribut funktioniert nur für Adressen derselben Herkunft sowie für bestimmte lokal erzeugte Dateien. Bei allen anderen Adressen wird es ignoriert, und es findet eine normale Navigation statt. Die Zielseite kann aber über Content-Disposition trotzdem einen Download veranlassen.
„Dieselbe Herkunft“ heisst: gleiches Protokoll, gleiche Domain, gleicher Port. Ein Link auf www.ihre-firma.ch zu einer Datei unter files.ihre-firma.ch ist bereits eine andere Herkunft.
Content-Disposition: die Anweisung vom Server
Die Kopfzeile Content-Disposition sagt laut MDN, ob ein Inhalt im Browser angezeigt („inline“, der Standardwert) oder als Anhang heruntergeladen werden soll („attachment“). Bei attachment zeigen die meisten Browser laut MDN einen Speichern-Dialog, vorausgefüllt mit dem angegebenen Dateinamen.
Typische Varianten laut MDN:
| Kopfzeile | Wirkung |
|---|---|
| Content-Disposition: inline | Datei wird im Browser angezeigt, wenn er das kann |
| Content-Disposition: attachment | Datei wird heruntergeladen |
| Content-Disposition: attachment; filename="Preisliste 2027.pdf" | Download mit vorgeschlagenem Namen |
| Content-Disposition: attachment; filename*=UTF-8''… | Dateiname mit Sonderzeichen in kodierter Form |
Anführungszeichen um den Dateinamen sind laut MDN nötig, sobald Leerzeichen oder Sonderzeichen vorkommen. Für Umlaute und andere Sonderzeichen gibt es die Variante filename* mit Kodierung.
Welche Lösung zu Ihrer Website passt
Dateien auf der eigenen Domain
Liegen die Dateien auf derselben Domain wie die Website, reicht oft das download-Attribut am Link. In vielen Content-Management-Systemen lässt sich das beim Link einstellen oder über ein Feld im Download-Block.
Dateien auf einem Speicherdienst oder CDN
Hier hilft das Attribut nicht. Die meisten Speicherdienste erlauben es, für einzelne Dateien oder ganze Ordner Metadaten zu setzen, darunter Content-Disposition. Fragen Sie Ihren Anbieter oder Entwickler danach. Eine Alternative ist ein kleiner Weg über die eigene Website, der die Datei mit der passenden Kopfzeile ausliefert.
Dateien, die bewusst im Browser geöffnet werden sollen
Nicht jede Datei sollte erzwungen heruntergeladen werden. Eine Speisekarte oder ein Prospekt, den man kurz ansehen will, öffnet man lieber direkt. Entscheiden Sie bewusst je Dateityp und beschriften Sie den Link passend: „Preisliste ansehen (PDF)“ oder „Preisliste herunterladen (PDF, 2 MB)“.
Den Dateinamen nicht vergessen
Ein Download mit dem Namen „file_83jd92.pdf“ hilft niemandem. Achten Sie darauf, dass der vorgeschlagene Name sprechend ist, etwa „Pflegeanleitung-Eiche-geoelt.pdf“, und den Firmennamen oder das Jahr enthält, wenn das sinnvoll ist. Das geht über den Wert des download-Attributs oder über filename in Content-Disposition.
Downloads messen und pflegen
Ob Ihre Unterlagen überhaupt genutzt werden, zeigt die Webanalyse. Viele Analysewerkzeuge erfassen Klicks auf Dateien automatisch oder lassen sich dafür einrichten. So sehen Sie, welche Preislisten oder Anleitungen gefragt sind und welche niemand öffnet. Das ist eine gute Grundlage, um veraltete Dateien auszusortieren.
Apropos veraltet: Ein Download-Bereich altert schnell. Preislisten vom Vorjahr, Datenblätter von Produkten, die es nicht mehr gibt, oder Anleitungen mit falschen Telefonnummern sorgen für Verwirrung. Legen Sie fest, wer die Dateien betreut, und prüfen Sie den Bereich mindestens einmal im Jahr. Ersetzen Sie eine Datei möglichst unter derselben Adresse, damit Links aus Mails und Offerten weiter funktionieren. Ändert sich der Dateiname, weil etwa das Jahr darin steht, richten Sie eine Weiterleitung von der alten Adresse ein.
Achten Sie auch auf die Dateigrösse. Ein PDF mit hochauflösenden Fotos kann auf dem Telefon lange laden. Eine Grössenangabe neben dem Link hilft der Kundschaft, und eine komprimierte Version für den Bildschirm reicht für die meisten Zwecke. Die hochauflösende Fassung für den Druck können Sie zusätzlich anbieten, klar beschriftet.
So testen Sie das Ergebnis
- Klicken Sie den Link in mindestens zwei Browsern auf dem Computer und auf einem Telefon an.
- Prüfen Sie in den Entwicklerwerkzeugen des Browsers im Bereich Netzwerk, welche Content-Disposition der Server tatsächlich schickt.
- Kontrollieren Sie den gespeicherten Dateinamen, besonders bei Umlauten.
- Testen Sie nach jedem Umzug von Dateien auf einen anderen Speicherort erneut.
Häufige Fragen
Kann ich das Öffnen im Browser ganz verhindern?
Nicht vollständig. MDN weist darauf hin, dass Browser je nach Einstellungen unterschiedlich reagieren. Mit attachment geben Sie eine klare Anweisung, die meisten Browser folgen ihr.
Warum funktioniert es auf dem Telefon anders?
Mobile Browser haben eigene Regeln für Downloads und zeigen PDFs oft in einem eingebauten Betrachter. Testen Sie daher immer auch mobil.
Hilft target="_blank" beim Herunterladen?
Nein. Es öffnet den Link nur in einem neuen Tab und sagt nichts darüber, ob die Datei gespeichert werden soll.
Wenn sich Ihre Unterlagen auf der Website nicht so verhalten, wie Sie es möchten, richten wir Links und Server gern mit Ihnen passend ein: Offerte anfragen.