Datenblatt-PDFs für Such- und KI-Crawler sichtbar machen

Pferdegold · Shopify-Umsetzungsanleitung für PG-Tech · Stand 25. Juni 2026 · Florian Meier (SEO/GEO · Brand & Content · Tools)

Die Datenblatt-PDFs sind für Kund:innen über den Button »Datenblatt herunterladen« erreichbar – für Google, ChatGPT, Perplexity & Co. aber unsichtbar. Diese Anleitung erklärt Ursache, Wirkung und die saubere Shopify-Lösung, Schritt für Schritt.

1. Der Befund (geprüft am 25.06.2026)

Auf der Produktseite /products/mineral existiert der Button »Datenblatt herunterladen« sichtbar im Browser. In zwei unabhängigen Crawl-Prüfungen war er jedoch nicht auffindbar:

Roh-HTML als Googlebot (ohne JavaScript-Ausführung): kein Datenblatt-Link, kein .pdf-Verweis.
Vollständig gerendertes DOM (Headless-Browser, nach komplettem Scrollen): ebenfalls kein Datenblatt-Link auffindbar.

Schlussfolgerung: Der Button wird per JavaScript (Theme-Skript oder App-Block) nach dem Laden in die Seite injiziert. Such- und KI-Crawler führen dieses JavaScript in der Regel nicht aus – sie sehen die Seite ohne den Button. Damit ist das Datenblatt für sie nicht vorhanden.

2. Warum das für GEO/SEO zählt

KI-Antwortmaschinen und Suchmaschinen „lesen" eine Produktseite als Text und folgen Links, die im server-gerenderten HTML stehen. Ein Element, das erst per JavaScript erscheint, ist für sie nicht existent. Konkret heißt das: Wenn ein KI-Crawler die Seite verarbeitet, erfährt er nicht, dass es ein Datenblatt gibt, und kann es weder folgen noch als Quelle nutzen.

Gute Nachricht zuerst: Der wichtigste Hebel ist bereits erfüllt – die vollständige Deklaration (Zusammensetzung, analytische Bestandteile, Zusatzstoffe) steht schon als echter Text auf der Produktseite. Das ist der eigentliche „HTML-First"-Vorteil. Diese Anleitung schließt nur die verbleibende Lücke: dass auch der Datenblatt-Download selbst für Crawler sichtbar/auffindbar wird.

3. Die Lösung in Shopify (zuverlässig)

Kernprinzip: Der Datenblatt-Link muss vom Theme (Liquid) server-seitig ausgegeben werden – nicht von einer App oder einem JavaScript-Skript. Dann steht er im HTML, das jeder Crawler ohne JavaScript sieht.

Schritt 1 – Aktuellen Mechanismus feststellen

Zuerst klären, wie der Button heute entsteht (das weiß PG-Tech am besten):

Liegt das PDF als Produkt-Metafeld vom Typ »Datei« (z. B. custom.datenblatt)? Dann ist die Lösung einfach (Schritt 2a).
Oder rendert eine App den Button (App-Block im Theme-Editor sichtbar)? Dann den App-Block durch eine native Theme-Ausgabe ersetzen (Schritt 2b).

Schritt 2a – Wenn das PDF ein Metafeld ist: Link per Liquid ausgeben

Im Produkt-Template (bzw. einer Theme-Section, z. B. main-product.liquid oder einem Custom-Liquid-Block) den Link direkt aus dem Metafeld rendern:

<!-- Datenblatt-Download, server-gerendert (crawlbar) -->
{% if product.metafields.custom.datenblatt %}
  <a href="{{ product.metafields.custom.datenblatt.value | file_url }}"
     class="datenblatt-download" download>
     Datenblatt {{ product.title }} herunterladen
  </a>
{% endif %}

Hinweise: Den Metafeld-Namespace/Key (custom.datenblatt) an die tatsächliche Definition anpassen. Bei File-Metafeldern liefert | file_url die CDN-URL. Wichtig ist nur, dass dieser <a>-Tag im gelieferten HTML steht – nicht erst per JavaScript erscheint.

Schritt 2b – Wenn eine App den Button rendert: ersetzen

Den App-Block entfernen und stattdessen den Liquid-Link aus Schritt 2a einsetzen. Falls das PDF bislang nur in der App liegt, es zusätzlich als Shopify-Datei (Einstellungen → Dateien) oder als Produkt-Metafeld hinterlegen, damit Liquid es referenzieren kann.

Schritt 3 – PDF selbst sauber aufsetzen

Punkt	So machen
Dateiname	sprechend, kebab-case, mit Keyword – z. B. `pferdegold-mineral-2-0-datenblatt.pdf` statt `db_final_v3.pdf`
Textebene	echtes Text-PDF (Export aus Word/InDesign), kein Scan – Faustregel: Text muss sich im PDF markieren und kopieren lassen
PDF-Titel	in den Dokument-Eigenschaften einen sprechenden Titel setzen (z. B. »Pferdegold Mineral 2.0 – Datenblatt«)
Linktext	beschreibend (»Datenblatt Pferdegold Mineral 2.0 herunterladen«), nicht nur »Download«

Schritt 4 – Verifizieren

Nach der Umstellung muss der Link im Roh-HTML auftauchen. Prüfbar so (PG-Tech oder Flo):

curl -sL -A "Googlebot" https://pferde-gold.de/products/mineral | grep -i datenblatt

Heute liefert dieser Befehl nichts. Nach dem Fix muss er den <a>-Tag mit der PDF-URL zeigen. Erst dann ist das Datenblatt für Crawler sichtbar.

4. Erwartungsmanagement (ehrlich)

Der Content-Hebel bleibt HTML-First. Die wichtigsten Datenblatt-Infos stehen schon als Text auf der Seite – das ist das Entscheidende für KI-Sichtbarkeit. Dieser Fix macht zusätzlich den Download auffindbar, ersetzt aber nicht die On-Page-Inhalte.
Shopify nimmt PDF-Datei-URLs nicht automatisch in die Sitemap auf. Der server-gerenderte Link auf der Produktseite ist deshalb der entscheidende Entdeckungs-Pfad für Crawler.
Canonical-Header auf Shopify-CDN-Dateien sind nicht frei setzbar. Das ist hier unkritisch, weil das PDF ein Zweit-Download neben der HTML-Seite ist und nicht selbst ranken muss.
Kein Flipbook-/Viewer-Widget für das Datenblatt verwenden – ein direkter PDF-Link ist für Crawler am besten lesbar.

Offen / zu verifizieren mit PG-Tech: Wie der Datenblatt-Button heute technisch entsteht (Metafeld vs. App), konnte von außen nicht eindeutig bestimmt werden – nur, dass er per JavaScript injiziert wird. PG-Tech kennt den genauen Mechanismus; die Lösung (Liquid-Ausgabe statt JavaScript) gilt unabhängig davon.