Introduction

New to Open Graph tags? Learn more about them with the Mastering Open Graph Tags guide.

Setting up Open Graph images is a great way to improve your click-through-rate when your link is shared.

However, setting them up can be tricky. Knowing which meta tag to use and the rules for the image can be difficult to remember.

In using Nuxt SEO Utils and you can set up your social share images seamless using Next.js Metadata Files, generating automatic meta tags.

File Types

opengraph-image

Open Graph images are used by social media sites to display a website's icon when shared.

The image dimensions and type will be automatically generated from the image file.

  • *og-image.{png,jpg,jpeg,gif}
  • *opengraph-image-*.{png,jpg,jpeg,gif}
Example File Structure
pages/
├── index.vue
├── about/
│   ├── index.vue
│   └── og-image.png

Head output
<meta property="og:image" content="<site-url>/about/og-image.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:image:type" content="image/png" />

twitter-image

Twitter images are used by to display an image when your site is shared on Twitter.

The image dimensions and type will be automatically generated from the image file.

  • *twitter-image.{png,jpg,jpeg,gif}
Example File Structure
pages/
├── index.vue
├── about/
│   ├── index.vue
│   └── twitter-image.png

head output
<meta name="twitter:image" content="<site-url>/about/twitter-image.png" />
<meta name="twitter:image:width" content="1200" />
<meta name="twitter:image:height" content="630" />
<meta name="twitter:image:type" content="image/png" />

Providing Alternate Text

You can provide alternate text for your images by using creating a matching .txt file for your image.

For example, if you have an image og-image.png, you can create a og-image.txt file with the alternate text.

og-image.txt
This is the alternate text for my image.
head output
<meta property="og:image:alt" content="This is the alternate text for my image." />

Using _dir folder

It's recommended to use the _dir folder to store your images when you have multiple images for a single route.

Example File Structure
pages/
├── index.vue
├── about/
│   ├── index.vue
│   └── _dir/
│       ├── og-image.png
│       ├── og-image.txt
│       ├── twitter-image.png
│       └── twitter-image.txt

head output
<meta property="og:image" content="<site-url>/about/_dir/og-image.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:image:type" content="image/png" />
<meta property="og:image:alt" content="This is the alternate text for my image." />
<meta name="twitter:image" content="<site-url>/about/_dir/twitter-image.png" />
<meta name="twitter:image:width" content="1200" />
<meta name="twitter:image:height" content="630" />
<meta name="twitter:image:type" content="image/png" />
<meta name="twitter:image:alt" content="This is the alternate text for my image." />
Edit this page
Did this page help you?

App Icons

Learn how metadata files work with logos.

Best Practice Default Meta

The default meta tags Nuxt SEO sets for you.