All posts
OPEN GRAPH · LINK PREVIEWS · FIXES

Why Your Website's Link Preview Is Broken (and How to Fix It)

Paste your site link in a text and get a blank box or naked URL? That's broken Open Graph tags. Here's exactly what's wrong and how to fix it fast.

June 24, 2026/7 min read/By Circuit Coders

You Paste Your Link and It Looks Dead

You're a San Diego contractor texting a quote to a homeowner. You paste circuitcoders-style link to your portfolio, hit send, and instead of a clean card with your logo and a photo, the customer sees a naked blue URL. Or worse — a gray box with a broken-image icon. It looks like a scam link, and now they're hesitating to tap it.

Same thing happens when an Oceanside restaurant shares its menu page on Facebook and the post shows no photo, no title, just the bare web address. The algorithm buries posts with no image. Your reach drops, the link looks sketchy, and nobody clicks.

This isn't a fluke and it isn't your phone. It's a fixable problem with a boring name — Open Graph tags — and almost every cheap or DIY site gets it wrong. The good news: it's a one-time fix, not a redesign.

The Problem Isn't Your Link. It's the Tags Behind It.

When you paste a link into iMessage, Facebook, LinkedIn, WhatsApp, or Slack, that app sends a little robot to your page to grab three things: a title, a description, and an image. It finds them by reading invisible tags in your site's code called Open Graph (OG) tags. No tags, no preview.

Facebook invented the Open Graph standard, and now everyone uses it — Apple, Microsoft, LinkedIn, the whole lot. X (Twitter) adds its own twist with twitter:card tags. If those tags are missing, pointing at a broken image, or using a relative path instead of a full URL, the preview falls apart.

Here's the kicker: your page can look perfect in a browser and still have zero OG tags. The browser doesn't need them. The link-preview robots do. That's why DIY builders and rushed $99 sites ship looking fine and then embarrass you the moment someone shares the link.

The Exact Tags You Need (Copy This Checklist)

Every page that anyone might share needs a short block of tags in the <head> of the HTML. Not the homepage only — every page. The product page, the menu page, the booking page. Each one should declare its own title, description, and image.

