Open Graph Image Settings

A short guide to generated Open Graph images, direct image overrides, and the site-wide generation switch.

Plex Live can generate Open Graph and Twitter card images for pages automatically. The generated image uses the page title, the site title, the author avatar, and either the default aero background or a post header image.

You can turn generated Open Graph images off for the whole site:

1[params]
2  generateOpenGraphImages = false

When generation is disabled, the theme will not create fallback social images. A page can still define its own image in front matter:

1ogImage: "open-graph-example.jpg"
2ogImageAlt: "A cropped dark aurora background used as a custom Open Graph example."

The same front matter also wins when generation is enabled. In other words, ogImage is always treated as the exact Open Graph image to publish, not as a source image for the generated card.

Image Size

Open Graph images should be 1200x630. This post uses a page resource cropped from the bundled dark aurora image:

A cropped dark aurora image sized for Open Graph previews A cropped dark aurora image sized for Open Graph previews

Keeping the image beside the post makes the content portable and lets Hugo resolve it as a page resource.

Generated Cards

If a page does not define ogImage and generateOpenGraphImages is enabled, the theme generates a card automatically:

1title: "Generated Card Example"
2description: "The theme can generate the social image when no ogImage is set."

For posts with headerImage, the generated card uses the header picture as the background and applies the bundled white Open Graph overlay behind the text and avatar.