{"id":13423777,"url":"https://github.com/garmeeh/next-seo","last_synced_at":"2025-05-15T00:00:30.429Z","repository":{"id":37548459,"uuid":"137128945","full_name":"garmeeh/next-seo","owner":"garmeeh","description":"Next SEO is a plug in that makes managing your SEO easier in Next.js projects.","archived":false,"fork":false,"pushed_at":"2025-04-16T21:02:31.000Z","size":8566,"stargazers_count":7920,"open_issues_count":90,"forks_count":412,"subscribers_count":27,"default_branch":"master","last_synced_at":"2025-05-07T23:39:16.339Z","etag":null,"topics":["hacktoberfest","hacktoberfest-accepted","json-ld","nextjs","react","seo","typescript"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/garmeeh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"patreon":"garmeeh"}},"created_at":"2018-06-12T21:19:56.000Z","updated_at":"2025-05-06T15:21:07.000Z","dependencies_parsed_at":"2022-07-13T15:29:37.234Z","dependency_job_id":"cb44d68b-d055-4013-9733-4ddd87391121","html_url":"https://github.com/garmeeh/next-seo","commit_stats":{"total_commits":787,"total_committers":116,"mean_commits":"6.7844827586206895","dds":0.5146124523506989,"last_synced_commit":"2bc27917d8ca953d1e473761cf94bab232c1734a"},"previous_names":[],"tags_count":83,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garmeeh%2Fnext-seo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garmeeh%2Fnext-seo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garmeeh%2Fnext-seo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garmeeh%2Fnext-seo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/garmeeh","download_url":"https://codeload.github.com/garmeeh/next-seo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254249199,"owners_count":22039029,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","hacktoberfest-accepted","json-ld","nextjs","react","seo","typescript"],"created_at":"2024-07-31T00:00:42.243Z","updated_at":"2025-05-15T00:00:28.876Z","avatar_url":"https://github.com/garmeeh.png","language":"JavaScript","funding_links":["https://patreon.com/garmeeh","https://www.buymeacoffee.com/garmeeh"],"categories":["Extensions","JavaScript","TypeScript","Nextjs Plugins","SEO","🧰 React Toolkit","Tools","Other","🌐 Web Development - Frontend"],"sub_categories":["ORM","Search Engine Optimization"],"readme":"**SEObot — fully autonomous «SEO Robot» with AI agents**\n\nSEObot takes 100% of SEO work out of your way so that you can focus on building your product. [Try it now](https://seobotai.com/?ref=next-seo)\n\n[![image](https://github.com/user-attachments/assets/f9411f81-a9c9-4687-9e4a-7960db4093f2)](https://seobotai.com/?ref=next-seo)\n\n**Have you seen the new Next.js newsletter?**\n\n[\u003cimg alt=\"NextjsWeekly banner\" src=\"./next-js-weekly.png\"\u003e](https://dub.sh/nextjsweekly)\n\n**Useful Tools**\n\n- [dub](https://dub.co/?utm_source=next-seo\u0026utm_medium=social\u0026utm_campaign=next-seo) recently launched a useful Free UTM builder! You can use it [here](https://dub.sh/iKTxs7b)\n\n# Next SEO\n\n![npm](https://img.shields.io/npm/dw/next-seo?style=flat-square)\n\nNext SEO is a plugin that makes managing your SEO easier in Next.js projects.\n\nPull requests are very welcome. Also make sure to check out the issues for feature requests if you are\nlooking for inspiration on what to add.\n\n**Feel like supporting this free plugin?**\n\nIt takes a lot of time to maintain an open source project so any small contribution is greatly appreciated.\n\nCoffee fuels coding ☕️\n\n\u003ca href=\"https://www.buymeacoffee.com/garmeeh\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px !important;width: 217px !important;\" \u003e\u003c/a\u003e\n\n[next-seo.wallet](https://unstoppabledomains.com/d/next-seo.wallet) (ERC20 \u0026 SOL)\n\n**Note on app directory**\n\nThis note is only relevant if using the `app` directory.\n\nFor standard meta data (e.g., \u003cmeta\u003e, \u003ctitle\u003e) then it is highly recommended that you use the built-in `generateMetaData` method. You can check out the docs [here](https://beta.nextjs.org/docs/guides/seo#usage)\n\nFor JSON-LD then, the only change needed is to add `useAppDir={true}` to the JSON-LD component in use. You should add use this component in your `page.js` and NOT your `head.js`.\n\n```\n\u003cArticleJsonLd\n useAppDir={true}\n url=\"https://example.com/article\"\n title=\"Article headline\" \u003c- required for app directory\n /\u003e\n```\n\nIf you are using **`pages`** directory then `NextSeo` is **exactly what you need** for your SEO needs!\n\n### Table of Contents\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n- [Usage](#usage)\n - [Setup](#setup)\n - [Add SEO to Page](#add-seo-to-page)\n - [Default SEO Configuration](#default-seo-configuration)\n - [NextSeo Options](#nextseo-options)\n - [Title Template](#title-template)\n - [Default Title](#default-title)\n - [No Index](#no-index)\n - [dangerouslySetAllPagesToNoIndex](#dangerouslysetallpagestonoindex)\n - [No Follow](#no-follow)\n - [dangerouslySetAllPagesToNoFollow](#dangerouslysetallpagestonofollow)\n - [robotsProps](#robotsprops)\n - [Twitter](#twitter)\n - [Facebook](#facebook)\n - [Canonical URL](#canonical-url)\n - [Alternate](#alternate)\n - [Additional Meta Tags](#additional-meta-tags)\n - [Additional Link Tags](#additional-link-tags)\n- [Open Graph](#open-graph)\n - [Open Graph Examples](#open-graph-examples)\n - [Basic](#basic)\n - [Video](#video)\n - [Audio](#audio)\n - [Article](#article)\n - [Book](#book)\n - [Profile](#profile)\n- [JSON-LD](#json-ld)\n - [JSON-LD Security](#json-ld-security)\n - [Handling multiple instances](#handling-multiple-instances)\n - [Article](#article-1)\n - [Breadcrumb](#breadcrumb)\n - [Blog](#blog)\n - [Campground](#campground)\n - [Recipe](#recipe)\n - [Sitelinks Search Box](#sitelinks-search-box)\n - [Course](#course)\n - [Dataset](#dataset)\n - [Corporate Contact](#corporate-contact)\n - [FAQ Page](#faq-page)\n - [How-to](#how-to)\n - [Job Posting](#job-posting)\n - [Local Business](#local-business)\n - [Logo](#logo)\n - [Product](#product)\n - [Social Profile](#social-profile)\n - [News Article](#news-article)\n - [Park](#park)\n - [Video](#video-1)\n - [VideoGame](#videogame)\n - [Event](#event)\n - [Q\u0026A](#qa)\n - [Collection Page](#collection-page)\n - [Profile page](#profile-page)\n - [Carousel](#carousel)\n - [Default (Summary List)](#default-summary-list)\n - [Course](#course-1)\n - [Movie](#movie)\n - [Recipe](#recipe-1)\n - [Custom](#custom)\n - [Software App](#software-app)\n - [Organization](#organization)\n - [Brand](#brand)\n - [WebPage](#webpage)\n - [Image Metadata](#image-metadata)\n- [Contributors](#contributors)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n## Usage\n\n`NextSeo` works by including it on pages where you would like SEO attributes to be added. Once included on the page, you pass it a configuration object with the page's SEO properties. This can be dynamically generated at a page level, or in some cases, your API may return an SEO object.\n\n### Setup\n\nFirst, install it:\n\n```bash\nnpm install next-seo\n```\n\nor\n\n```bash\nyarn add next-seo\n```\n\n### Add SEO to Page\n\n---\n\n**Using Next.js app directory introduced in Next.js 13?**\n\nIf you are using the Next.js app directory, then it is highly recommended that you use the built-in `generateMetaData` method. You can check out the docs [here](https://beta.nextjs.org/docs/guides/seo#usage)\n\nIf you are using the `pages` directory, then `NextSeo` is exactly what you need for your SEO needs!\n\n---\n\nThen, you need to import `NextSeo` and add the desired properties. This will render out the tags in the `\u003chead\u003e` for SEO. At a bare minimum, you should add a title and description.\n\n**Example with just title and description:**\n\n```jsx\nimport { NextSeo } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003cNextSeo\n title=\"Simple Usage Example\"\n description=\"A short description goes here.\"\n /\u003e\n \u003cp\u003eSimple Usage\u003c/p\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\nBut `NextSeo` gives you many more options that you can add. See below for a typical example of a page.\n\n**Typical page example:**\n\n```jsx\nimport { NextSeo } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003cNextSeo\n title=\"Using More of Config\"\n description=\"This example uses more of the available config options.\"\n canonical=\"https://www.canonical.ie/\"\n openGraph={{\n url: 'https://www.url.ie/a',\n title: 'Open Graph Title',\n description: 'Open Graph Description',\n images: [\n {\n url: 'https://www.example.ie/og-image-01.jpg',\n width: 800,\n height: 600,\n alt: 'Og Image Alt',\n type: 'image/jpeg',\n },\n {\n url: 'https://www.example.ie/og-image-02.jpg',\n width: 900,\n height: 800,\n alt: 'Og Image Alt Second',\n type: 'image/jpeg',\n },\n { url: 'https://www.example.ie/og-image-03.jpg' },\n { url: 'https://www.example.ie/og-image-04.jpg' },\n ],\n siteName: 'SiteName',\n }}\n twitter={{\n handle: '@handle',\n site: '@site',\n cardType: 'summary_large_image',\n }}\n /\u003e\n \u003cp\u003eSEO Added to Page\u003c/p\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**A note on Twitter Tags**\n\nProps `cardType`, `site`, `handle` are equivalent to `twitter:card`, `twitter:site`, `twitter:creator`. Documentation can be found [here](https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/summary).\n\nTwitter will read the `og:title`, `og:image` and `og:description` tags for their card. `next-seo` omits `twitter:title`, `twitter:image` and `twitter:description` to avoid duplication.\n\nSome tools may report this as an error. See [Issue #14](https://github.com/garmeeh/next-seo/issues/14)\n\n### Default SEO Configuration\n\n`NextSeo` enables you to set some default SEO properties that will appear on all pages without needing to include anything on them. You can also override these on a page-by-page basis if needed.\n\nTo achieve this, you will need to create a custom `\u003cApp\u003e`. In your pages directory, create a new file, `_app.js`. See the Next.js docs [here](https://nextjs.org/docs/advanced-features/custom-app) for more info on a custom `\u003cApp\u003e`.\n\nWithin this file you will need to import `DefaultSeo` from `next-seo` and pass it props.\n\nHere is a typical example:\n\n```jsx\nimport App, { Container } from 'next/app';\nimport { DefaultSeo } from 'next-seo';\n\n// import your default seo configuration\nimport SEO from '../next-seo.config';\n\nexport default class MyApp extends App {\n render() {\n const { Component, pageProps } = this.props;\n return (\n \u003cContainer\u003e\n \u003cDefaultSeo\n openGraph={{\n type: 'website',\n locale: 'en_IE',\n url: 'https://www.url.ie/',\n siteName: 'SiteName',\n }}\n twitter={{\n handle: '@handle',\n site: '@site',\n cardType: 'summary_large_image',\n }}\n /\u003e\n \u003cComponent {...pageProps} /\u003e\n \u003c/Container\u003e\n );\n }\n}\n```\n\nTo work properly, `DefaultSeo` should be placed above (before) `Component` due to the behavior of Next.js internals.\n\nAlternatively, you can also create a config file to store default values such as `next-seo.config.js`\n\n```js\nexport default {\n openGraph: {\n type: 'website',\n locale: 'en_IE',\n url: 'https://www.url.ie/',\n siteName: 'SiteName',\n },\n twitter: {\n handle: '@handle',\n site: '@site',\n cardType: 'summary_large_image',\n },\n};\n```\n\n\u003cdetails\u003e\u003csummary\u003eor like this, if you are using TypeScript\u003c/summary\u003e\n\u003cp\u003e\n\n```ts\nimport { DefaultSeoProps } from 'next-seo';\n\nconst config: DefaultSeoProps = {\n openGraph: {\n type: 'website',\n locale: 'en_IE',\n url: 'https://www.url.ie/',\n siteName: 'SiteName',\n },\n twitter: {\n handle: '@handle',\n site: '@site',\n cardType: 'summary_large_image',\n },\n};\n\nexport default config;\n```\n\n\u003c/p\u003e\n\u003c/details\u003e\n\nimport at the top of `_app.js`\n\n```jsx\nimport SEO from '../next-seo.config';\n```\n\nand the `DefaultSeo` component can be used like this instead\n\n```jsx\n\u003cDefaultSeo {...SEO} /\u003e\n```\n\nFrom now on, all of your pages will have the defaults above applied.\n\n**Note that `Container` is deprecated in Next.js v9.0.4 so you should replace that component here with `React.Fragment` on this version and later - see [here](https://github.com/zeit/next.js/blob/master/errors/app-container-deprecated.md)**\n\n### NextSeo Options\n\n| Property | Type | Description |\n| ---------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `titleTemplate` | string | Allows you to set default title template that will be added to your title [More Info](#title-template) |\n| `title` | string | Set the meta title of the page |\n| `defaultTitle` | string | If no title is set on a page, this string will be used instead of an empty `titleTemplate` [More Info](#default-title) |\n| `noindex` | boolean (default false) | Sets whether page should be indexed or not [More Info](#no-index) |\n| `nofollow` | boolean (default false) | Sets whether page should be followed or not [More Info](#no-follow) |\n| `robotsProps` | Object | Set the more meta information for the `X-Robots-Tag` [More Info](#robotsprops) |\n| `description` | string | Set the page meta description |\n| `canonical` | string | Set the page canonical url |\n| `mobileAlternate.media` | string | Set what screen size the mobile website should be served from |\n| `mobileAlternate.href` | string | Set the mobile page alternate url |\n| `languageAlternates` | array | Set the language of the alternate urls. Expects array of objects with the shape: `{ hrefLang: string, href: string }` |\n| `themeColor` | string | Indicates a suggested color that user agents should use to customize the display of the page or of the surrounding user interface. Must contain a valid CSS color |\n| `additionalMetaTags` | array | Allows you to add a meta tag that is not documented here. [More Info](#additional-meta-tags) |\n| `additionalLinkTags` | array | Allows you to add a link tag that is not documented here. [More Info](#additional-link-tags) |\n| `twitter.cardType` | string | The card type, which will be one of `summary`, `summary_large_image`, `app`, or `player` |\n| `twitter.site` | string | @username for the website used in the card footer |\n| `twitter.handle` | string | @username for the content creator / author (outputs as `twitter:creator`) |\n| `facebook.appId` | string | Used for Facebook Insights, you must add a facebook app ID to your page to for it [More Info](#facebook) |\n| `openGraph.url` | string | The canonical URL of your object that will be used as its permanent ID in the graph |\n| `openGraph.type` | string | The type of your object. Depending on the type you specify, other properties may also be required [More Info](#open-graph) |\n| `openGraph.title` | string | The open graph title, this can be different than your meta title. |\n| `openGraph.description` | string | The open graph description, this can be different than your meta description. |\n| `openGraph.images` | array | An array of images (object) to be used by social media platforms, slack etc as a preview. If multiple supplied you can choose one when sharing. [See Examples](#open-graph-examples) |\n| `openGraph.videos` | array | An array of videos (object) |\n| `openGraph.locale` | string | The locale the open graph tags are marked up in. Of the format language_TERRITORY. Default is en_US. |\n| `openGraph.siteName` | string | If your object is part of a larger web site, the name which should be displayed for the overall site. |\n| `openGraph.profile.firstName` | string | Person's first name. |\n| `openGraph.profile.lastName` | string | Person's last name. |\n| `openGraph.profile.username` | string | Person's username. |\n| `openGraph.profile.gender` | string | Person's gender. |\n| `openGraph.book.authors` | string[] | Writers of the article. [See Examples](#open-graph-examples) |\n| `openGraph.book.isbn` | string | The [ISBN](https://en.wikipedia.org/wiki/International_Standard_Book_Number) |\n| `openGraph.book.releaseDate` | datetime | The date the book was released. |\n| `openGraph.book.tags` | string[] | Tag words associated with this book. |\n| `openGraph.article.publishedTime` | datetime | When the article was first published. [See Examples](#open-graph-examples) |\n| `openGraph.article.modifiedTime` | datetime | When the article was last changed. |\n| `openGraph.article.expirationTime` | datetime | When the article is out of date after. |\n| `openGraph.article.authors` | string[] | Writers of the article. |\n| `openGraph.article.section` | string | A high-level section name. E.g. Technology |\n| `openGraph.article.tags` | string[] | Tag words associated with this article. |\n\n#### Title Template\n\nReplaces `%s` with your title string\n\n```js\ntitle = 'This is my title';\ntitleTemplate = 'Next SEO | %s';\n// outputs: Next SEO | This is my title\n```\n\n```js\ntitle = 'This is my title';\ntitleTemplate = '%s | Next SEO';\n// outputs: This is my title | Next SEO\n```\n\n#### Default Title\n\n```js\ntitle = undefined;\ntitleTemplate = 'Next SEO | %s';\ndefaultTitle = 'Next SEO';\n// outputs: Next SEO\n```\n\n#### No Index\n\nSetting this to `true` will set `noindex,follow` (to set `nofollow`, please refer to [`nofollow`](#no-follow)). This works on a page by page basis. This property works in tandem with the `nofollow` property and together they populate the `robots` meta tag.\n\n**Note:** The `noindex` and the [`nofollow`](#no-follow) properties are a little different than all the others in the sense that setting them as a default does not work as expected. This is due to the fact Next SEO already has a default of `index,follow` because `next-seo` is a SEO plugin after all. So if you want to globally these properties, please see [dangerouslySetAllPagesToNoIndex](#dangerouslySetAllPagesToNoIndex) and [dangerouslySetAllPagesToNoFollow](#dangerouslySetAllPagesToNoFollow).\n\n**Example No Index on a single page:**\n\nIf you have a single page that you want no indexed you can achieve this by:\n\n```jsx\nimport { NextSeo } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003cNextSeo noindex={true} /\u003e\n \u003cp\u003eThis page is no indexed\u003c/p\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n\n/*\n\u003cmeta name=\"robots\" content=\"noindex,follow\"\u003e\n*/\n```\n\n#### dangerouslySetAllPagesToNoIndex\n\nIt has the prefix `dangerously` because it will `noindex` all pages. As this is an SEO plugin, that is kinda dangerous action. It is **not** bad to use this. Just please be sure you want to `noindex` **EVERY** page. You can still override this at a page level if you have a use case to `index` a page. This can be done by setting `noindex: false`.\n\nThe only way to unset this is by removing the prop from the `DefaultSeo` in your custom `\u003cApp\u003e`.\n\n#### No Follow\n\nSetting this to `true` will set `index,nofollow` (to set `noindex`, please refer to [`noindex`](#no-index)). This works on a page-by-page basis. This property works in tandem with the `noindex` property, and together, they populate the `robots` meta tag.\n\n**Note:** Unlike for the other properties, setting `noindex` and `nofollow` by default does not work as expected. This is because Next SEO has a default of `index,follow`, since `next-seo` is an SEO plugin after all. If you want to globally allow these properties, see [dangerouslySetAllPagesToNoIndex](#dangerouslySetAllPagesToNoIndex) and [dangerouslySetAllPagesToNoFollow](#dangerouslySetAllPagesToNoFollow).\n\n**Example No Follow on a single page:**\n\nIf you have a single page that you want no indexed you can achieve this by:\n\n```jsx\nimport { NextSeo } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003cNextSeo nofollow={true} /\u003e\n \u003cp\u003eThis page is not followed\u003c/p\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n\n/*\n\u003cmeta name=\"robots\" content=\"index,nofollow\"\u003e\n*/\n```\n\n#### dangerouslySetAllPagesToNoFollow\n\nIt has the prefix of `dangerously` because it will `nofollow` all pages. As this is an SEO plugin, that is kinda dangerous action. It is **not** bad to use this. Just please be sure you want to `nofollow` **EVERY** page. You can still override this at a page level if you have a use case to `follow` a page. This can be done by setting `nofollow: false`.\n\nThe only way to unset this, is by removing the prop from the `DefaultSeo` in your custom `\u003cApp\u003e`.\n\n| `noindex` | `nofollow` | `meta` content of `robots` |\n| --------- | ---------- | -------------------------- |\n| -- | -- | `index,follow` (default) |\n| false | false | `index,follow` |\n| true | -- | `noindex,follow` |\n| true | false | `noindex,follow` |\n| -- | true | `index,nofollow` |\n| false | true | `index,nofollow` |\n| true | true | `noindex,nofollow` |\n\n#### robotsProps\n\nIn addition to `index, follow` the `robots` meta tag accepts more properties to archive a more accurate crawling and serve better snippets for SEO bots that crawl your page.\n\nExample:\n\n```jsx\nimport { NextSeo } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003cNextSeo\n robotsProps={{\n nosnippet: true,\n notranslate: true,\n noimageindex: true,\n noarchive: true,\n maxSnippet: -1,\n maxImagePreview: 'none',\n maxVideoPreview: -1,\n }}\n /\u003e\n \u003cp\u003eAdditional robots props in Next-SEO!!\u003c/p\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n\n/*\n\u003cmeta name=\"robots\" content=\"index,follow,nosnippet,max-snippet:-1,max-image-preview:none,noarchive,noimageindex,max-video-preview:-1,notranslate\"\u003e\n*/\n```\n\n**Available properties**\n\n| Property | Type | Description |\n| ------------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `noarchive` | boolean | Do not show a [cached link](https://support.google.com/websearch/answer/1687222) in search results. |\n| `nosnippet` | boolean | Do not show a text snippet or video preview in the search results for this page. |\n| `max-snippet` | number | Use a maximum of [number] characters as a textual snippet for this search result. [Read more](https://developers.google.com/search/reference/robots_meta_tag?hl=en-GB#directives) |\n| `max-image-preview` | 'none','standard','large' | Set the maximum size of an image preview for this page in a search results. |\n| `max-video-preview` | number | Use a maximum of [number] seconds as a video snippet for videos on this page in search results. [Read more](https://developers.google.com/search/reference/robots_meta_tag?hl=en-GB#directives) |\n| `notranslate` | boolean | Do not offer translation of this page in search results. |\n| `noimageindex` | boolean | Do not index images on this page. |\n| `unavailable_after` | string | Do not show this page in search results after the specified date/time. The date/time must be specified in a widely adopted format including, but not limited to RFC 822, RFC 850, and ISO 8601. |\n\nFor more reference about the `X-Robots-Tag` visit [Google Search Central - Control Crawling and Indexing](https://developers.google.com/search/reference/robots_meta_tag?hl=en-GB#directives)\n\n#### Twitter\n\nTwitter will read the `og:title`, `og:image` and `og:description` tags for their card, this is why `next-seo` omits `twitter:title`, `twitter:image` and `twitter:description` so not to duplicate.\n\nSome tools may report this as an error. See [Issue #14](https://github.com/garmeeh/next-seo/issues/14)\n\n#### Facebook\n\n```jsx\nfacebook={{\n appId: '1234567890',\n}}\n```\n\nAdd this to your SEO config to include the fb:app_id meta if you need to enable Facebook insights for your site. Information regarding this can be found in Facebook's [documentation](https://developers.facebook.com/docs/sharing/webmasters/)\n\n#### Canonical URL\n\nAdd this on a page-per-page basis when you want to consolidate duplicate URLs.\n\n```js\ncanonical = 'https://www.canonical.ie/';\n```\n\n#### Alternate\n\nThis link relation is used to indicate a relation between a desktop and a mobile website to search engines.\n\nExample:\n\n```jsx\nmobileAlternate={{\n media: 'only screen and (max-width: 640px)',\n href: 'https://m.canonical.ie',\n}}\n```\n\n```jsx\nlanguageAlternates={[{\n hrefLang: 'de-AT',\n href: 'https://www.canonical.ie/de',\n}]}\n```\n\n#### Additional Meta Tags\n\nThis allows you to add any other meta tags that are not covered in the `config` and\nshould be used instead of `children` prop.\n\n`content` is required. Then either `name`, `property` or `httpEquiv`. (Only one on each)\n\nExample:\n\n```js\nadditionalMetaTags={[{\n property: 'dc:creator',\n content: 'Jane Doe'\n}, {\n name: 'application-name',\n content: 'NextSeo'\n}, {\n httpEquiv: 'x-ua-compatible',\n content: 'IE=edge; chrome=1'\n}]}\n```\n\nInvalid Examples:\n\nThese are invalid as they contain more than one of `name`, `property` and `httpEquiv` on the same entry.\n\n```js\nadditionalMetaTags={[{\n property: 'dc:creator',\n name: 'dc:creator',\n content: 'Jane Doe'\n}, {\n property: 'application-name',\n httpEquiv: 'application-name',\n content: 'NextSeo'\n}]}\n```\n\nOne thing to note on this is that it currently only supports unique tags unless you use the `keyOverride` prop to provide a unique [key](https://reactjs.org/docs/lists-and-keys.html#keys) to each additional meta tag.\n\nThe default behaviour (without a `keyOverride` prop) is to render one tag per unique `name` / `property` / `httpEquiv`. The last one defined will be rendered.\n\nFor example, if you pass 2 tags with the same `property`:\n\n```js\nadditionalMetaTags={[{\n property: 'dc:creator',\n content: 'Joe Bloggs'\n}, {\n property: 'dc:creator',\n content: 'Jane Doe'\n}]}\n```\n\nit will result in this being rendered:\n\n```html\n\u003cmeta property=\"dc:creator\" content=\"Jane Doe\" /\u003e\n```\n\nProviding an additional `keyOverride` property like this:\n\n```js\nadditionalMetaTags={[{\n property: 'dc:creator',\n content: 'Joe Bloggs',\n keyOverride: 'creator1',\n}, {\n property: 'dc:creator',\n content: 'Jane Doe',\n keyOverride: 'creator2',\n}]}\n```\n\nresults in the correct HTML being rendered:\n\n```html\n\u003cmeta property=\"dc:creator\" content=\"Joe Bloggs\" /\u003e\n\u003cmeta property=\"dc:creator\" content=\"Jane Doe\" /\u003e\n```\n\n#### Additional Link Tags\n\nThis allows you to add any other link tags that are not covered in the `config`.\n\n`rel` and `href` is required.\n\nExample:\n\n```js\nadditionalLinkTags={[\n {\n rel: 'icon',\n href: 'https://www.test.ie/favicon.ico',\n },\n {\n rel: 'apple-touch-icon',\n href: 'https://www.test.ie/touch-icon-ipad.jpg',\n sizes: '76x76'\n },\n {\n rel: 'manifest',\n href: '/manifest.json'\n },\n {\n rel: 'preload',\n href: 'https://www.test.ie/font/sample-font.woof2',\n as: 'font',\n type: 'font/woff2',\n crossOrigin: 'anonymous'\n }\n]}\n```\n\nit will result in this being rendered:\n\n```html\n\u003clink rel=\"icon\" href=\"https://www.test.ie/favicon.ico\" /\u003e\n\u003clink\n rel=\"apple-touch-icon\"\n href=\"https://www.test.ie/touch-icon-ipad.jpg\"\n sizes=\"76x76\"\n/\u003e\n\u003clink rel=\"manifest\" href=\"/manifest.json\" /\u003e\n\u003clink\n rel=\"preload\"\n href=\"https://www.test.ie/font/sample-font.woof2\"\n as=\"font\"\n type=\"font/woff2\"\n crossorigin=\"anonymous\"\n/\u003e\n```\n\n## Open Graph\n\nFor the full specification please check out \u003chttp://ogp.me/\u003e\n\nNext SEO currently supports:\n\n- [basic](#basic)\n- [video](#video)\n- [article](#article)\n- [book](#book)\n- [profile](#profile)\n\n### Open Graph Examples\n\n#### Basic\n\n```jsx\nimport { NextSeo } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003cNextSeo\n openGraph={{\n type: 'website',\n url: 'https://www.example.com/page',\n title: 'Open Graph Title',\n description: 'Open Graph Description',\n images: [\n {\n url: 'https://www.example.ie/og-image.jpg',\n width: 800,\n height: 600,\n alt: 'Og Image Alt',\n },\n {\n url: 'https://www.example.ie/og-image-2.jpg',\n width: 800,\n height: 600,\n alt: 'Og Image Alt 2',\n },\n ],\n }}\n /\u003e\n \u003cp\u003eBasic\u003c/p\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Note**\n\nMultiple images are available from next.js version `7.0.0-canary.0`\n\nFor versions `6.0.0` - `7.0.0-canary.0` you just need to supply a single item array:\n\n```js\nimages: [\n {\n url: 'https://www.example.ie/og-image-01.jpg',\n width: 800,\n height: 600,\n alt: 'Og Image Alt',\n },\n],\n```\n\nSupplying multiple images will not break anything, but only one will be added to the head.\n\n#### Video\n\nFull info on [http://ogp.me/](http://ogp.me/#type_video)\n\n```jsx\nimport { NextSeo } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003cNextSeo\n title=\"Video Page Title\"\n description=\"Description of video page\"\n openGraph={{\n title: 'Open Graph Video Title',\n description: 'Description of open graph video',\n url: 'https://www.example.com/videos/video-title',\n type: 'video.movie',\n video: {\n // Multiple Open Graph actors is only available in version `7.0.2-canary.35`+ of next\n actors: [\n {\n profile: 'https://www.example.com/actors/@firstnameA-lastnameA',\n role: 'Protagonist',\n },\n {\n profile: 'https://www.example.com/actors/@firstnameB-lastnameB',\n role: 'Antagonist',\n },\n ],\n // Multiple Open Graph directors is only available in version `7.0.2-canary.35`+ of next\n directors: [\n 'https://www.example.com/directors/@firstnameA-lastnameA',\n 'https://www.example.com/directors/@firstnameB-lastnameB',\n ],\n // Multiple Open Graph writers is only available in version `7.0.2-canary.35`+ of next\n writers: [\n 'https://www.example.com/writers/@firstnameA-lastnameA',\n 'https://www.example.com/writers/@firstnameB-lastnameB',\n ],\n duration: 680000,\n releaseDate: '2022-12-21T22:04:11Z',\n // Multiple Open Graph tags is only available in version `7.0.2-canary.35`+ of next\n tags: ['Tag A', 'Tag B', 'Tag C'],\n },\n siteName: 'SiteName',\n }}\n /\u003e\n \u003ch1\u003eVideo Page SEO\u003c/h1\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Note**\n\nMultiple images are available from next.js version `7.0.0-canary.0`\n\nFor versions `6.0.0` - `7.0.0-canary.0` you just need to supply a single item array:\n\n```js\nimages: [\n {\n url: 'https://www.example.ie/og-image-01.jpg',\n width: 800,\n height: 600,\n alt: 'Og Image Alt',\n },\n],\n```\n\nSupplying multiple images will not break anything, but only one will be added to the head.\n\n#### Audio\n\nFull info on [http://ogp.me/](https://ogp.me/#structured)\n\n```jsx\nimport { NextSeo } from 'next-seo';\nconst Page = () =\u003e (\n \u003c\u003e\n \u003cNextSeo\n title=\"Audio Page Title\"\n description=\"Description of audio page\"\n openGraph={{\n title: 'Open Graph Audio',\n description: 'Description of open graph audio',\n url: 'https://www.example.com/audio/audio',\n audio: [\n {\n url: 'http://examples.opengraphprotocol.us/media/audio/1khz.mp3',\n secureUrl: 'https://d72cgtgi6hvvl.cloudfront.net/media/audio/1khz.mp3',\n type: \"audio/mpeg\"\n },\n {\n url: 'http://examples.opengraphprotocol.us/media/audio/250hz.mp3',\n secureUrl: 'https://d72cgtgi6hvvl.cloudfront.net/media/audio/250hz.mp3',\n type: \"audio/mpeg\"\n },\n ]\n site_name: 'SiteName',\n }}\n /\u003e\n \u003ch1\u003eAudio Page SEO\u003c/h1\u003e\n \u003c/\u003e\n);\nexport default Page;\n```\n\n#### Article\n\n```jsx\nimport { NextSeo } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003cNextSeo\n openGraph={{\n title: 'Open Graph Article Title',\n description: 'Description of open graph article',\n url: 'https://www.example.com/articles/article-title',\n type: 'article',\n article: {\n publishedTime: '2017-06-21T23:04:13Z',\n modifiedTime: '2018-01-21T18:04:43Z',\n expirationTime: '2022-12-21T22:04:11Z',\n section: 'Section II',\n authors: [\n 'https://www.example.com/authors/@firstnameA-lastnameA',\n 'https://www.example.com/authors/@firstnameB-lastnameB',\n ],\n tags: ['Tag A', 'Tag B', 'Tag C'],\n },\n images: [\n {\n url: 'https://www.test.ie/images/cover.jpg',\n width: 850,\n height: 650,\n alt: 'Photo of text',\n },\n ],\n }}\n /\u003e\n \u003cp\u003eArticle\u003c/p\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Note**\n\nMultiple images, authors, and tags are available from next.js version `7.0.0-canary.0`\n\nFor versions `6.0.0` - `7.0.0-canary.0` you just need to supply a single item array:\n\n`images:`\n\n```js\nimages: [\n {\n url: 'https://www.example.ie/og-image-01.jpg',\n width: 800,\n height: 600,\n alt: 'Og Image Alt',\n },\n],\n```\n\n`authors:`\n\n```js\nauthors: [\n 'https://www.example.com/authors/@firstnameA-lastnameA',\n],\n```\n\n`tags:`\n\n```js\ntags: ['Tag A'],\n```\n\nSupplying multiple of any of the above will not break anything, but only one will be added to the head.\n\n#### Book\n\n```jsx\nimport { NextSeo } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003cNextSeo\n openGraph={{\n title: 'Open Graph Book Title',\n description: 'Description of open graph book',\n url: 'https://www.example.com/books/book-title',\n type: 'book',\n book: {\n releaseDate: '2018-09-17T11:08:13Z',\n isbn: '978-3-16-148410-0',\n authors: [\n 'https://www.example.com/authors/@firstnameA-lastnameA',\n 'https://www.example.com/authors/@firstnameB-lastnameB',\n ],\n tags: ['Tag A', 'Tag B', 'Tag C'],\n },\n images: [\n {\n url: 'https://www.test.ie/images/book.jpg',\n width: 850,\n height: 650,\n alt: 'Cover of the book',\n },\n ],\n }}\n /\u003e\n \u003cp\u003eBook\u003c/p\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Note**\n\nMultiple images, authors, and tags are available from next.js version `7.0.0-canary.0`\n\nFor versions `6.0.0` - `7.0.0-canary.0` you just need to supply a single item array:\n\n`images:`\n\n```js\nimages: [\n {\n url: 'https://www.example.ie/og-image-01.jpg',\n width: 800,\n height: 600,\n alt: 'Og Image Alt',\n },\n],\n```\n\n`authors:`\n\n```js\nauthors: [\n 'https://www.example.com/authors/@firstnameA-lastnameA',\n],\n```\n\n`tags:`\n\n```js\ntags: ['Tag A'],\n```\n\nSupplying multiple of any of the above will not break anything, but only one will be added to the head.\n\n#### Profile\n\n```jsx\nimport { NextSeo } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003cNextSeo\n openGraph={{\n title: 'Open Graph Profile Title',\n description: 'Description of open graph profile',\n url: 'https://www.example.com/@firstlast123',\n type: 'profile',\n profile: {\n firstName: 'First',\n lastName: 'Last',\n username: 'firstlast123',\n gender: 'female',\n },\n images: [\n {\n url: 'https://www.test.ie/images/profile.jpg',\n width: 850,\n height: 650,\n alt: 'Profile Photo',\n },\n ],\n }}\n /\u003e\n \u003cp\u003eProfile\u003c/p\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Note**\n\nMultiple images are available from next.js version `7.0.0-canary.0`\n\nFor versions `6.0.0` - `7.0.0-canary.0` you just need to supply a single item array:\n\n```js\nimages: [\n {\n url: 'https://www.example.ie/og-image-01.jpg',\n width: 800,\n height: 600,\n alt: 'Og Image Alt',\n },\n],\n```\n\nSupplying multiple images will not break anything, but only one will be added to the head.\n\n## JSON-LD\n\nNext SEO now has the ability to set JSON-LD a form of structured data. Structured data is a standardized format for providing information about a page and classifying the page content.\n\nGoogle has excellent content on JSON-LD -\u003e [HERE](https://developers.google.com/search/docs/data-types/article)\n\n**If using the app directory then please ensure to add `useAppDir={true}` prop and that you are using the component in the `page.js`**\n\nBelow you will find a very basic page implementing each of the available JSON-LD types:\n\n- [Article](#article-1)\n- [Breadcrumb](#breadcrumb)\n- [Blog](#blog)\n- [Campground](#campground)\n- [Recipe](#recipe)\n- [Sitelinks Search Box](#sitelinks-search-box)\n- [Course](#course)\n- [Dataset](#dataset)\n- [Corporate Contact](#corporate-contact)\n- [FAQ Page](#faq-page)\n- [How-to](#how-to)\n- [Job Posting](#job-posting)\n- [Local Business](#local-business)\n- [Product](#product)\n- [Social Profile](#social-profile)\n- [News Article](#news-article)\n- [Park](#park)\n\nPull requests are very welcome to add any from the list [found here](https://developers.google.com/search/docs/data-types/article)\n\n#### JSON-LD Security\n\nJust a quick note on security. To get JSON-LD onto the page it needs to be in a script tag. `next-seo` achieves this by using a script tag with `dangerouslySetInnerHTML`.\n\nSo if passing anything directly from a URL to one of the components below please ensure you sanitize it first if needed.\n\nView `toJson.tsx` for implementation detail.\n\n#### Handling multiple instances\n\nIf your page requires multiple instances of a given JSON-LD component, you can specify unique `keyOverride` properties, and `next-seo` will handle the rest.\n\nThis comes in handy for blog rolls, search results, and overview pages.\n\nPlease fully research when you should and shouldn't add multiple instances of JSON-LD.\n\n```jsx\n\u003cExampleJsonLd keyOverride=\"my-new-key\" /\u003e\n```\n\n### Article\n\n```jsx\nimport { ArticleJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eArticle JSON-LD\u003c/h1\u003e\n \u003cArticleJsonLd\n useAppDir={false}\n url=\"https://example.com/article\"\n title=\"Article headline\"\n images={[\n 'https://example.com/photos/1x1/photo.jpg',\n 'https://example.com/photos/4x3/photo.jpg',\n 'https://example.com/photos/16x9/photo.jpg',\n ]}\n datePublished=\"2015-02-05T08:00:00+08:00\"\n dateModified=\"2015-02-05T09:00:00+08:00\"\n authorName={[\n {\n name: 'Jane Blogs',\n url: 'https://example.com',\n },\n {\n name: 'Mary Stone',\n url: 'https://example.com',\n },\n ]}\n publisherName=\"Gary Meehan\"\n publisherLogo=\"https://www.example.com/photos/logo.jpg\"\n description=\"This is a mighty good description of this article.\"\n isAccessibleForFree={true}\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n### Breadcrumb\n\n```jsx\nimport { BreadcrumbJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eBreadcrumb JSON-LD\u003c/h1\u003e\n \u003cBreadcrumbJsonLd\n itemListElements={[\n {\n position: 1,\n name: 'Books',\n item: 'https://example.com/books',\n },\n {\n position: 2,\n name: 'Authors',\n item: 'https://example.com/books/authors',\n },\n {\n position: 3,\n name: 'Ann Leckie',\n item: 'https://example.com/books/authors/annleckie',\n },\n {\n position: 4,\n name: 'Ancillary Justice',\n item: 'https://example.com/books/authors/ancillaryjustice',\n },\n ]}\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Required properties**\n\n| Property | Info |\n| --------------------------- | -------------------------------------------------------------------------------------------------------- |\n| `itemListElements` | |\n| `itemListElements.position` | The position of the breadcrumb in the breadcrumb trail. Position 1 signifies the beginning of the trail. |\n| `itemListElements.name` | The title of the breadcrumb displayed for the user. |\n| `itemListElements.item` | The URL to the webpage that represents the breadcrumb. |\n\n**Other**\n| `useAppDir` | This should be set to true if using the new app directory. Not required if outside of the app directory. |\n\n### Blog\n\n```jsx\nimport { ArticleJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eBlog JSON-LD\u003c/h1\u003e\n \u003cArticleJsonLd\n type=\"BlogPosting\"\n url=\"https://example.com/blog\"\n title=\"Blog headline\"\n images={[\n 'https://example.com/photos/1x1/photo.jpg',\n 'https://example.com/photos/4x3/photo.jpg',\n 'https://example.com/photos/16x9/photo.jpg',\n ]}\n datePublished=\"2015-02-05T08:00:00+08:00\"\n dateModified=\"2015-02-05T09:00:00+08:00\"\n authorName=\"Jane Blogs\"\n description=\"This is a mighty good description of this blog.\"\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n### Campground\n\n```jsx\nimport { CampgroundJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eCampground JSON-LD\u003c/h1\u003e\n \u003cCampgroundJsonLd\n id=\"https://www.example.com/campground/rip-van-winkle-campground\"\n name=\"Rip Van Winkle Campgrounds\"\n url=\"https://www.example.com/campground\"\n telephone=\"+18452468114\"\n images={['https://example.com/photos/1x1/photo.jpg']}\n address={{\n streetAddress: '149 Blue Mountain Rd',\n addressLocality: 'Saugerties',\n addressRegion: 'NY',\n postalCode: '12477',\n addressCountry: 'US',\n }}\n description=\"Description about Rip Van Winkle Campgrounds\"\n geo={{\n latitude: '42.092599',\n longitude: '-74.018580',\n }}\n openingHours={[\n {\n opens: '09:00',\n closes: '17:00',\n dayOfWeek: [\n 'Monday',\n 'Tuesday',\n 'Wednesday',\n 'Thursday',\n 'Friday',\n 'Saturday',\n 'Sunday',\n ],\n validFrom: '2019-12-23',\n validThrough: '2020-04-02',\n },\n ]}\n petsAllowed\n rating={{\n ratingValue: '5',\n ratingCount: '18',\n }}\n amenityFeature={{\n name: 'Showers',\n value: true,\n }}\n priceRange=\"$$\"\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Required properties**\n\n| Property | Info |\n| ------------------------- | ------------------------------------------------------------------- |\n| `@id` | Globally unique ID of the specific campground in the form of a URL. |\n| `address` | Address of the specific campground location |\n| `address.addressCountry` | The 2-letter ISO 3166-1 alpha-2 country code |\n| `address.addressLocality` | City |\n| `address.addressRegion` | State or province, if applicable. |\n| `address.postalCode` | Postal or zip code. |\n| `address.streetAddress` | Street number, street name, and unit number. |\n| `name` | Campground name. |\n| `description` | Campground description. |\n\n**Supported properties**\n\n| Property | Info |\n| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `geo` | Geographic coordinates of the campground. |\n| `geo.latitude` | The latitude of the campground location |\n| `geo.longitude` | The longitude of the campground location |\n| `images` | An image or images of the campground. Required for valid markup depending on the type |\n| `telephone` | A campground phone number meant to be the primary contact method for customers. |\n| `url` | The fully-qualified URL of the specific campground. |\n| `openingHours` | Opening hour specification of the campground. You can provide this as a single object, or an array of objects with the properties below. |\n| `openingHours.opens` | The opening hour of the place or service on the given day(s) of the week. |\n| `openingHours.closes` | The closing hour of the place or service on the given day(s) of the week. |\n| `openingHours.dayOfWeek` | The day of the week for which these opening hours are valid. Can be a string or array of strings. Refer to [DayOfWeek](https://schema.org/DayOfWeek) |\n| `openingHours.validFrom` | The date when the item becomes valid. |\n| `openingHours.validThrough` | The date after when the item is not valid. |\n| `isAccessibleForFree` | Whether or not the campground is accessible for free. |\n| `petsAllowed` | Whether or not the campgroud allows pets. |\n| `amenityFeature` | An amenity feature (e.g. a characteristic or service) of the campground. |\n| `amenityFeature.name` | The name of the amenity. |\n| `amenityFeature.value` | The value of the amenity. |\n| `priceRange` | The price range of the campground, for example $$$. |\n| `rating` | The average rating of the campground based on multiple ratings or reviews. |\n| `rating.ratingValue` | The rating for the content. |\n| `rating.ratingCount` | The count of total number of ratings. |\n\n**Other**\n| `useAppDir` | This should be set to true if using the new app directory. Not required if outside of the app directory. |\n\n### Recipe\n\n```jsx\nimport { RecipeJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eRecipe JSON-LD\u003c/h1\u003e\n \u003cRecipeJsonLd\n name=\"Party Coffee Cake\"\n description=\"This coffee cake is awesome and perfect for parties.\"\n datePublished=\"2018-03-10\"\n authorName={['Jane Blogs', 'Mary Stone']}\n prepTime=\"PT20M\"\n cookTime=\"PT30M\"\n totalTime=\"PT50M\"\n keywords=\"cake for a party, coffee\"\n yields=\"10\"\n category=\"Dessert\"\n cuisine=\"American\"\n calories={270}\n images={[\n 'https://example.com/photos/1x1/photo.jpg',\n 'https://example.com/photos/4x3/photo.jpg',\n 'https://example.com/photos/16x9/photo.jpg',\n ]}\n ingredients={[\n '2 cups of flour',\n '3/4 cup white sugar',\n '2 teaspoons baking powder',\n '1/2 teaspoon salt',\n '1/2 cup butter',\n '2 eggs',\n '3/4 cup milk',\n ]}\n instructions={[\n {\n name: 'Preheat',\n text: 'Preheat the oven to 350 degrees F. Grease and flour a 9x9 inch pan.',\n url: 'https://example.com/party-coffee-cake#step1',\n image: 'https://example.com/photos/party-coffee-cake/step1.jpg',\n },\n ]}\n aggregateRating={{\n ratingValue: '5',\n ratingCount: '18',\n }}\n video={{\n name: 'How to make a Party Coffee Cake',\n description: 'This is how you make a Party Coffee Cake.',\n contentUrl: 'http://www.example.com/video123.mp4',\n embedUrl: 'http://www.example.com/videoplayer?video=123',\n uploadDate: '2018-02-05T08:00:00+08:00',\n duration: 'PT1M33S',\n thumbnailUrls: [\n 'https://example.com/photos/1x1/photo.jpg',\n 'https://example.com/photos/4x3/photo.jpg',\n 'https://example.com/photos/16x9/photo.jpg',\n ],\n expires: '2019-02-05T08:00:00+08:00',\n hasPart: {\n '@type': 'Clip',\n name: 'Preheat oven',\n startOffset: 30,\n url: 'http://www.example.com/example?t=30',\n },\n watchCount: 2347,\n publication: {\n '@type': 'BroadcastEvent',\n isLiveBroadcast: true,\n startDate: '2020-10-24T14:00:00+00:00',\n endDate: '2020-10-24T14:37:14+00:00',\n },\n regionsAllowed: ['IT', 'NL'],\n }}\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Required properties**\n\n| Property | Info |\n| ------------------- | ------------------------------------------------------------------- |\n| `name` | The name of the recipe |\n| `description` | A description of the recipe |\n| `authorName` | The name of the recipe author. Can be a string or array of strings. |\n| `ingredients` | A list of ingredient strings |\n| `instructions` | - |\n| `instructions.name` | The name of the instruction step. |\n| `instructions.text` | The directions of the instruction step. |\n\n**Other**\n| `useAppDir` | This should be set to true if using the new app directory. Not required if outside of the app directory. |\n\n### Sitelinks Search Box\n\n```jsx\nimport { SiteLinksSearchBoxJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eSitelinks Search Box JSON-LD\u003c/h1\u003e\n \u003cSiteLinksSearchBoxJsonLd\n url=\"https://www.example.com\"\n potentialActions={[\n {\n target: 'https://query.example.com/search?q',\n queryInput: 'search_term_string',\n },\n {\n target: 'android-app://com.example/https/query.example.com/search/?q',\n queryInput: 'search_term_string',\n },\n ]}\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Required properties**\n\n| Property | Info |\n| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `url` | URL of the website associated with the sitelinks searchbox |\n| `potentialActions` | Array of one or two SearchAction objects. Describes the URI to send the query to, and the syntax of the request that is sent |\n| `potentialActions.target` | For websites, the URL of the handler that should receive and handle the search query; for apps, the URI of the intent handler for your search engine that should handle queries |\n| `potentialActions.queryInput` | Placeholder used in target, gets substituted for user given query |\n\n**Other**\n| `useAppDir` | This should be set to true if using the new app directory. Not required if outside of the app directory. |\n\nRead the [documentation](https://developers.google.com/search/docs/appearance/structured-data/sitelinks-searchbox)\n\n### Course\n\n```jsx\nimport { CourseJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eCourse JSON-LD\u003c/h1\u003e\n \u003cCourseJsonLd\n courseName=\"Course Name\"\n description=\"Introductory CS course laying out the basics.\"\n provider={{\n name: 'Course Provider',\n url: 'https//www.example.com/provider',\n }}\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Required properties**\n\n| Property | Info |\n| --------------- | ------------------------------------------------------------ |\n| `courseName` | The title of the course. |\n| `description` | A description of the course. Display limit of 60 characters. |\n| `provider.name` | The course provider name. |\n| `provider.url` | The course provider name url. |\n\n**Recommended properties**\n\n| Property | Info |\n| ------------- | ------------------------------- |\n| `providerUrl` | The url to the course provider. |\n\n**Other**\n| `useAppDir` | This should be set to true if using the new app directory. Not required if outside of the app directory. |\n\n### Dataset\n\n```jsx\nimport { DatasetJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eDataset JSON-LD\u003c/h1\u003e\n \u003cDatasetJsonLd\n description=\"The description needs to be at least 50 characters long\"\n name=\"name of the dataset\"\n license=\"https//www.example.com\"\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Required properties**\n\n| Property | Info |\n| ------------- | --------------------------------------------------------------------------------- |\n| `description` | A short summary describing a dataset. Needs to be between 50 and 5000 characters. |\n| `name` | A license under which the dataset is distributed. |\n\n**Recommended properties**\n\n| Property | Info |\n| --------- | ------------------------------- |\n| `license` | The url to the course provider. |\n\n**Other**\n| `useAppDir` | This should be set to true if using the new app directory. Not required if outside of the app directory. |\n\n### Corporate Contact\n\n```jsx\nimport { CorporateContactJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eCorporate Contact JSON-LD\u003c/h1\u003e\n \u003cCorporateContactJsonLd\n url=\"http://www.your-company-site.com\"\n logo=\"http://www.example.com/logo.png\"\n contactPoint={[\n {\n telephone: '+1-401-555-1212',\n contactType: 'customer service',\n email: 'customerservice@email.com',\n areaServed: 'US',\n availableLanguage: ['English', 'Spanish', 'French'],\n },\n {\n telephone: '+1-877-746-0909',\n contactType: 'customer service',\n email: 'servicecustomer@email.com',\n contactOption: 'TollFree',\n availableLanguage: 'English',\n },\n {\n telephone: '+1-877-453-1304',\n contactType: 'technical support',\n contactOption: 'TollFree',\n areaServed: ['US', 'CA'],\n availableLanguage: ['English', 'French'],\n },\n ]}\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Required properties**\n\n| Property | Info |\n| -------------------------- | ----------------------------------------------------------------------------------------------- |\n| `url` | Url to the home page of the company's official site. |\n| `contactPoint` | |\n| `contactPoint.telephone` | An internationalized version of the phone number, starting with the \"+\" symbol and country code |\n| `contactPoint.contactType` | Description of the purpose of the phone number i.e. `Technical Support`. |\n\n**Recommended ContactPoint properties**\n\n| Property | Info |\n| -------------------------------- | ---------------------------------------------------------------------------------------------------------- |\n| `contactPoint.areaServed` | `String` or `Array` of geographical regions served by the business. Example `\"US\"` or `[\"US\", \"CA\", \"MX\"]` |\n| `contactPoint.availableLanguage` | Details about the language spoken. Example `\"English\"` or `[\"English\", \"French\"]` |\n| `contactPoint.email` | Email asscosiated with the business` |\n| `gecontactPointo.contactOption` | Details about the phone number. Example `\"TollFree\"` |\n\n**Other**\n| `useAppDir` | This should be set to true if using the new app directory. Not required if outside of the app directory. |\n\n### FAQ Page\n\n```jsx\nimport { FAQPageJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eFAQ Page JSON-LD\u003c/h1\u003e\n \u003cFAQPageJsonLd\n mainEntity={[\n {\n questionName: 'How long is the delivery time?',\n acceptedAnswerText: '3-5 business days.',\n },\n {\n questionName: 'Where can I find information about product recalls?',\n acceptedAnswerText: 'Read more on under information.',\n },\n ]}\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Required properties**\n\n| Property | Info |\n| ------------------------------- | ----------------------------------------------------------------------------- |\n| `mainEntity` | |\n| `mainEntity.questionName` | The full text of the question. For example, \"How long is the delivery time?\". |\n| `mainEntity.acceptedAnswerText` | The full answer to the question. |\n\n**Other**\n| `useAppDir` | This should be set to true if using the new app directory. Not required if outside of the app directory. |\n\n### How-to\n\n```jsx\nimport { HowToJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eHow-to JSON-LD\u003c/h1\u003e\n \u003cHowToJsonLd\n name=\"How to tile a kitchen backsplash\"\n image=\"https://example.com/photos/1x1/photo.jpg\"\n estimatedCost={{ currency: 'USD', value: '100' }}\n supply={['tiles', 'thin-set', 'mortar', 'tile grout', 'grout sealer']}\n tool={['notched trowel', 'bucket', 'large sponge']}\n step={[\n {\n url: 'https://example.com/kitchen#step1',\n name: 'Prepare the surfaces',\n itemListElement: [\n {\n type: 'HowToTip',\n text: 'Turn off the power to the kitchen and then remove everything that is on the wall, such as outlet covers, switchplates, and any other item in the area that is to be tiled.',\n },\n {\n type: 'HowToDirection',\n text: 'Then clean the surface thoroughly to remove any grease or other debris and tape off the area.',\n },\n ],\n image: 'https://example.com/photos/1x1/photo-step1.jpg',\n },\n ]}\n totalTime=\"P2D\"\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Required properties**\n\n| Property | Info |\n| -------- | ---------------------------------------------------------------------------------- |\n| `name` | Name of the HowTo |\n| `step` | An array of HowToStep elements which comprise the full instructions of the how-to. |\n\n**Supported properties**\n\n| Property | Info |\n| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |\n| `estimatedCost` | The estimated cost of the supplies consumed when performing instructions. |\n| `image` | Image of the completed how-to. |\n| `supply` | A supply consumed when performing instructions or a direction. |\n| `tool` | An object used (but not consumed) when performing instructions or a direction. |\n| `totalTime` | The total time required to perform all instructions or directions (including time to prepare the supplies), in ISO 8601 duration format. |\n\n**Other**\n| `useAppDir` | This should be set to true if using the new app directory. Not required if outside of the app directory. |\n\n### Job Posting\n\n```jsx\nimport { JobPostingJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eJob Posting JSON-LD\u003c/h1\u003e\n \u003cJobPostingJsonLd\n datePosted=\"2020-01-06T03:37:40Z\"\n description=\"Company is looking for a software developer....\"\n hiringOrganization={{\n name: 'company name',\n sameAs: 'www.company-website-url.dev',\n }}\n jobLocation={{\n streetAddress: '17 street address',\n addressLocality: 'Paris',\n addressRegion: 'Ile-de-France',\n postalCode: '75001',\n addressCountry: 'France',\n }}\n title=\"Job Title\"\n baseSalary={{\n currency: 'EUR',\n value: 40, // Can also be a salary range, like [40, 50]\n unitText: 'HOUR',\n }}\n employmentType=\"FULL_TIME\"\n jobLocationType=\"TELECOMMUTE\"\n validThrough=\"2020-01-06\"\n applicantLocationRequirements=\"FR\"\n experienceRequirements={{\n occupational: {\n minimumMonthsOfExperience: 12,\n },\n educational: {\n credentialCategory: 'high school',\n },\n experienceInPlaceOfEducation: true,\n }}\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Required properties**\n\n| Property | Info |\n| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |\n| `datePosted` | The original date that employer posted the job in ISO 8601 format |\n| `description` | The full description of the job in HTML format |\n| `hiringOrganization` | An object containing information about the company hiring with the following fields or the string `'confidential'` when hiring anonymously |\n| `hiringOrganization.name` | Name of the company offering the job position |\n| `hiringOrganization.sameAs` | URL of a reference Web page |\n| `title` | The title of the job (not the title of the posting) |\n| `validThrough` | The date when the job posting will expire in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601) |\n\n**Supported properties**\n\n| Property | Info |\n| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `applicantLocationRequirements` | The geographic location(s) in which employees may be located for to be eligible for the remote job |\n| `baseSalary` | |\n| `baseSalary.currency` | The currency in which the monetary amount is expressed |\n| `baseSalary.value` | The value of the quantitative value. You can also provide an array of minimum and maximum salaries. . |\n| `baseSalary.unitText` | A string indicating the unit of measurement [Base salary guideline](https://developers.google.com/search/docs/data-types/job-posting#basesalary) |\n| `employmentType` | Type of employment [Employement type guideline](https://developers.google.com/search/docs/data-types/job-posting#basesalary) |\n| `jobLocation` | The physical location(s) of the business where the employee will report to work (such as an office or worksite), not the location where the job was posted. |\n| `jobLocation.streetAddress` | The street address. For example, 1600 Amphitheatre Pkwy |\n| `jobLocation.addressLocality` | The locality. For example, Mountain View. |\n| `jobLocation.addressRegion` | The region. For example, CA. |\n| `jobLocation.postalCode` | The postal code. For example, 94043 |\n| `jobLocation.addressCountry` | The country. For example, USA. You can also provide the two-letter ISO 3166-1 alpha-2 country code. |\n| `jobLocationType` | A description of the job location [Job Location type guideline](https://developers.google.com/search/docs/data-types/job-posting#job-location-type) |\n| `hiringOrganization.logo` | Logos on third-party job sites [Hiring Organization guideline](https://developers.google.com/search/docs/data-types/job-posting#hiring) |\n| `experienceRequirements.occupational.minimumMonthsOfExperience` | The minimum number of months of experience that are required for the job posting. [Experience and Education Requirements](https://developers.google.com/search/docs/appearance/structured-data/job-posting#education-and-experience-properties-beta) |\n| `experienceRequirements.educational.credentialCategory` | The level of education that's required for the job posting. Use one of the following: `high school`, `associate degree`, `bachelor degree`, `professional certificate`, `postgraduate degree` |\n| `experienceRequirements.experienceInPlaceOfEducation` | Boolean: If set to true, this property indicates whether a job posting will accept experience in place of its formal educational qualifications. If set to true, you must include both the experienceRequirements and educationRequirements properties. |\n\n**Other**\n| `useAppDir` | This should be set to true if using the new app directory. Not required if outside of the app directory. |\n\n### Local Business\n\nLocal business is supported with a sub-set of properties.\n\n```jsx\n\u003cLocalBusinessJsonLd\n type=\"Store\"\n id=\"http://davesdeptstore.example.com\"\n name=\"Dave's Department Store\"\n description=\"Dave's latest department store in San Jose, now open\"\n url=\"http://www.example.com/store-locator/sl/San-Jose-Westgate-Store/1427\"\n telephone=\"+14088717984\"\n address={{\n streetAddress: '1600 Saratoga Ave',\n addressLocality: 'San Jose',\n addressRegion: 'CA',\n postalCode: '95129',\n addressCountry: 'US',\n }}\n geo={{\n latitude: '37.293058',\n longitude: '-121.988331',\n }}\n images={[\n 'https://example.com/photos/1x1/photo.jpg',\n 'https://example.com/photos/4x3/photo.jpg',\n 'https://example.com/photos/16x9/photo.jpg',\n ]}\n sameAs={[\n 'www.company-website-url1.dev',\n 'www.company-website-url2.dev',\n 'www.company-website-url3.dev',\n ]}\n openingHours={[\n {\n opens: '08:00',\n closes: '23:59',\n dayOfWeek: [\n 'Monday',\n 'Tuesday',\n 'Wednesday',\n 'Thursday',\n 'Friday',\n 'Saturday',\n ],\n validFrom: '2019-12-23',\n validThrough: '2020-04-02',\n },\n {\n opens: '14:00',\n closes: '20:00',\n dayOfWeek: 'Sunday',\n validFrom: '2019-12-23',\n validThrough: '2020-04-02',\n },\n ]}\n rating={{\n ratingValue: '4.5',\n ratingCount: '2',\n }}\n review={[\n {\n author: 'John Doe',\n datePublished: '2006-05-04',\n name: 'A masterpiece of literature',\n reviewBody:\n 'I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood.',\n reviewRating: {\n bestRating: '5',\n worstRating: '1',\n reviewAspect: 'Ambiance',\n ratingValue: '4',\n },\n },\n {\n author: 'Bob Smith',\n datePublished: '2006-06-15',\n name: 'A good read.',\n reviewBody: \"Catcher in the Rye is a fun book. It's a good book to read.\",\n reviewRating: {\n ratingValue: '4',\n },\n },\n ]}\n makesOffer={[\n {\n priceSpecification: {\n type: 'UnitPriceSpecification',\n priceCurrency: 'EUR',\n price: '1000-10000',\n },\n itemOffered: {\n name: 'Motion Design Services',\n description:\n 'We are the expert of animation and motion design productions.',\n },\n },\n {\n priceSpecification: {\n type: 'UnitPriceSpecification',\n priceCurrency: 'EUR',\n price: '2000-10000',\n },\n itemOffered: {\n name: 'Branding Services',\n description:\n 'Real footage is a powerful tool when it comes to show what the business is about. Can be used to present your company, show your factory, promote a product packshot, or just tell any story. It can help create emotional links with your audience by showing punchy images.',\n },\n },\n ]}\n areaServed={[\n {\n geoMidpoint: {\n latitude: '41.108237',\n longitude: '-80.642982',\n },\n geoRadius: '1000',\n },\n {\n geoMidpoint: {\n latitude: '51.108237',\n longitude: '-80.642982',\n },\n geoRadius: '1000',\n },\n ]}\n action={{\n actionName: 'potentialAction',\n actionType: 'ReviewAction',\n target: 'https://www.example.com/review/this/business',\n }}\n/\u003e\n```\n\n**Required properties**\n\n| Property | Info |\n| ------------------------- | -------------------------------------------------------------------------- |\n| `@id` | Globally unique ID of the specific business location in the form of a URL. |\n| `type` | LocalBusiness or any sub-type |\n| `address` | Address of the specific business location |\n| `address.addressCountry` | The 2-letter ISO 3166-1 alpha-2 country code |\n| `address.addressLocality` | City |\n| `address.addressRegion` | State or province, if applicable. |\n| `address.postalCode` | Postal or zip code. |\n| `address.streetAddress` | Street number, street name, and unit number. |\n| `name` | Business name. |\n\n**Supported properties**\n\n| Property | Info |\n| --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `description` | Description of the business location |\n| `geo` | Geographic coordinates of the business. |\n| `geo.latitude` | The latitude of the business location |\n| `geo.longitude` | The longitude of the business location |\n| `rating` | The average rating of business based on multiple ratings or reviews. |\n| `rating.ratingValue` | The rating for the content. |\n| `rating.ratingCount` | The count of total number of ratings. |\n| `priceRange` | The relative price range of the business. |\n| `servesCuisine` | The type of cuisine the restaurant serves. |\n| `images` | An image or images of the business. Required for valid markup depending on the type |\n| `telephone` | A business phone number meant to be the primary contact method for customers. |\n| `url` | The fully-qualified URL of the specific business location. |\n| `sameAs` | An array of URLs that represent this business |\n| `openingHours` | Opening hour specification of business. You can provide this as a single object, or an array of objects with the properties below. |\n| `openingHours.opens` | The opening hour of the place or service on the given day(s) of the week. |\n| `openingHours.closes` | The closing hour of the place or service on the given day(s) of the week. |\n| `openingHours.dayOfWeek` | The day of the week for which these opening hours are valid. Can be a string or array of strings. Refer to [DayOfWeek](https://schema.org/DayOfWeek) |\n| `openingHours.validFrom` | The date when the item becomes valid. |\n| `openingHours.validThrough` | The date after when the item is not valid. |\n| `review` | A review of the local business. |\n| `review.author` | The author of this content or rating. |\n| `review.reviewBody` | The actual body of the review. |\n| `review.datePublished` | Date of first broadcast/publication. |\n| `review.name` | The name of the item. |\n| `review.rating` | The rating given in this review |\n| `review.rating.ratingValue` | The rating for the content. |\n| `review.rating.reviewAspect` | This Review or Rating is relevant to this part or facet of the itemReviewed. |\n| `review.rating.worstRating` | The lowest value allowed in this rating system. If worstRating is omitted, 1 is assumed. |\n| `review.rating.bestRating` | The highest value allowed in this rating system. If bestRating is omitted, 5 is assumed |\n| `areasServed` | The geographic area where a service or offered item is provided. |\n| `areasServed.GeoCircle` | A GeoCircle is a GeoShape representing a circular geographic area. |\n| `areasServed.GeoCircle.geoMidpoint` | Indicates the GeoCoordinates at the centre of a GeoShape e.g. GeoCircle. |\n| `areasServed.GeoCircle.geoMidpoint.latitude` | The latitude of a location. For example 37.42242 |\n| `areasServed.GeoCircle.geoMidpoint.longitude` | The name of the item. |\n| `areasServed.GeoCircle.geoRadius` | Indicates the approximate radius of a GeoCircle (metres unless indicated otherwise via Distance notation). |\n| `makesOffer` | A pointer to products or services offered by the organization or person. |\n| `makesOffer.offer` | An offer to transfer some rights to an item or to provide a service |\n| `makesOffer.offer.priceSpecification` | One or more detailed price specifications, indicating the unit price and delivery or payment charges. |\n| `makesOffer.offer.priceSpecification.priceCurrency` | The currency of the price, or a price component when attached to PriceSpecification and its subtypes. |\n| `makesOffer.offer.priceSpecification.price` | The offer price of a product, or of a price component when attached to PriceSpecification and its subtypes. |\n| `makesOffer.offer.itemOffered` | An item being offered (or demanded) |\n| `makesOffer.offer.itemOffered.name` | The name of the item |\n| `makesOffer.offer.itemOffered.description` | The description of the item. |\n| `action` | An action performed by a direct agent and indirect participants upon a direct object. |\n| `action.target` | Indicates a target EntryPoint for an Action. |\n\n**Other**\n| `useAppDir` | This should be set to true if using the new app directory. Not required if outside of the app directory. |\n\n**NOTE:**\n\nImages are recommended for most of the types that you can use for `LocalBusiness`; if in doubt, you should add an image. You can check your generated JSON over at Google's [Structured Data Testing Tool](https://search.google.com/structured-data/testing-tool)\n\n### Logo\n\n```jsx\nimport { LogoJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eLogo JSON-LD\u003c/h1\u003e\n \u003cLogoJsonLd\n logo=\"http://www.your-site.com/images/logo.jpg\"\n url=\"http://www.your-site.com\"\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n| Property | Info |\n| -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |\n| `url` | The URL of the website associated with the logo. [Logo guidelines](https://developers.google.com/search/docs/data-types/logo#definitions) |\n| `logo` | URL of a logo that is representative of the organization. |\n\n**Other**\n| `useAppDir` | This should be set to true if using the new app directory. Not required if outside of the app directory. |\n\n### Product\n\n```jsx\nimport { ProductJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eProduct JSON-LD\u003c/h1\u003e\n \u003cProductJsonLd\n productName=\"Executive Anvil\"\n images={[\n 'https://example.com/photos/1x1/photo.jpg',\n 'https://example.com/photos/4x3/photo.jpg',\n 'https://example.com/photos/16x9/photo.jpg',\n ]}\n description=\"Sleeker than ACME's Classic Anvil, the Executive Anvil is perfect for the business traveler looking for something to drop from a height.\"\n brand=\"ACME\"\n color=\"blue\"\n manufacturerName=\"Gary Meehan\"\n manufacturerLogo=\"https://www.example.com/photos/logo.jpg\"\n material=\"steel\"\n slogan=\"For the business traveller looking for something to drop from a height.\"\n disambiguatingDescription=\"Executive Anvil, perfect for the business traveller.\"\n releaseDate=\"2014-02-05T08:00:00+08:00\"\n productionDate=\"2015-02-05T08:00:00+08:00\"\n purchaseDate=\"2015-02-06T08:00:00+08:00\"\n award=\"Best Executive Anvil Award.\"\n reviews={[\n {\n author: 'Jim',\n datePublished: '2017-01-06T03:37:40Z',\n reviewBody:\n 'This is my favorite product yet! Thanks Nate for the example products and reviews.',\n name: 'So awesome!!!',\n reviewRating: {\n bestRating: '5',\n ratingValue: '5',\n worstRating: '1',\n },\n publisher: {\n type: 'Organization',\n name: 'TwoVit',\n },\n },\n ]}\n aggregateRating={{\n ratingValue: '4.4',\n reviewCount: '89',\n }}\n offers={[\n {\n price: '119.99',\n priceCurrency: 'USD',\n priceValidUntil: '2020-11-05',\n itemCondition: 'https://schema.org/UsedCondition',\n availability: 'https://schema.org/InStock',\n url: 'https://www.example.com/executive-anvil',\n seller: {\n name: 'Executive Objects',\n },\n },\n {\n price: '139.99',\n priceCurrency: 'CAD',\n priceValidUntil: '2020-09-05',\n itemCondition: 'https://schema.org/UsedCondition',\n availability: 'https://schema.org/InStock',\n url: 'https://www.example.ca/executive-anvil',\n seller: {\n name: 'Executive Objects',\n },\n },\n ]}\n mpn=\"925872\"\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\nAlso available: `sku`, `gtin8`, `gtin13`, `gtin14`.\n\nValid values for `offers.itemCondition`:\n\n- \u003chttps://schema.org/DamagedCondition\u003e\n- \u003chttps://schema.org/NewCondition\u003e\n- \u003chttps://schema.org/RefurbishedCondition\u003e\n- \u003chttps://schema.org/UsedCondition\u003e\n\nValid values for `offers.availability`:\n\n- \u003chttps://schema.org/Discontinued\u003e\n- \u003chttps://schema.org/InStock\u003e\n- \u003chttps://schema.org/InStoreOnly\u003e\n- \u003chttps://schema.org/LimitedAvailability\u003e\n- \u003chttps://schema.org/OnlineOnly\u003e\n- \u003chttps://schema.org/OutOfStock\u003e\n- \u003chttps://schema.org/PreOrder\u003e\n- \u003chttps://schema.org/PreSale\u003e\n- \u003chttps://schema.org/SoldOut\u003e\n\nThe property `aggregateOffer` is also available:\n(It is ignored if `offers` is set)\n\n**Required properties**\n\n| Property | Info |\n| --------------- | --------------------------------------------------------------------------------- |\n| `lowPrice` | The lowest price of all offers available. Use a floating point number. |\n| `priceCurrency` | The currency used to describe the product price, in three-letter ISO 4217 format. |\n\n**Recommended properties**\n\n| Property | Info |\n| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `highPrice` | The highest price of all offers available. Use a floating point number. |\n| `offerCount` | The number of offers for the product. |\n| `offers` | An offer to transfer some rights to an item or to provide a service. You can provide this as a single object, or an array of objects with the properties below. |\n\n**Other**\n| `useAppDir` | This should be set to true if using the new app directory. Not required if outside of the app directory. |\n\nMore info on the product data type can be found [here](https://developers.google.com/search/docs/data-types/product).\n\n### Social Profile\n\n```jsx\nimport { SocialProfileJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eSocial Profile JSON-LD\u003c/h1\u003e\n \u003cSocialProfileJsonLd\n type=\"Person\"\n name=\"your name\"\n url=\"http://www.your-site.com\"\n sameAs={[\n 'http://www.facebook.com/your-profile',\n 'http://instagram.com/yourProfile',\n 'http://www.linkedin.com/in/yourprofile',\n 'http://plus.google.com/your_profile',\n ]}\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n**Required properties**\n\n| Property | Info |\n| -------- | ----------------------------------------------------------------------------------------- |\n| `type` | Person or Organization |\n| `name` | The name of the person or organization |\n| `url` | The URL for the person's or organization's official website. |\n| `sameAs` | An array of URLs for the person's or organization's official social media profile page(s) |\n\n**Other**\n| `useAppDir` | This should be set to true if using the new app directory. Not required if outside of the app directory. |\n\n**Google Supported Social Profiles**\n\n- Facebook\n- Twitter\n- Google+\n- Instagram\n- YouTube\n- LinkedIn\n- Myspace\n- Pinterest\n- SoundCloud\n- Tumblr\n\n### News Article\n\n```jsx\nimport { NewsArticleJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003eNews Article JSON-LD\u003c/h1\u003e\n \u003cNewsArticleJsonLd\n url=\"https://example.com/article\"\n title=\"Article headline\"\n images={[\n 'https://example.com/photos/1x1/photo.jpg',\n 'https://example.com/photos/4x3/photo.jpg',\n 'https://example.com/photos/16x9/photo.jpg',\n ]}\n section=\"politic\"\n keywords=\"prayuth,taksin\"\n datePublished=\"2015-02-05T08:00:00+08:00\"\n dateModified=\"2015-02-05T09:00:00+08:00\"\n authorName=\"Jane Blogs\"\n publisherName=\"Gary Meehan\"\n publisherLogo=\"https://www.example.com/photos/logo.jpg\"\n description=\"This is a mighty good description of this article.\"\n body=\"This is all text for this news article\"\n isAccessibleForFree={true}\n /\u003e\n \u003c/\u003e\n);\n\nexport default Page;\n```\n\n### Park\n\n```jsx\nimport { ParkJsonLd } from 'next-seo';\n\nconst Page = () =\u003e (\n \u003c\u003e\n \u003ch1\u003ePark JSON-LD\u003c/h1\u003e\n \u003cParkJsonLd\n id=\"https://www.example.com/park/minnewaska-state-park\"\n name=\"Minnewaska State Park\"\n url=\"https://www.example.com/park\"\n telephone=\"+18452550752\"\n images={['https://example.com/photos/1x1/photo.jpg']}\n address={{\n streetAddress: '5281 Route 44-55',\n addressLocality: 'Kerhonkson',\n addressRegion: 'NY',\n postalCode: '12446',\n addressCountry: 'US',\n }}\n desc","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarmeeh%2Fnext-seo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgarmeeh%2Fnext-seo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarmeeh%2Fnext-seo/lists"}