TypeScript icon, indicating that this package has built-in type declarations

1.1.3Β β€’Β PublicΒ β€’Β Published

πŸ”± React Super SEO

React SEO component that handles metadata so you don't have to.
Supports Google, OpenGraph, Twitter, and beyond. πŸš€

npm VersionΒ  View project on GitHubΒ  Deploy StatusΒ  Sponsor


Read the official documentation.


This component adds SEO (search engine optimization) metadata tags to the head element for you.

It includes full support for OpenGraph, Twitter Cards, and Google, as well as support for numerous popular meta tags, and any custom tags you might want to add beyond that!

Why Super SEO?

There are no less than a hundred different React SEO components floating around the web, and most have half-baked or zero support for OpenGraph, and many don't support Twitter Cards at all. Worse, documentation for them is sparse.

The goal of this project was to create the end all, be all, super SEO component for React.

This component supports OpenGraph and Twitter Cards fully, and includes TypeScript type definitions and fully documented code (including image size recommendations from the official specs) for an enjoyable coding experience. It also falls back where possible and infers MIME types automatically.

Is it super? You decide!

Features include:

  • πŸ”Œ Essential tags
    • Supports essential SEO tags like title, description, and more.
  • πŸ’― Full OpenGraph and Twitter Cards support
    • Control how your content appears on the most popular social networks.
  • πŸ’ Metadata fallback
    • OpenGraph and Twitter Cards fall back on title and description automatically.
  • πŸ•·οΈ Crawler configuration
    • Configure search engine crawlers with robots and googlebot.
  • βœ… Google site verification
    • Easily add your verification meta tag for Google Search Console.
  • βš’οΈ Custom meta tags
    • Need to include something else? Custom meta tags are quick and painless.
  • πŸ–ΌοΈ Automatic MIME type inference
    • Media MIME types are inferred automatically, meaning one less thing to configure.
  • ✨ TypeScript support and rich documentation
    • Includes full TypeScript type definitions and rich documentation, inside and out. Knowledge is power!


I hope this project makes your life a little easier! If it does and you'd like to show your appreciation, consider supporting the project with a coffee or sponsorship.

Your support helps keep the project going and will earn you some serious virtual high fives. Maybe even a virtual fist bump if you're feeling extra cool.

Sponsor via GitHub Buy me a coffee Buy me 3 coffees Buy me 5 coffees

Table of Contents


npm i react-super-seo

Quick Start

import { SuperSEO } from "react-super-seo";
  title="Home | React Super SEO"
  description="React SEO component with OpenGraph and Twitter Cards support."
    ogImage: {
      ogImage: "",
      ogImageAlt: "Kittens",
      ogImageWidth: 1200,
      ogImageHeight: 630,
      ogImageType: "image/jpeg",
    twitterSummaryCard: {
      summaryCardImage: "",
      summaryCardImageAlt: "Kittens",
      summaryCardSiteUsername: "justinmahar",

Custom Meta Tags

Wrap custom meta tags with SuperSEO. They will be rendered directly inside the head element.

  title="My Page"
  description="An awesome page that does a lot of cool stuff"
  <meta name="custom-meta" content="my-value" />
  <meta property="custom-meta-2" content="my-other-value" />

Refer to the SuperSEO component usage for all available options.


Type definitions have been included for TypeScript support.

Icon Attribution

Favicon by Twemoji.


Open source software is awesome and so are you. 😎

Feel free to submit a pull request for bugs or additions, and make sure to update tests as appropriate. If you find a mistake in the docs, send a PR! Even the smallest changes help.

For major changes, open an issue first to discuss what you'd like to change.

⭐ Found It Helpful? Star It!

If you found this project helpful, let the community know by giving it a star: πŸ‘‰β­



Package Sidebar


npm i react-super-seo

Weekly Downloads






Unpacked Size

126 kB

Total Files


Last publish


  • justinmahar