Add an og:image:alt <meta> element in your page’s <head>, immediately alongside the matching og:image tag. Its content should briefly describe the meaningful visual content of that image, not repeat a social-media caption.
<meta property="og:image" content="https://example.com/images/product-card.jpg" />
<meta property="og:image:alt" content="Blue ceramic mug beside an open notebook on a wooden desk" />The Open Graph Protocol defines this property as “A description of what is in the image (not a caption)” and recommends specifying it whenever a page specifies og:image (Open Graph Protocol).
What og:image:alt does
Open Graph metadata tells services what to associate with a shared URL. The og:image property identifies the image file; og:image:alt supplies a textual description of that image. They are separate properties and should not be combined in one tag.
Place both tags in the document’s <head>. A complete set commonly includes title, description, URL, image URL, and image description:
#1 Best Overall
- HTML CSS Design and Build Web Sites
- Comes with secure packaging
- It can be a gift option
<head>
<meta property="og:title" content="Ceramic mugs | Example Store" />
<meta property="og:description" content="Hand-finished mugs for coffee and tea." />
<meta property="og:url" content="https://example.com/mugs" />
<meta property="og:image" content="https://example.com/images/product-card.jpg" />
<meta property="og:image:alt" content="Blue ceramic mug beside an open notebook on a wooden desk" />
</head>Use an absolute, publicly reachable image URL. The description should make sense in the context of the page and should mention only visible, meaningful content.
How to write useful Open Graph image descriptions
Describe the visual subject
State what a person would need to know to understand the image: the main object, people, setting, action, color, or other context that matters. “Blue ceramic mug beside an open notebook on a wooden desk” is useful because it identifies the subjects and their arrangement.
Keep it concise but informative
There is no protocol-mandated character limit in the Open Graph specification. Prefer a natural sentence or phrase that conveys the image’s purpose without cataloging every minor detail. If text inside the image is essential to understanding it, include that text briefly; otherwise, avoid transcribing decorative copy.
Do not use captions or keyword lists
An image caption explains why an image appears in an article. Alt text describes what is in the image. Do not stuff search terms into the value. Google’s Image SEO best practices guidance favors useful, information-rich descriptions and warns that keyword stuffing harms user experience and may be treated as spam.
Decorative or non-informative images
If the selected sharing image is purely decorative, a short description can identify its visual role (for example, “Abstract blue and violet gradient”). Do not invent information that cannot be seen. For a meaningful product, person, chart, or scene, describe that content instead.
Adding the tag to common page setups
Static HTML
- Open the HTML template used for the page.
- Insert
og:imageandog:image:altinside<head>. - Ensure the image URL and description refer to the same image.
- Deploy the page and inspect the rendered source, not only an editor preview.
Server-rendered applications
Generate the two properties from the same page data so they cannot drift. For example, a product object can provide an image URL and a separate human-written description. Escape quotation marks and HTML-sensitive characters when your framework renders attribute values.
Single-page applications
Social crawlers may request the initial HTML before JavaScript runs. Render Open Graph tags on the server or at build time when possible. If tags are inserted only after hydration, a crawler may not see them. Confirm the response body delivered to an unauthenticated request contains the metadata.
Content-management systems
Use the SEO or social-sharing fields supplied by your CMS, if they expose an image-description field. If the CMS emits an og:image tag but no og:image:alt, add the property in the theme or head template. Prevent duplicate tags from a theme and an SEO plugin; conflicting values make debugging difficult.
Do these 3 things before closing this tab:
1Scan for outdated or missing drivers - takes under a minute2Clear out junk files and repair common Windows errors3Fix the driver behind crashes, sound loss and screen glitchesHandling multiple Open Graph images
Open Graph permits multiple image declarations. Keep each image’s structured properties with its root declaration, in order:
<meta property="og:image" content="https://example.com/images/front.jpg" />
<meta property="og:image:alt" content="Front view of a blue ceramic mug on a desk" />
<meta property="og:image" content="https://example.com/images/side.jpg" />
<meta property="og:image:alt" content="Side view showing the mug’s curved handle" />The protocol states that the first tag from top to bottom is preferred when values conflict. Each new root og:image starts another image entry, so do not place all descriptions at the end and assume a crawler will pair them correctly.
Rank #3
Do not confuse Open Graph alt text with HTML image alt text
| Mechanism | Where it appears | Purpose |
|---|---|---|
og:image:alt |
<meta> in the page head |
Describes the image selected for a shared URL’s Open Graph metadata. |
alt on <img> |
The image element in page content | Provides an alternative for that in-page image, including for screen-reader users when the image is unavailable. |
| Platform-native descriptions | A social network’s post or article composer | Uses that platform’s own accessibility workflow for an uploaded or attached image. |
Use both mechanisms where appropriate. Adding og:image:alt does not replace an alt attribute on an image users see in the page.
What social networks and search engines do with it
The Open Graph Protocol defines the property, but the available sources do not establish that every social platform displays or consumes webpage og:image:alt consistently. Do not promise that one tag will expose a description on Facebook, LinkedIn, X, or another service.
Quick wins for a faster PC:
Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Repair Windows errors before they cause bigger problemsFix Now →Scan for outdated or missing drivers - takes under a minuteDriver Scan →LinkedIn documents a separate workflow for adding alternative text to images shared in feeds or embedded articles, saying it helps members using voice-over screen readers understand the image (LinkedIn: Add alternative text to images for accessibility). X documents its ALT badge for image descriptions (X Help: ALT badge and GIF label). Those native controls are not evidence that the platforms will expose a webpage’s Open Graph property in the same way.
Google says image previews are selected automatically from multiple signals. Site owners can indicate preferred images with schema.org image metadata or og:image, and Google recommends relevant, representative, high-resolution images rather than generic images or extreme aspect ratios (Google Search Central). That guidance concerns image selection; it is not a guarantee that Google will display og:image:alt as a search-result description.
LinkedIn’s website-sharing documentation lists og:title, og:image, og:description, and og:url; its listed required tags do not include og:image:alt. The same page gives a 5 MB maximum file size, minimum dimensions of 1200 × 627 pixels, and a recommended 1.91:1 ratio for its sharing module. These platform details can change, so verify them before relying on exact dimensions (LinkedIn: Make your website shareable).
Rank #4
- Brand: Wiley
- Set of 2 Volumes
- A handy two-book set that uniquely combines related technologies Highly visual format and accessible language makes these books highly effective learning tools Perfect for beginning web designers and front-end developers
Validate an implementation
- Request the public page without logging in or running a browser extension.
- View the returned HTML source and search for
property="og:image"andproperty="og:image:alt". - Check that every image URL is absolute, uses the intended protocol, and returns the intended file.
- For multiple images, verify that each description follows its corresponding root image tag.
- Inspect the page at mobile and desktop widths to ensure the selected image is representative; this is separate from validating the metadata.
- Share a test URL where your target service permits previews, allowing for cache delays and crawler-specific behavior.
Troubleshooting common problems
The tag is missing from the source
Your CMS, template, or client-side code may not be emitting it. Add it to the server-rendered head template and check for a plugin or theme setting that removes unknown metadata.
The Tool Desk
Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →The wrong description appears
Look for duplicate og:image or og:image:alt tags. Remove stale declarations and keep one ordered pair per image. A social crawler may also be showing a cached preview; changing the URL or using the platform’s documented refresh mechanism can trigger a new fetch.
The image does not load
Confirm the URL is publicly accessible over HTTPS, does not require cookies or authentication, and returns an image with a correct content type. Check redirects, robots or firewall rules that block crawler requests, and any hotlink restrictions.
The description is exposed as a visible caption
og:image:alt belongs in a <meta> element and is not page-visible by itself. If text appears in the article, it is likely a separate caption, heading, or CMS field rendered into the body.
JavaScript changes the metadata too late
Move generation to server-side rendering or build time. Compare “view source” with the live DOM: crawlers commonly rely on the initial response rather than a fully executed browser session.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Or skip the browser setup
If you are creating preview images while testing metadata, ScreenshotNeo can capture the page through one request. It accepts consent banners before capture and removes more than 60 known consent platforms, newsletter popups, and chat widgets; each cleanup step can be disabled. Bot checks, CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and the response identifies the page verdict and billing status in headers. Its MCP server provides take_screenshot, get_page_info, and capture_pdf tools for Claude, Cursor, and other MCP clients.
See the parameter reference in the ScreenshotNeo documentation. A direct request looks like this:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://example.com/mugs -o shot.webpPython:
import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://example.com/mugs"}, timeout=90)
open("shot.webp", "wb").write(r.content)Node.js:
const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://example.com/mugs' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);The Free plan includes 1,000 screenshots each month without a card; paid plans start at $5 for 3,000 shots. Sign up for ScreenshotNeo to try it.
Frequently Asked Questions
Is og:image:alt required for Open Graph?
The Open Graph Protocol recommends specifying it whenever you specify og:image, but individual platforms may not require or visibly use it.
PC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Outdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchCan I put the description in the og:image URL tag?
No. Keep the image URL in og:image and the description in a separate og:image:alt property.
Should the value end with a period?
Either a phrase or a sentence is acceptable. Choose a natural style and apply it consistently; the protocol does not prescribe punctuation.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
