Bot reference catalog

One-page summaries of 30 common search, AI/LLM, and social-preview crawlers.

← bot index · audit index

facebookexternalhit

Vendor
Meta
Type
Social preview
JavaScript rendering
no
Honors robots.txt
partial
VendorMeta
TypeSocial link-preview bot (Facebook, Instagram, Messenger, WhatsApp)
robots.txt tokenfacebookexternalhit
JavaScript renderingNo
Honors robots.txtPartial — fetches link-preview metadata even when robots.txt disallows
Vendor docsdevelopers.facebook.com/docs/sharing/webmasters

User-Agent string

facebookexternalhit/1.1 (+http://www.facebook.com/externalhit_uatext.php)

Purpose

The bot that fetches a URL whenever someone shares it on Facebook, Instagram, Messenger, or WhatsApp — to extract og:title, og:image, og:description and render the preview card. Older than the LLM era; this bot has been around since ~2010.

Quirks

to crawl deep.

fetch is on behalf of an end-user who shared the link. Meta's policy is that link-preview fetches are user actions, not crawls.

meta tags should be in static HTML — many SPAs that don't SSR these end up with broken FB previews.

How to control

# Provide og:* tags in static HTML for working previews:
<meta property="og:title" content="...">
<meta property="og:image" content="...">
<meta property="og:description" content="...">

To block link previews:

User-agent: facebookexternalhit
Disallow: /

(Note: Meta may not honor this for user-shared links.)

Sources