How-to guide

Link-Vorschau auf Bluesky oder Mastodon hinzufügen

Last updated: 2026-05-26 · Bluesky · By SocialKit Team

Link-Vorschaukarten auf Bluesky und Mastodon wirken simpel, brechen aber aus unterschiedlichen Gründen auf jeder Plattform. Dieser Leitfaden erklärt warum — AT-Protocol-Embed-Einträge auf Bluesky, serverseitiges OpenGraph-Fetching auf Mastodon — und zeigt, wie du Posts mit einer funktionierenden Karte planst.

Bevor du beginnst

Du benötigst ein Bluesky-Konto (beliebiger Handle) und/oder ein Mastodon-Konto auf einer beliebigen Instanz. Um Link-Posts im Voraus zu planen, brauchst du außerdem ein SocialKit-Konto — die kostenlose 7-Tage-Testversion (0,00 € fällig heute) deckt beide Plattformen ab.

Auf Seite des Seitenbetreibers: Die URL, auf die du verlinkst, muss korrekte OpenGraph-Meta-Tags (`og:title`, `og:description`, `og:image`) haben, damit eine Karte auf einem der Netzwerke erscheint. Wenn du die Zielseite besitzt, prüfe diese Tags zuerst. Wenn du auf eine Drittanbieter-URL verlinkst, kannst du nur deinen Post beeinflussen — nicht ob deren Seite OG-Tags hat — passe deine Erwartungen entsprechend an.

