> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkutm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Link preview

> Override the social-share preview card title, description, image.

When someone pastes your short link into Slack, LinkedIn, WhatsApp, or similar apps, the platform fetches link preview tags to render a preview card. linkutm lets you override the preview title, description, and image per link without touching the destination page.

## When to use it

* Destination doesn't have preview tags (or has bad ones).
* You want a campaign-specific preview without changing the page.
* A/B testing share previews across channels.

## How to use it

<Steps>
  <Step title="Open Advanced → Social preview">
    In the link creation, expand **Advanced** and find the **Social preview** section.
  </Step>

  <Step title="Set preview fields">
    <ParamField path="Preview title">Card headline. Keep ≤60 chars.</ParamField>
    <ParamField path="Preview description">Subline. Keep ≤155 chars.</ParamField>
    <ParamField path="Preview image">Public image URL. Recommended 1200×630px PNG/JPG.</ParamField>
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/utm-e577acb5/_OFWyAVC_YtnhKc0/images/OGpreview.png?fit=max&auto=format&n=_OFWyAVC_YtnhKc0&q=85&s=d9eff9fb68b43a46cced2035a2ae11d6" alt="Link Preview modal - editable preview title and description fields with social card preview" width="1920" height="991" data-path="images/OGpreview.png" />
</Frame>

## Real-world example

Same destination URL, different previews per channel:

```
Short:            go.acme.com/launch-li     (LinkedIn)
Preview title:    Acme Widget - built for engineering teams
Preview image:    https://cdn.acme.com/og/launch-linkedin.png

Short:            go.acme.com/launch-x      (X/Twitter)
Preview title:    Acme Widget. Now in beta.
Preview image:    https://cdn.acme.com/og/launch-twitter.png
```

Same destination `https://acme.com/launch`. Per-link preview settings drive different share cards.

## Common mistakes

<AccordionGroup>
  <Accordion title="Setting preview tags on the destination instead">
    If the destination already has correct preview tags, you don't need this. Override only when you want different cards per link.
  </Accordion>

  <Accordion title="Forgetting cache">
    LinkedIn and Meta cache preview data. Use their debug tools to flush after changes.
  </Accordion>

  <Accordion title="Image too large or non-public">
    Files over \~5 MB or URLs behind auth won't render. 1200×630 PNG/JPG, public.
  </Accordion>

  <Accordion title="Image address starts with http, not https">
    If your preview image address starts with `http` instead of `https`, some platforms block it from showing. Always use an `https` image address.
  </Accordion>
</AccordionGroup>

## Edge cases

<Note>
  **Imported links** auto-fetch preview data from the destination during import (5s timeout). If the fetch fails, the favicon falls back to Google's favicon service for the destination domain.
</Note>
