Du fügst eine URL in einen Slack-Channel ein und nichts passiert. Kein Thumbnail, kein Titel, nur ein nackter Link. Slack entfaltet Links, indem es Open-Graph-Tags von deiner Seite holt. Scheitert der Crawler oder fehlen Tags, bleibt die Vorschau leer.
Kurzantwort
og:title, og:description und og:image im serverseitigen HTML mit absoluten HTTPS-URLs setzen. Prüfen, ob Slackbot die Seite erreicht (robots.txt, Firewall). og:image-URL direkt testen. Link vor dem Teilen in OpenGraph Check prüfen.
Wie Slack-Unfurling funktioniert
Beim Posten einer URL in Slack wird der Link entfaltet (unfurled). Slacks Crawler holt dein HTML und liest Open-Graph-Meta-Tags:
<meta property="og:title" content="Seitentitel"><meta property="og:description" content="Kurze Zusammenfassung."><meta property="og:image" content="https://beispiel.de/og.jpg"><meta property="og:url" content="https://beispiel.de/seite">Slack rendert eine Attachment-Karte unter der Nachricht mit Titel, Beschreibung und Bild.
Slack führt kein JavaScript aus. Meta-Tags müssen in der ersten HTML-Antwort stehen.
Keine Vorschau vs. Teil-Vorschau
| Symptom | Wahrscheinliche Ursache |
|---|---|
| Nur URL, keine Karte | Unfurling deaktiviert, Crawler blockiert oder keine OG-Tags |
| Titel und Text, kein Bild | og:image fehlt oder Bild-Abruf gescheitert |
| Falscher Titel | og:title fehlt, Fallback auf <title> |
| In einem Workspace ja, in anderem nein | Workspace-Einstellungen oder gecachter Link |
| Unfurl langsam | Server-Antwortzeit oder großes Bild |
Slack-Workspace-Einstellungen prüfen
Vor dem Site-Debugging: Unfurling erlaubt?
- Workspace-Admins: Settings & administration → Workspace settings
- Unter Permissions prüfen, ob Link-Vorschauen erlaubt sind
- Manche Enterprise-Workspaces blockieren externe Domains
Einzelne Nutzer können Workspace-Blocks nicht überschreiben.
Schritt 1: Open-Graph-Tags im Quelltext
- Seitenquelltext anzeigen.
- Nach
og:titleundog:imagesuchen. - Alle URLs absolut (
https://beispiel.de/...).
Bei SPAs: SSR oder Framework-Metadata, damit Tags vor JavaScript im HTML stehen.
Referenz: Open-Graph-Tags erklärt.
Schritt 2: Slackbot in robots.txt erlauben
Slack meldet sich als Slackbot oder Slackbot-LinkExpanding. robots.txt darf nicht blockieren:
User-agent: Slackbot
Allow: /
User-agent: Slackbot-LinkExpanding
Allow: /
Weitere Crawler für Multi-Plattform-Sharing:
User-agent: LinkedInBot
Allow: /
User-agent: Twitterbot
Allow: /
Schritt 3: Bild und Server-Antwort testen
og:image im Browser öffnen:
- HTTP 200
- HTTPS Pflicht
- Keine Auth-Wall
- Antwortzeit unter 3 Sekunden
- Dateigröße unter 5 MB (unter 1 MB besser)
Bei Timeout kann Slack das Bild weglassen, Titel und Text aber zeigen.
Schritt 4: Firewall und CDN prüfen
Cloudflare Bot Fight Mode, aggressive WAF-Regeln und Geo-Blocking können Slack blockieren. Slackbot-User-Agents whitelisten oder Bot-Challenges auf öffentlichen Seiten reduzieren.
Cached das CDN Fehlerantworten für Bots, Cache nach dem Fix leeren.
Slack-spezifisches Unfurl-Verhalten
Caching
Slack cached Unfurl-Daten pro URL. Nach Tag-Fix: Link in neuer Nachricht oder mit Query (?s=1) posten.
Mehrere URLs in einer Nachricht
Slack entfaltet die erste erkennbare URL. Link auf eigene Zeile setzen.
Interne vs. externe Links
Links zu Slack-Apps (Google Drive, Figma etc.) nutzen natives Unfurling, nicht Open Graph. Dieser Guide gilt für normale Website-URLs.
localhost und Staging
Slack kann localhost oder VPN-only-Staging nicht entfalten. Öffentlich erreichbare URL zum Testen nutzen.
Bild-Empfehlungen für Slack
| Eigenschaft | Empfehlung |
|---|---|
| Größe | 1200 × 630 px |
| Format | JPG oder PNG |
| URL | Absolute HTTPS |
| Dateigröße | Unter 1 MB |
Slack schneidet Bilder zu. Seitenverhältnis 1.91:1 vermeidet unschöne Crops.
Typische Fehler
| Fehler | Fix |
|---|---|
Relativer og:image-Pfad | Volle https://-URL |
| Meta-Tags nur per Client-JS | Serverseitig im HTML |
noindex / X-Robots-Tag blockiert alles | Crawler auf teilbaren Seiten erlauben |
| Passwortgeschützte Staging-URL | Production oder öffentliches Preview testen |
| og:image zeigt auf HTML-Seite | Auf echte Bilddatei zeigen |
FAQ
Nutzt Slack Twitter-Card-Tags?
Slack nutzt primär Open Graph. og:*-Tags setzen. Nur Twitter-Tags reichen oft nicht.
Warum ging Unfurling früher, jetzt nicht mehr?
Letzte Deploys prüfen: robots.txt, CDN-Regeln, SSL-Ablauf, entferntes og:image.
Kann ich Unfurling für bestimmte Links deaktivieren?
Slack-Nutzer können eine Vorschau aus einer Nachricht entfernen. Site-Betreiber können pro URL nicht opt-outen.
Gleiches Verhalten in DMs und Channels?
Ja. Gleicher Crawler und OG-Parsing für Channels, DMs und private Gruppen.
Unterschied zu Discord?
Beide lesen Open Graph, aber mit verschiedenen Crawlern und Caches. Tags pro Plattform prüfen. Siehe Discord Link-Vorschau funktioniert nicht.
Brauche ich eine Slack-App für Link-Vorschauen?
Nein. Standard-OG-Tags auf öffentlichen Seiten reichen. Slack-Apps sind für custom interaktives Unfurling.
Fazit
Slack-Link-Vorschauen brauchen Open-Graph-Tags im Server-HTML und einen erreichbaren Crawler. og:title, og:description, og:image auf HTTPS, Slackbot in robots.txt erlauben, Bilder schnell und klein halten, in frischer Nachricht testen. Die meisten Unfurl-Fehler sind weg, sobald der Crawler gültige Tags und 200 bekommt.