cover image

Dec 8, 20232 min Read

Adding Dynamic Open Graph Images to NextJS

A guide on how to add dynamic Open Graph Images to Your Next.js Project

Open Graph (OG) images are crucial for enhancing your website's visibility and engagement on social media platforms. In this guide, we'll explore how to dynamically generate OG images at runtime in a Next.js project, ensuring each page or post has a unique and relevant image when shared.

Step 1: Setting Up Your Next.js Project

Ensure your Next.js project is up and running. If you're starting from scratch, create a new Next.js app:

npx create-next-app@latest my-next-app
cd my-next-app

Step 2: Creating a Dynamic OG Image API Route

Next.js allows API routes which we will use to generate OG images. Create a new file under /pages/api/og-image.ts (or .js if not using TypeScript). In this file, we'll write a function to generate images:

// pages/api/og-image.ts
import type { NextApiRequest, NextApiResponse } from "next";

export default function handler(req: NextApiRequest, res: NextApiResponse) {
  // Logic to generate dynamic OG image based on request parameters


Step 3: Generating Images

For image generation, use a library like node-canvas or sharp. These libraries allow you to create images programmatically:

npm install canvas

Then, update your API route to generate an image:

import { createCanvas, loadImage } from "canvas";

export default async function handler(
  req: NextApiRequest,
  res: NextApiResponse
) {
  const width = 1200;
  const height = 630;
  const canvas = createCanvas(width, height);
  const context = canvas.getContext("2d");

  // Add your image generation logic here

  res.setHeader("Content-Type", "image/png");

Step 4: Dynamic Content

Use query parameters or path parameters to customize the image based on the content of the page or post:

const { title } = req.query;
// Use 'title' to dynamically add text to your image

Step 5: Integrating with Your Pages

In your Next.js pages, update the <head> tag to use the dynamic OG image:

// pages/your-page.js
  {/* other meta tags */}


Dynamic OG images can significantly enhance your website's social media presence. By leveraging Next.js's API routes and image generation libraries, you can create unique and engaging visuals for each of your pages or posts.

Remember to test thoroughly, as OG image rendering can vary across different social platforms. Happy coding!