Open Graph images for Apple Messages

Generate Apple Messages link preview images for every page

Use one HCTI og:image pattern across your site. Each page supplies its own metadata, and HCTI keeps the matching Apple Messages image current without a separate image-generation request.

  • 1200 × 628 images for messages
  • Updates when preview inputs change
  • No extra code per page

Jeffrey

This is the approach I think we should use.
Make every share look intentional

Make every share look intentional

htmlcsstoimage.com

Delivered

A rich preview in Messages

Let the image introduce the page before the text below it

Apple Messages gives the visual most of the card and places the title and domain beneath it. Compose the image so it remains clear without depending on a long description.

1

Articles between friends

Use a recognizable hero image when the title sits below the card.

2

Reservations and events

Make the linked page obvious in a busy group conversation.

3

Product links

Show the product clearly without relying on a paragraph of preview text.

Metadata recipe

Set up the Apple Messages image

Point og:image at the HCTI URL for the current path, then use hcti:selector on that page to choose the element HCTI captures.

<meta property="og:image" content="https://hcti.io/v1/og/{YOUR_DOMAIN_ID}/product-launch">

<meta property="hcti:selector" content="#social-card">

What if the Apple Messages preview does not update?

Check the page first

  • Confirm the metadata is in the page’s <head> before a crawler loads it.
  • Open the HCTI image URL directly and make sure it returns the expected image.
  • Remember that Apple Messages may keep its own cached preview after the image changes.

Allow the Apple Messages crawler

If your firewall filters bots, allow requests whose user agent contains Facebot Twitterbot/1.0.

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_1) AppleWebKit/601.2.4 (KHTML, like Gecko) Version/9.0.1 Safari/601.2.4 facebookexternalhit/1.1 Facebot Twitterbot/1.0
Read Apple Messages’s preview documentation

Preview your page on Apple Messages

See the image and text Apple Messages can use when someone shares your page.

Query parameters are ignored unless you’re signed in.

Public pages only

We’ll read the page’s link-preview tags and image. Some sites may block automated checks.

How it works

The public URL stays simple while HCTI reads the page, creates the image, and reuses it until the inputs change.

  1. Add one og:image pattern

    Use your HCTI domain ID and append the current page path. No API key or per-page image URL needs to be published.

  2. HCTI reads the page head

    On refresh, HCTI fetches the requested page and reads its hcti: screenshot options or html:tv: template values.

  3. Serve the matching image

    HCTI creates the image when the resolved screenshot or template inputs change, then caches and serves it to link-preview crawlers.

Fresh when it matters

Update previews without rendering on every share

HCTI checks page metadata separately from generating the image. Unchanged screenshot or template inputs reuse the existing render; changed inputs create the next image.

Controlled refreshes

Choose how often HCTI may check each page for updated meta tags. Origin cache headers and ETags can avoid unnecessary work.

Content-based reuse

HCTI hashes the resolved screenshot or template inputs so unchanged pages return the image that already exists.

Preview-aware sizing

Use one image everywhere, fit one render into recognized preview sizes, or render with a platform-specific viewport.

Ready for better link previews?

Give every page an image worth sharing

Add one stable OG image URL pattern, keep the supported meta tags on each page, and let HCTI handle rendering and reuse.