# Photo essay Open Graph Image Template

A photo essay card with a wide image panel, title, and photographer byline.

- Page: https://www.shadcn-ui-blocks.com/open-graph-images/photo-essay
- Category: [Content](https://www.shadcn-ui-blocks.com/open-graph-images/content), Publications
- Theme: light, with light and dark renditions
- Preview PNG: https://www.shadcn-ui-blocks.com/open-graph-images/photo-essay/preview

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/og-image-photo-essay
```

The code is part of Pro and Team: the install needs an API key from either plan (https://www.shadcn-ui-blocks.com/docs/shadcn-cli).

Use the Photo essay template when the work is visual and the share card should be too. It leads with a wide framed image over the essay title and a photographer byline, so the card previews the piece the way a magazine spread would. The frame ships as a drawn placeholder, ready to swap for a real photograph whenever you have one.

## How it works

This template is a metadata image route for the Next.js App Router. The file exports `size`, `contentType`, and `alt` values plus a default async function that returns an `ImageResponse`. When a page in the segment is shared, satori converts the JSX into an SVG document, the runtime rasterizes that SVG into a 1200 by 630 PNG, and Next.js serves the result and wires the `og:image` and `twitter:image` tags into the page head automatically. The placeholder is a bordered panel with a simple inline landscape shape, so the card looks composed before any real image exists.

## Install

Install with the shadcn CLI using your Shadcn UI Blocks API key:

```bash
npx shadcn@latest add @shadcn-ui-blocks/og-image-photo-essay
```

The file lands at `app/opengraph-image.tsx`, which makes it the site wide share card. For an essay you will usually move it into the story segment instead, for example `app/essays/[slug]/opengraph-image.tsx`. You can also copy the code from this page straight into your project.

The card renders text with Inter, read from `assets/fonts` at your project root with `node:fs` so the font files never ship to the browser. Download the latin woff files for weights 400, 500, 600, and 700 from [Fontsource](https://fontsource.org/fonts/inter) and save them as `assets/fonts/inter-latin-400-normal.woff` and so on.

## Customize

The `content` object holds the `label` chip, the `title`, the `byline`, an image `count` chip, and the `url`; there is no brand row here, since the photograph carries the identity. To show a real image, replace the framed placeholder block with an `img` element pointing at an absolute URL, and satori fetches it at render time. Keep the title to about two lines so it clears the frame above and the byline below.

satori supports a focused subset of CSS: flexbox layout only, flat colors, and an explicit `display: flex` on any element with multiple children. Keep those rules in mind if you rework the layout.
