---
title: "Managing Open Graph Fallback Images"
description: "Open Graph protocol makes links on social look great. HelpDocs automatically pulls the first image from an article and uses it as the Open Graph image. You can add a Fallback Image for when there are no images in the article."
url: "https://support.helpdocs.io/article/zp2dq1z40c-adding-a-open-graph-fallback-image"
category: "Customizing your HelpDocs"
updated_at: "2026-07-30T15:39:50Z"
---

# Managing Open Graph Fallback Images

Open Graph protocol makes links on social look great. HelpDocs automatically pulls the first image from an article and uses it as the Open Graph image.

If you don't have an image to display in your article, we'll pull the logo on your docs and display that instead. You can override this by uploading your own fallback image.

### Preparing Your Open Graph Image

Here's a few tips on creating your own image for open graph:

- Keep the size around 1200px by 1200px
- PNG format is best
- Try to keep important text in the middle third of the image, like so:
  
  ![](https://files.helpdocs.io/Ytt2uahFxY/articles/zp2dq1z40c/1541152290912/fallback-example.png)

### Adding an Open Graph Fallback Image

![](https://files.helpdocs.io/Ytt2uahFxY/articles/zp2dq1z40c/1785425947721/clipboard-20260730-153850-909.gif)

1. Head to **Settings** > [Brand](https://my.helpdocs.io/app/settings?tab=brand)
2. Under **Open Graph Fallback Image** click or drag on an image
3. Hit **Save Changes**

You can check Open Graph details for an article using this tool and pasting in your URL: [http://iframely.com/debug](http://iframely.com/debug)

### Setting the Open Graph Fallback Mode

By default we'll show the first image in the article as the Open Graph image if the article has images 🖼️

If you'd prefer to show the Open Graph fallback on *all* articles (rather than an image from the article) that's fine too! You can enable this easily in your account:

1. Head to **Settings** > [**Brand**](https://my.helpdocs.io/app/settings?tab=brand)
2. Set the **Open Graph fallback image mode** you'd prefer
   
   1. *First article image* (our default) will use the first article image if available. If there's no images it will show the fallback image you've set in your account
   2. *Fallback image* will always use the Open Graph fallback you've set in your account
3. Hit **Save Changes**