# OG image aspect ratio is appropriate for LinkedIn

- **Pattern:** `ab-001817` (`marketing-social-sharing.platform-specific.linkedin-image-aspect`)
- **Severity:** medium
- **Lifecycle:** active
- **Last modified:** 2026-04-18
- **Canonical URL:** https://auditbuffet.com/patterns/ab-001817
- **License:** CC-BY-4.0 — attribute to AuditBuffet Pattern Catalog (https://auditbuffet.com/patterns/ab-001817)

## Why it matters

LinkedIn crops OG images that fall outside its preferred 1.91:1 aspect ratio. A square 1200×1200 image is cropped to a horizontal strip; a portrait 600×900 image is cropped to a narrow band. The crop is center-based, meaning headline text or logos placed toward the edges of an image optimized for other contexts will be cut off. Per ogp.me, the recommended dimensions are 1200×628, which maps to 1.91:1. Developers who create OG images for general use at square or tall aspect ratios discover the cropping problem only when they check the LinkedIn post-publish preview — after the content has already been shared.

## Severity rationale

Medium because off-ratio OG images are cropped on LinkedIn without any warning, potentially hiding key visual content from the image and reducing the preview's marketing effectiveness.

## Remediation

Use 1200×630 pixels for all OG images. This satisfies LinkedIn's 1.91:1 ratio and is accepted by all major platforms. For `ImageResponse`-generated images, set the dimensions explicitly:

```ts
return new ImageResponse(<div>...</div>, { width: 1200, height: 630 })
```

For existing static images at wrong ratios, resize them with an image editor or a build-time `sharp` script. When designing OG image templates, keep critical content (text, logos) within a centered safe zone that accounts for the 1.91:1 crop.

## Detection

- **ID:** `linkedin-image-aspect`
- **Severity:** `medium`
- **What to look for:** Check the OG image dimensions declared in metadata or in the actual image files. LinkedIn's preferred aspect ratio is 1.91:1 (1200×628 or 1200×630 are both acceptable). Images with aspect ratios significantly different from 1.91:1 will be cropped or displayed with letterboxing on LinkedIn. Common problematic ratios are 1:1 (square images) and 16:9 (too wide). Check both static files in `public/` and `ImageResponse` dimensions.
- **Pass criteria:** OG images have an aspect ratio between 1.7:1 and 2.0:1 (i.e., width is between 1.7× and 2.0× the height). The 1200×630 standard satisfies this at 1.905:1. At least 1 implementation must be confirmed.
- **Fail criteria:** OG image dimensions result in an aspect ratio outside the 1.7:1 to 2.0:1 range (e.g., a square 1200×1200 image, or a 600×315 image).
- **Skip (N/A) when:** No OG image configuration found (caught by `og-all-pages-complete`).
- **Detail on fail:** `"OG image is 1200x1200 (1:1 ratio) — LinkedIn will crop this to 1.91:1, showing only the center strip of the image"` or `"OG image dimensions not declared and file not accessible for dimension check"`
- **Remediation:** LinkedIn crops images that fall outside its preferred 1.91:1 aspect ratio. The safest OG image dimensions are 1200×630 (or 1200×628). If you are using `ImageResponse`, set the height to 630:

  ```ts
  return new ImageResponse(<div>...</div>, { width: 1200, height: 630 })
  ```

  If you have existing images at wrong ratios, resize them. Center your key visual content within the 1.91:1 crop area.

## External references

- external ogp.me — https://ogp.me/

Taxons: findability

HTML version: https://auditbuffet.com/patterns/ab-001817