Custom link preview: image, title and description

Change the image, title and description chats and social posts show for your short link (its Open Graph preview), without touching the page itself.

On this page
  1. How a custom link preview works (Open Graph)
  2. Change the link preview image, title and description
  3. Set a preview as you create a link
  4. What a blank field shows
  5. When the new card shows up
  6. Common questions
  7. Next steps

To set a custom link preview, the image, title and description that WhatsApp, Slack, LinkedIn and other apps show for your short link, open the link's Link preview section, paste the address of the image you want, and add a title and a description. The page behind the link stays exactly as it is; only the card people see in the chat or the post changes.

That matters more than it sounds. A product page with no image, a sign-up form titled "Untitled", one page shared by three campaigns that each need their own pitch: each link gets the card its audience should see, and the people who tap it still land on the same page.

Before you start: you need a short link, or you can set the preview as you make one; see how to create a short link. Custom link previews depend on your plan; see pricing.

When someone pastes a link into a chat or a post, the app fetches it and reads the page's Open Graph tags: a title, a description and an image. That's the card.

  • Without a custom preview, the app follows your short link to the destination and shows that page's own card.
  • With one, Brevily answers the app with your title, description and image instead. The card's address is still the short link, so anyone who shares it on keeps sharing your link.
  • Search engines aren't preview apps. They follow the link to the destination as usual.
  • A preview never counts as a click. Only people opening the link do.

Brevily recognises the preview fetches of Facebook, X, LinkedIn, Slack, WhatsApp, Telegram, Discord, Microsoft Teams, Pinterest, Reddit, Mastodon, Bluesky, Snapchat and Viber, among others.

  1. Open Links, choose the link and open its Settings tab.
  2. Find the Link preview row.
  3. Fill in the Title (one line) and the Description.
  4. Paste the full address of the picture into Image URL, starting with https://.
  5. Check the As shared card beside the fields, then choose Save changes.

[screenshot: the Link preview row on a link's Settings tab, with Title, Description, Image URL and the As shared card]

The image isn't uploaded to Brevily. The field holds the address of a picture you host, on your site or a file host, and each app fetches it from there. Keep it at that address for as long as the link is being shared.

  1. Open New link, or choose More options in the Create link dialog.
  2. Open Link preview. Its summary reads From the destination until you fill a field, then Custom.
  3. Fill in Title, Image URL and Description.
  4. Check the card under Shared in a chat or a post in the preview column, then choose Create link.

What a blank field shows

Fill in any one field and the link uses its own card from then on. A field you leave blank doesn't fall back to the destination's version:

  • No title: the card shows the destination's site name, such as example.com.
  • No description: the card shows the destination's address.
  • No image: the card has no picture, and apps that can show it smaller do.

So to change only the image, write a title and a description too. To go back to the destination's own card, clear all three and save.

When the new card shows up

Brevily serves the new preview within a few minutes of saving. Many apps, though, keep the card they built the first time a link was shared, and decide for themselves when to fetch it again. A post that's already up may keep its old card for a while; a fresh share picks up the new one.

Two kinds of link show a different card:

  • Password links: the app gets the password page like anyone else, so the card reads "Password needed". See password-protected short links.
  • Links with a click limit: the app gets your preview with no way through, so the card never reveals the destination. Write a title, or the card just says "Link".

[screenshot: the same link shared in a chat, with the destination's own card and with a custom one]

Common questions

Does a custom link preview change where the short link goes?

No. People who tap the link still go to its destination as usual. Only the card that chats and social posts show changes.

Can I upload a link preview image from my computer?

No. Brevily doesn't store the image: put it on your website or a file host you control, and paste its web address into Image URL. Keep it at that address while the link is shared.

Why does an old post still show the old link preview?

The app keeps the card it built when the link was first shared, and decides for itself when to fetch it again. Brevily serves the new preview within a few minutes of saving, so a fresh share shows it.

What happens to custom link previews if my plan changes?

A preview you've already set keeps working. Setting or changing one needs a plan with custom previews; clearing one never does.

Next steps

All how-to guides

Brevily is invite-only, for now

Say what you would use it for and a person replies. Already invited? Sign in.