The image is the part people get wrong most. It has to be a full absolute URL (https://yoursite.com/preview.jpg, not /preview.jpg), it has to actually exist at that address, and it should be sized right or it'll get cropped into mush.

  • og:title — the headline on the card (keep it under ~60 characters)
  • og:description — one or two sentences, under ~155 characters
  • og:image — an absolute https URL to a real image, ideally 1200×630 pixels
  • og:url — the canonical full address of the page
  • og:type — usually "website" for a business site
  • twitter:card — set to "summary_large_image" so X shows the big version
  • twitter:image — same image URL again, so X has its own copy
If you fix one thing today, fix og:image. A card with a photo gets tapped; a card without one gets ignored.

What's Quietly Killing Your Preview

Half the time the tags are technically there — they're just wrong in ways you can't see by looking at the page. These are the silent killers I find on almost every audit, and any one of them blanks out your card.

Before you assume your fix didn't work, know this: Facebook, LinkedIn, and iMessage cache the old preview hard. You can fix the tags perfectly and still see the broken version for hours because the robot is showing you a stale copy.

  • og:image points to a relative path (/logo.png) — robots need the full https:// URL
  • The image is over 8 MB or under 200×200 px — Facebook refuses to load it
  • Tags live in the <body> instead of the <head> — the robot stops reading first
  • One global preview image for all 40 pages — every page looks identical
  • The image URL 404s because the file got renamed or moved
  • You're on a slow host and the robot times out before the image loads
  • You fixed it but never told the platform to re-scrape, so it shows the old cache
After any fix, run the page through Facebook's Sharing Debugger and LinkedIn's Post Inspector and hit "re-scrape." That forces a fresh preview instead of waiting 24–48 hours for the cache to clear.

While You're In There, Fix the Stuff Google Reads Too

Open Graph tags are for humans sharing links. Schema.org tags are for Google — and they're the same kind of invisible code in the same part of the page. If your link previews are broken, your structured data is almost certainly missing too, and that's costing you in search.

A North County service business should have LocalBusiness schema on the homepage: your name, address, phone, hours, service area, and the cities you cover — Carlsbad, Vista, San Marcos, Bonsall, Pala. That's what feeds the rich result with your hours and star rating, and it backs up your Google Business Profile.

Speaking of which: claim and fully fill your Google Business Profile, match the name-address-phone exactly across your site, Yelp, and every directory, and build separate pages targeting '[service] + [city]' — "plumber Oceanside," "detailing Vista," "roofing San Marcos." Each page gets its own OG image and its own LocalBusiness schema. That's how a small shop shows up clean in both a text message and a map pack.

What This Costs (and Why It Shouldn't Be Much)

A typical agency will treat "fix our link previews and add schema" as a billable project — $150 to $250 an hour, padded into a few hours, call it $500 to $1,000 for an afternoon of head-tag work. That's real money for editing a dozen lines of code.

If your whole site is the problem — slow host, no OG tags, no schema, looks fine but shares like garbage — you're better off with a clean rebuild than paying hourly to patch a bad foundation. Circuit Coders builds custom sites flat at $499, 48-hour turnaround, on Next.js and Vercel, with Open Graph tags, per-page preview images, and LocalBusiness schema baked in from the first line. One round of revisions included.

Need something specific wired up — Stripe checkout, an online booking platform, a reservation system? Those run $200–$500 as add-ons. Hosting and ongoing updates are optional at $50/month. No retainer, no "strategy call," no agency markup.

Send Me Your Link. I'll Tell You What's Wrong.

You don't have to guess whether your previews are broken. Paste your homepage into a text to yourself right now and look at the card. Blank image? Wrong title? Naked URL? That's the whole diagnosis.

I'll do the rest for free. Send me your link and I'll run it through the debuggers, check your OG tags, your schema, and your image sizes, and tell you exactly what's broken and what it'd take to fix — no charge, no pitch deck.

If the answer is "the foundation is shot," I'll send you a free mockup of a fresh build so you can see the difference before you spend a dollar.

Free audit of your link previews and a free homepage mockup — $499 flat to build it right, live in 48 hours. Send the link and I'll tell you what's wrong today.

Frequently asked

Why does my link show no image on Facebook but looks fine in my browser?

Browsers don't need Open Graph tags to display a page, but Facebook's preview robot does. If those og:image and og:title tags are missing or pointing at a broken URL, you get a blank card even though the page itself loads perfectly.

How long until my link preview updates after I fix the tags?

Once you re-scrape the page in Facebook's Sharing Debugger or LinkedIn's Post Inspector, the new preview shows almost instantly. If you wait passively instead, platforms cache the old version for roughly 24–48 hours before refreshing on their own.

Do I even need Open Graph tags if I already have a Google Business Profile?

Yes — they do different jobs. Your Business Profile controls how you show up in Google Maps and search, while OG tags control how your link looks when anyone texts or shares it. A complete site needs both, plus LocalBusiness schema to tie them together.

I'm on Wix or Squarespace — can I even fix this?

Sometimes, through their SEO or social-sharing settings, but those builders often limit per-page images and load slowly enough that the preview robot times out. A clean custom build at $499 with proper per-page OG tags fixes it permanently in about 48 hours.

What size should my link preview image be?

1200×630 pixels is the standard that displays large and uncropped across Facebook, LinkedIn, iMessage, and X. Keep the file under 8 MB and never below 200×200, or platforms will refuse to load it.

$499 FLAT · 48-HOUR TURNAROUND

Ready to see what a real site looks like?

Send us your URL. We'll build you a free mockup within 48 hours. If you like it, you pay $499 and we ship. If not, walk away — no cost.

Request a free mockup