Open Graph Preview
ProRequires a Pro or Builder plan
What is Open Graph Preview?
When someone pastes your short link into Twitter, LinkedIn, iMessage, or Slack, those platforms fetch the page's Open Graph (OG) meta tags to generate a rich preview card showing a title, description, and image. By default they read these from your destination URL. With OG Preview you can override these values directly on the short link, letting you craft exactly what preview card the audience sees without changing your destination page.
Requirements
OG Preview customisation requires a Pro or Builder plan. The preview image must be a publicly accessible URL (PNG or JPG recommended, at least 1200 × 630 px for best results on all platforms).
Step-by-step: Set a custom OG preview
- Create a new link or open an existing one in your dashboard.
- Scroll to the Social Preview section and toggle it on.
- Enter a custom Title (up to 70 characters) — this appears as the bold headline in the preview card.
- Enter a custom Description (up to 200 characters) — appears as the body text below the title.
- Enter the full URL of your Preview Image. The image is fetched at share time, not stored by AWSYS.CO, so it must remain publicly accessible.
- Save the link. Social platforms cache OG data for several hours — use the platform's own cache-busting tool (e.g., Facebook Sharing Debugger) to force an immediate refresh.
Configuration reference
| Field | Max length | Notes |
|---|---|---|
| OG Title | 70 characters | Displayed as the headline in link preview cards |
| OG Description | 200 characters | Displayed as the subtitle; some platforms truncate earlier |
| OG Image URL | 2,083 characters (URL max) | Must be https://; min 1200 × 630 px recommended |
Common questions
The preview is not updating on Twitter/X. What should I do?
Social platforms cache OG data aggressively. Visit the Twitter Card Validator at cards-dev.twitter.com/validator, enter your short link, and click Preview to force a cache refresh.
Does the OG preview affect analytics?
Social platform crawlers that fetch OG data are filtered out and do not count as clicks. Only real visitor redirects are counted in your analytics.
Can I set OG data via the API?
Yes. Include "ogTitle", "ogDescription", and "ogImage" fields in your POST /api/createShort or PATCH /api/links/:id request body.
Does OG Preview work on custom domains?
Yes. The OG meta tags are served from whatever domain the short link uses — awsys.co or your custom domain. Both work identically.