Step by step

  1. Verstehe, wie Bluesky Link-Karten erzeugt

    Auf Bluesky ist eine Link-Vorschaukarte nicht einfach eine gerenderte URL — es ist ein expliziter `app.bsky.embed.external`-Eintrag, der zum Zeitpunkt der Erstellung an deinen Post angehängt wird. Stand Juni 2026 ruft der Client beim Einfügen einer URL in die Bluesky-Web-App oder einen konformen Drittanbieter-Composer die OpenGraph-Tags der Seite ab und verpackt Titel, Beschreibung und Vorschaubild in diesen Embed-Eintrag. Das AT Protocol speichert ihn dann neben dem Post-Text. Fehlt der Embed-Eintrag, erscheint keine Karte — auch wenn die URL im Post-Text steht.

    Tip: Eine nackte URL im Post-Text ohne Embed-Eintrag erscheint auf den meisten Bluesky-Clients als Klartext, nicht als Karte. Bestätige immer, dass die Kartenvorschau im Composer gerendert wird, bevor du postest.

  2. Prüfe, ob die Ziel-URL OpenGraph-Tags hat

    Füge die URL in einen Browser ein und zeige den Quellcode an (Strg/Cmd + U), dann suche nach `og:title`, `og:description` und `og:image`. Alle drei sollten vorhanden sein. Fehlt `og:image`, erzeugen manche Clients eine reine Textkarte; wenn die Bildabmessungen zu klein sind (Bluesky erwartet stand Juni 2026 mindestens 800 px Breite), kann das Vorschaubild leer oder schlecht zugeschnitten sein. Korrigiere für eigene Seiten die Tags im CMS oder `<head>` und verifiziere sie mit einem kostenlosen OG-Tag-Validator, bevor du den Link verbreitest.

    Tip: Bluesky-Kartenbilder werden im Verhältnis 1,91:1 (ca. 1200 × 628 px) angezeigt, identisch zum Standard-OG-Bildformat. Ein quadratisches `og:image` wird auf den meisten Clients letterboxed statt zugeschnitten — nutze ein 1200 × 628 px-Bild für das sauberste Ergebnis.

  3. Verfasse deinen Bluesky-Post in SocialKit und bestätige die Kartenvorschau

    Öffne den SocialKit-Composer und wähle dein verbundenes Bluesky-Konto als Ziel. Füge deine URL in den Post-Text ein. Stand Juni 2026 ruft SocialKit die OpenGraph-Daten der Seite ab und zeigt eine Live-Vorschau der Karte im Composer, damit du Titel, Beschreibung und Vorschaubild vor der Planung bestätigen kannst. Ist die Karte leer oder zeigt Platzhaltertext, liegt das Problem höchstwahrscheinlich an den OG-Tags der Zielseite — behebe diese zuerst (siehe Schritt 2), dann aktualisiere den Composer.

    Tip: Wenn du auf eine Seite verlinkst, deren OG-Tags kürzlich geändert wurden, können CDN- oder Vorschau-Caches Minuten bis Stunden zum Auffrischen brauchen. Ein Cache-Busting-Query-Parameter (z. B. `?v=2`) erzwingt in den meisten Composern einen frischen Fetch, ändert aber die kanonische URL — nutze dies nur auf Seiten, die du besitzt und wo die URL-Änderung akzeptabel ist.

  4. Verstehe, wie Mastodon Link-Karten erzeugt

    Mastodon-Link-Karten funktionieren anders als Bluesky. Wenn deine Home-Instanz einen Post mit einer URL empfängt, ruft ihr Server die Zielseite asynchron ab und analysiert deren OpenGraph-Tags — normalerweise innerhalb weniger Sekunden, manchmal bis zu einer Minute auf ausgelasteten oder ratenlimitierten Instanzen. Die Karte erscheint, nachdem dieser serverseitige Fetch abgeschlossen ist. Stand Juni 2026 bedeutet das: (a) die Karte erscheint möglicherweise nicht sofort, auch wenn OG-Tags korrekt sind; (b) liegt die Ziel-URL hinter einem Bot-blockierenden CAPTCHA oder Cloudflare-Challenge, kann die Instanz sie möglicherweise nicht abrufen und die Karte erscheint nie; (c) das Kartenverhalten kann zwischen Mastodon-Versionen variieren (die aktuelle stabile Linie ist 4.x).

    Tip: Mastodon speichert die Karte nicht im Post-Eintrag wie Bluesky — sie wird auf Abruf aus der URL generiert, jedes Mal wenn ein Client den Post lädt. Das bedeutet: Ein fehlerhaftes OG-Tag auf der Zielseite zu korrigieren, wird die Karte auf allen vergangenen Mastodon-Posts, die darauf verlinken, letztendlich reparieren, sobald die Instanz ihren Cache aufgefrischt hat.

  5. Verfasse deinen Mastodon-Post in SocialKit und plane ihn

    Wähle im SocialKit-Composer dein verbundenes Mastodon-Konto neben (oder statt) Bluesky. Schreibe deinen Post-Text und füge die URL ein. Nutze die plattformspezifische Anpassung, um die Bildunterschrift anzupassen, wenn du gleichzeitig auf beiden Netzwerken postest — Mastodons Standard-Zeichenlimit ist 500 (manche Instanzen erhöhen dies; prüfe das Limit deiner Instanz in deinen Kontoeinstellungen), während Blueskys Limit stand Juni 2026 bei 300 Graphemen liegt. Setze eine bestimmte Zeit oder nutze Best-Time-Daten, dann plane. SocialKit veröffentlicht zum geplanten Zeitpunkt automatisch auf Mastodon; keine Smartphone-Interaktion erforderlich.

    Tip: Mastodons Content-Warning-Feld (CW) ist ein separates Textfeld, das den Post-Inhalt hinter einem Klick verbirgt. Es wird häufig für Spoiler, sensible Themen oder lange Threads verwendet — nicht für Standard-Link-Posts. Lasse es leer, wenn die Normen deiner Community es nicht erfordern.

  6. UTM-Parameter hinzufügen, um Klicks pro Netzwerk getrennt zu verfolgen

    Wenn der Link in deinem Post auf eine Seite zeigt, die du besitzt, hänge UTM-Parameter an, damit Google Analytics 4 (oder jede andere Analytics-Plattform) Bluesky-Klicks von Mastodon-Klicks trennt. Ein minimaler Satz sieht aus wie `?utm_source=bluesky&utm_medium=social&utm_campaign=deine-kampagne`. Nutze den kostenlosen SocialKit-UTM-Builder, um diese tippfehlerfrei zu generieren, und füge die getaggte URL in den Composer ein, bevor die Vorschaukarte abgerufen wird. Die Karte zeigt die Metadaten der Zielseite, auch wenn die URL Parameter enthält.

    Tip: Bluesky und Mastodon geben URLs unverändert weiter — keiner von beiden entfernt UTM-Parameter, wie es manche Plattformen tun. Vorschaubild und Titel der Karte stammen aus den OG-Tags der Zielseite unabhängig vom Query-String, UTM-getaggte URLs erzeugen also korrekte Kartenvorschauen.

  7. Denselben Link-Post auf X, Threads oder anderen Plattformen teilen

    Noch in derselben SocialKit-Composer-Sitzung kannst du X (Twitter), Threads oder eine der neun anderen unterstützten Plattformen als zusätzliche Ziele hinzufügen. Jede bekommt ihr eigenes Bildunterschriften-Feld — halte Bluesky unter 300 Graphemen, Mastodon unter dem Limit deiner Instanz, X (Twitter) unter 280 Zeichen (Standard-Konten, stand Juni 2026; Premium-Pläne unterscheiden sich) und Threads unter 500 Zeichen. Das Link-Karten-Verhalten unterscheidet sich je Plattform: X rendert eine Vorschaukarte und zählt die URL nicht; Threads und Bluesky zeigen eingebettete Karten; Mastodon ruft eine asynchron ab. Plane alle Ziele in einer einzigen Sitzung.

