Linkkit
Dashboard
Linkkit Help Center
MANAGING YOUR LINKS

How to set custom link previews for your Linkkit Links?

Learn how to customize how your links show up on social media to improve click-through rates.

Learn how to customize how your links show up on social media to improve click-through rates.

This feature is only available on [Pro plans and above](https://uselinkkit.com/pricing).

Linkkit is the only link management platform that lets you customize the social media cards for your links, so you can have full control over how your links look when shared on social media and improve click-through rates.

For example, your company was recently featured on TechCrunch, but the default link preview is a generic Unsplash image that doesn't accurately reflect your brand.

With Linkkit, you can set a custom-designed social media card for your link, which greatly improves the click-through rate and performance of your short link.

To leverage this feature, toggle the "Custom Link Previews" switch in the link builder. This will reveal the following fields:

How to do it
Step 1

Image: The image that will be used for the social media card. You can upload an image from your computer or drag and drop an image into the field (recommended size: 1200 x 630 pixels, max 1.5MB).

Step 2

Title: The title that will be used for the social media card (max 120 characters).

Step 3

Description: The description that will be used for the social media card (max 240 characters).



You can also quickly access the Link Preview feature by using the keyboard shortcut L while in the link builder.

When you share a Linkkit link that has a custom social media card, they will show up with the title, description, and image that you set on all social media platforms.

This resulted in a more engaging and informative tweet that effectively communicated the value of their product to a wider audience.

Bonus: Add a custom video preview

Linkkit also supports the og:video OpenGraph tag, which allows you to set a custom video preview for your links.

To set a custom video preview, you can pass a link to your video via the video attribute when creating a link using our API:

import { Linkkit } from "linkkit";

const linkkit = new Linkkit();

await linkkit.links.create({
  url: "https://example.com",
  proxy: true, // proxy has to enabled for custom link previews to work
  image: "https://example.com/image.png", // it's recommended to pass a fallback image for platforms that don't support og:video
  video: "https://example.com/video.mp4",
});

We currently do not support uploading custom video previews directly via the dashboard, but please [let us know](https://uselinkkit.com/contact/support) if that's something that you'd like to see.

Here's a demo of how custom video previews works – let's embed a link (https://linkkit.cc) that has custom video preview enabled in Notion:

As you can see, the link unfurled into a video preview when embedded in Notion, but if you clicked on the link, it would redirect you to the destination URL.

If your custom link previews are not working, it's usually due to a caching issue, where the social media platform cached the old version of your link.

You can use the following tools to bust the cache:

  • X: cards-dev.x.com/validator
  • LinkedIn: linkedin.com/post-inspector
  • Facebook: developers.facebook.com/tools/debug

If you're still having issues, please let us know and we'll be happy to help you out.

Open the Linkkit dashboard to try these steps in your workspace.

Powered byLinkkit