> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/websites-und-leadgewinnung/websites-und-funnels/dateien-per-button-oder-bild-zum-download-bereitstellen.md). # Dateien per Button oder Bild zum Download bereitstellen Verknüpfe eine geprüfte Datei mit einem Button, Bild oder einer SVG-Grafik, damit Besucherinnen und Besucher sie direkt und verständlich herunterladen können. Mit der Download-Aktion stellst du Dateien direkt auf einer Website oder in einem Funnel bereit. Klickt jemand auf einen passenden Button, ein Bild oder eine SVG-Grafik, startet der Download sofort. Das eignet sich zum Beispiel für Checklisten, Broschüren, Vorlagen, Bilder oder gebündelte Unterlagen. Die Funktion leitet nicht auf eine andere Seite weiter und zeigt keine Dateivorschau an. Sie liefert eine zuvor ausgewählte Datei direkt aus der Medienbibliothek. ## Was du vor dem Einrichten wissen solltest | Frage | Belegte Antwort | Was das für dich bedeutet | | -------------------------------------------------------- | -------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | | Welche Elemente können einen Download starten? | Button, Bild und SVG-Grafik. | Wähle das Element, das auf der Seite am klarsten erklärt, was heruntergeladen wird. | | Wie viele Dateien kann ein Element bereitstellen? | Genau eine Datei. | Für mehrere Unterlagen bündelst du sie vorher in einer ZIP-Datei. | | Wo muss die Datei liegen? | In der Medienbibliothek. | Wähle sie über die Dateiauswahl aus oder lade sie dort hoch. | | Welche Dateitypen sind möglich? | Alle Formate, die die Dateiauswahl annimmt, etwa PDF, Bild, Audio, Video, Dokument oder ZIP. | Prüfe vorab, ob Dateiart und Größe in der Medienbibliothek akzeptiert werden. | | Wird die Datei im Browser geöffnet? | Nein, sie wird direkt heruntergeladen. | Für eine Ansicht im Browser verwendest du stattdessen eine Adresse, die in einem neuen Tab geöffnet wird. | | Kann ein Download eine dynamische Zieladresse verwenden? | Nein, es wird eine fest ausgewählte Datei verknüpft. | Wähle die endgültige Datei bewusst aus und teste sie nach jeder Änderung erneut. | > **Wichtig:** Ersetze oder lösche keine verknüpfte Datei, ohne alle betroffenen Downloads zu testen. Laut Quelle können gespeicherte Verknüpfungen dadurch nicht mehr funktionieren. ## Datei vorbereiten Bevor du die Aktion einrichtest, prüfe die Datei selbst: 1. Öffne die endgültige Fassung auf deinem Gerät. 2. Prüfe Inhalt, Dateigröße und Dateiendung. 3. Verwende einen verständlichen Dateinamen, zum Beispiel `Checkliste-Website-Start.pdf` statt `final_v7_neu.pdf`. 4. Lade die Datei in die Medienbibliothek hoch oder halte sie für die Auswahl bereit. 5. Entscheide, welches Element den Download auslösen soll. Der sichtbare Auslöser muss den Inhalt eindeutig nennen. Ein Button wie **Checkliste herunterladen (PDF)** ist verständlicher als **Hier klicken**. Bei einem Bild oder einer SVG-Grafik sollte der umgebende Text ebenfalls erklären, welche Datei heruntergeladen wird. ## Download mit einem Button einrichten Ein Button ist passend, wenn der Download eine klare nächste Handlung auf der Seite sein soll. 1. Öffne **Websites und Leadgewinnung** und danach die gewünschte Website oder den gewünschten Funnel. 2. Öffne die betroffene Seite oder den gewünschten Funnel-Schritt im Seiteneditor. 3. Klicke den Button an. 4. Öffne in der rechten Seitenleiste **Button-Aktionen**. 5. Öffne die Auswahl **Verknüpfen mit**. 6. Wähle **Datei herunterladen**. 7. Wähle **Datei auswählen** oder **Datei verknüpfen**. 8. Öffne die Dateiauswahl und wähle eine vorhandene Datei aus der Medienbibliothek oder lade eine neue Datei hoch. 9. Trage bei Bedarf im Feld **Dateiname** den Namen ein, der beim Speichern der Datei erscheinen soll. 10. Speichere die Seite und prüfe den Download in der Vorschau. Die Quellbilder zeigen bei einer Button-Aktion die Auswahl **Verknüpfen mit**, den Wert **Datei herunterladen**, die Dateiauswahl und das Eingabefeld für den Dateinamen. Diese vier Einstellungen gehören zusammen: Erst wenn die Download-Aktion aktiv und eine Datei gewählt ist, kann der Button die Datei ausliefern. ## Download mit einem Bild einrichten Ein Bild kann ebenfalls direkt einen Download auslösen, etwa ein sichtbares Vorschaubild einer Broschüre oder ein Symbol. 1. Klicke das Bild im Seiteneditor an. 2. Öffne die rechte Seitenleiste mit den Bildeinstellungen. 3. Suche den Bereich **Bild-Aktion**. 4. Wähle **Datei herunterladen**. 5. Wähle die Datei in der Medienbibliothek aus. 6. Setze bei Bedarf den gewünschten Dateinamen. 7. Prüfe in der Vorschau, ob das Bild klar als Download erkennbar ist. Die Quelle zeigt für Bilder einen eigenen Bereich **Bild-Aktionen**. Verwende daher nicht die Einstellung eines Buttons; wähle die Aktion direkt am Bild aus. > **Tipp:** Ergänze bei einem klickbaren Bild immer einen kurzen Hinweis in der Nähe, zum Beispiel „Broschüre als PDF herunterladen“. So ist die Funktion nicht nur an der Gestaltung erkennbar. ## Download mit einer SVG-Grafik einrichten Auch eine SVG-Grafik kann eine Datei auslösen. Das ist sinnvoll, wenn ein eigenes Symbol oder eine individuell gestaltete Grafik als Download-Schaltfläche dienen soll. 1. Klicke die SVG-Grafik an. 2. Öffne ihre Einstellungen in der rechten Seitenleiste. 3. Suche die Auswahl **SVG-Aktion**. 4. Wähle **Datei herunterladen**. 5. Wähle die Datei über die Medienbibliothek aus. 6. Vergib bei Bedarf einen verständlichen Dateinamen. 7. Prüfe den Download in Vorschau und öffentlicher Fassung. Bei SVGs gilt dieselbe Grenze wie bei Buttons und Bildern: Ein Element kann genau eine fest ausgewählte Datei herunterladen. ## Dateiname und sichtbarer Auslöser Der **Dateiname** in den Einstellungen steuert, wie die Datei beim Download genannt wird. Er kann vom technischen Namen der hochgeladenen Datei abweichen. | Teil | Wofür er da ist | Beispiel | | ---------------------------------- | --------------------------------------------------------------- | ---------------------------------------- | | Sichtbarer Buttontext oder Hinweis | Erklärt auf der Seite, was Besucherinnen und Besucher erhalten. | **Vorlage herunterladen (PDF)** | | Verknüpfte Datei | Legt fest, welcher Inhalt ausgeliefert wird. | Die geprüfte PDF in der Medienbibliothek | | Dateiname | Erscheint beim Speichern auf dem Gerät. | `Planungsvorlage-2026.pdf` | Wähle Namen, die ohne technischen Hintergrund verständlich sind. Ein sinnvoller Dateiname reduziert Rückfragen und hilft beim Wiederfinden in einem Download-Ordner. ## Mehrere Dateien richtig bereitstellen Eine Download-Aktion kann nur eine Datei verknüpfen. Wenn du mehrere Unterlagen gemeinsam bereitstellen möchtest, hast du zwei sichere Möglichkeiten: | Bedarf | Passender Weg | | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------- | | Mehrere Dateien sollen zusammen heruntergeladen werden. | Fasse sie vor dem Hochladen in einer ZIP-Datei zusammen und verknüpfe diese eine ZIP-Datei. | | Jede Datei soll einzeln sichtbar sein. | Erstelle für jede Datei einen eigenen Button, ein eigenes Bild oder eine eigene SVG-Grafik. | | Besucherinnen und Besucher sollen eine Datei zuerst ansehen. | Verwende keine Download-Aktion, sondern eine Adresse, die in einem neuen Tab geöffnet wird. | Benenne bei mehreren einzelnen Downloads jeden Auslöser und jede Datei eindeutig. So verhinderst du, dass eine Schaltfläche versehentlich die falsche Unterlage ausliefert. ## Was Besucherinnen und Besucher erleben Nach dem Klick startet der Download direkt. Es gibt keine Vorschau innerhalb der Seite. Auf Mobilgeräten kann das Betriebssystem oder der Browser zusätzlich fragen, mit welcher App eine Datei geöffnet werden soll. Dieses Verhalten kommt vom Gerät und ist nicht automatisch ein Fehler der Website oder des Funnels. Die Funktion erfasst laut Quelle nicht einzeln, wer eine Datei heruntergeladen hat. Wenn du die Identität einer Person vor einer Dateiübermittlung benötigst, muss diese vor dem Download über ein geeignetes Formular erfasst werden. Der Download selbst ersetzt keine solche Erfassung. ## Vollständig testen — nicht nur im Editor Teste den Download immer an der veröffentlichten Adresse, denn nur dort siehst du das Ergebnis für Besucherinnen und Besucher. 1. Speichere deine Änderung. 2. Öffne die Vorschau und klicke den Auslöser einmal an. 3. Veröffentliche die Seite. 4. Öffne die öffentliche Adresse in einem privaten Browserfenster. 5. Klicke Button, Bild oder SVG-Grafik. 6. Prüfe, ob der Download startet und genau die erwartete Datei enthält. 7. Prüfe den sichtbaren Dateinamen. 8. Wiederhole den Test auf einem Smartphone. 9. Teste erneut, wenn du die Datei, den Namen oder das Element später änderst. Prüfe bei einer großen Datei zusätzlich, ob der Download nicht hängen bleibt. Wenn das passiert, vergleiche die Dateigröße mit den Grenzen der Medienbibliothek und komprimiere die Datei bei Bedarf. ## Typische Probleme lösen | Beobachtung | Wahrscheinliche Ursache | So gehst du vor | | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------- | | Beim Klick passiert nichts. | Die Download-Aktion ist nicht aktiv oder es wurde keine Datei ausgewählt. | Öffne die Einstellungen des Elements und prüfe Aktion und verknüpfte Datei. | | Ein Download führt zu einer Fehlerseite oder einer fehlenden Datei. | Die Datei wurde in der Medienbibliothek geändert, entfernt oder ist nicht mehr erreichbar. | Wähle die richtige vorhandene Datei erneut aus und veröffentliche die Seite danach. | | Der Download startet sehr langsam oder bleibt stehen. | Die Datei ist zu groß oder überschreitet eine Grenze der Medienbibliothek. | Prüfe die Dateigröße, komprimiere die Datei und teste erneut. | | Mehrere Unterlagen sollen mit einem Klick kommen. | Ein Element kann nur eine Datei verknüpfen. | Erstelle eine ZIP-Datei oder verwende mehrere klar beschriftete Auslöser. | | Die Datei soll im Browser sichtbar sein statt heruntergeladen zu werden. | Die Download-Aktion ist bewusst auf direkten Download ausgelegt. | Verwende eine Adresse, die in einem neuen Tab geöffnet wird. | | Auf dem Smartphone erscheint eine App-Auswahl. | Das mobile Gerät entscheidet, womit es die Datei öffnet. | Teste mit einer gängigen App; dies ist normales Geräteverhalten. | | Der Dateiname ist unverständlich. | Das Feld **Dateiname** wurde nicht gepflegt. | Trage einen verständlichen Namen ein und teste den neuen Download. | ## Praxisbeispiel: Checkliste als PDF ausliefern Eine Beratung möchte auf einer Leistungsseite eine Checkliste anbieten. Das Team lädt die geprüfte PDF in die Medienbibliothek und nennt sie dort eindeutig. Im Seiteneditor wählt es den Button **Checkliste herunterladen (PDF)** aus. Unter **Button-Aktionen** setzt es **Verknüpfen mit** auf **Datei herunterladen**, wählt die PDF aus und trägt als Dateiname `Checkliste-erster-Termin.pdf` ein. Danach prüft das Team die Vorschau. Nach der Veröffentlichung öffnet es die Seite im privaten Browserfenster und auf einem Smartphone. Beide Tests liefern die richtige PDF mit dem vorgesehenen Namen. Erst danach bleibt der Download auf der Seite. ## Abschlusscheck * [ ] Der sichtbare Auslöser erklärt eindeutig, welche Datei heruntergeladen wird. * [ ] Es wurde ein Button, Bild oder eine SVG-Grafik ausgewählt. * [ ] Die passende Aktion **Datei herunterladen** ist gesetzt. * [ ] Genau eine geprüfte Datei aus der Medienbibliothek ist verknüpft. * [ ] Der Dateiname ist verständlich. * [ ] Bei mehreren Unterlagen gibt es eine ZIP-Datei oder klar getrennte Auslöser. * [ ] Der Download wurde in Vorschau, im privaten Browserfenster und auf einem Smartphone getestet. * [ ] Nach Austausch oder Entfernung einer Datei wurde jeder betroffene Download erneut geprüft. Für die Vorbereitung und Pflege der Dateien lies auch [Medienbibliothek](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/websites-und-leadgewinnung/medienbibliothek). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://one-loop.gitbook.io/help/plattform/one-loop-plattform/websites-und-leadgewinnung/websites-und-funnels/dateien-per-button-oder-bild-zum-download-bereitstellen.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.