Best practices

  • Füge immer alle drei wesentlichen OpenGraph-Tags — `og:title`, `og:description` und `og:image` — auf jeder Seite ein, auf die du verlinken möchtest. Das Fehlen eines davon verschlechtert oder eliminiert die Karte auf Bluesky und Mastodon.
  • Verwende ein 1200 × 628 px-Bild für `og:image`. Dieses 1,91:1-Verhältnis ist der Standard auf Bluesky, Mastodon und den meisten anderen Netzwerken und verhindert Letterboxing oder Zuschneiden auf verschiedenen Clients.
  • Bestätige auf Bluesky, dass die Karte im SocialKit-Composer gerendert wird, bevor du planst — sobald ein Post auf dem AT Protocol veröffentlicht ist, ist der Embed-Eintrag gesetzt und kann nicht ohne Löschen und Neuposten bearbeitet werden.
  • Warte auf Mastodon bis zu 60 Sekunden nach dem Go-live eines Posts, bevor du davon ausgehst, dass die Karte defekt ist — besonders auf kleineren oder ausgelasteten Instanzen stand Juni 2026.
  • Verwende UTM-getaggte URLs für jeden Link-Post und halte eine konsistente Namenskonvention ein (`utm_source=bluesky`, `utm_source=mastodon`), damit deine Analytics Open-Protocol-Traffic sauber von anderen Kanälen trennt.
  • Plane Link-Posts in den aktiven Stunden deines Publikums mit SocialKit-Best-Time-Daten — eine korrekte Karte, die ankommt wenn niemand online ist, erzielt trotzdem schlechte Ergebnisse. Sieh dir /best-time-to-post/bluesky und /best-time-to-post/mastodon für aktuelle Ausgangsfenster an.

Good to know

Warum „ich habe die URL eingefügt, aber es gibt keine Karte" — die zwei häufigsten Ursachen

Auf Bluesky: Die häufigste Ursache ist, dass der Composer keinen Embed-Eintrag generiert hat, entweder weil der OG-Fetch fehlgeschlagen ist (Bot-Blocking, langsamer Server, fehlende Tags) oder weil du die URL nach dem Eingeben von anderem Text eingefügt hast und der Client keinen neuen Fetch ausgelöst hat. Um es zu beheben, leere den Post, füge die URL zuerst ein, warte bis die Kartenvorschau erscheint, dann füge deinen Bildunterschriften-Text drum herum ein. Erscheint die Karte noch immer nicht, fehlen der Zielseite die OG-Tags oder sie geben Fehler zurück.

Auf Mastodon: Die häufigste Ursache ist, dass deine Instanz den asynchronen Fetch noch nicht abgeschlossen hat oder der Zielserver die Anfrage der Instanz blockiert hat (Cloudflare, CAPTCHA oder IP-Level-Block). Es gibt keine Umgehungslösung für eine blockierte Ziel-URL außer einer Weiterleitung oder einem anderen Ziel. 30–60 Sekunden warten und den Post aktualisieren löst stand Juni 2026 normalerweise eine Langsam-Fetch-Situation.

Bluesky-Post-Bearbeitung und der Embed-Eintrag

Stand Juni 2026 unterstützt Bluesky keine Bearbeitung von Post-Einträgen nach der Veröffentlichung — das ist eine bewusste AT-Protocol-Designentscheidung zur Post-Unveränderlichkeit und Föderationsintegrität. Wenn ein Post mit einer defekten oder fehlenden Karte veröffentlicht wird, ist deine einzige Option, ihn zu löschen und mit dem korrigierten Embed neu zu posten. Das macht die Bestätigung der Karte in der SocialKit-Vorschau vor der Planung auf Bluesky wichtiger als auf jeder anderen Plattform.

Mastodon unterstützt das Bearbeiten von Posts auf Instanzen, die Version 3.5.0 und später ausführen; bearbeitete Posts zeigen ein Bearbeitungshistorie-Badge auf Clients, die dies unterstützen. Ob das Bearbeiten eines Mastodon-Posts den Link-Karten-Cache aktualisiert, hängt stand Juni 2026 jedoch von der Instanz ab.

Do it in SocialKit

SocialKits Composer ruft OpenGraph-Daten ab und zeigt eine Live-Kartenvorschau, bevor du planst — damit du defekte Vorschauen erkennst, bevor sie live gehen. Plane auf Bluesky, Mastodon und neun weiteren Plattformen aus einem Kalender. Unbegrenzte geplante Posts in jedem Plan, 7-Tage-Gratis-Test, 0,00 € fällig heute.

Bluesky- und Mastodon-Link-Posts mit SocialKit planen
All 11 platforms included

Try it free

Schedule and cross-post to all 11 networks from one calendar on one flat plan. 7-day free trial — €0.00 due today.

Jetzt kostenlos testen

0,00 € heute fällig · jederzeit kündbar · 7 Tage Geld-zurück-Garantie

FAQ

Frequently asked questions

The questions people ask before they schedule — answered honestly, hedged where platform behavior changes.

Jetzt kostenlos testen

0,00 € heute fällig · jederzeit kündbar · 7 Tage Geld-zurück-Garantie