Schema output for Video SEO

The schema output for our Video SEO plugin builds upon the Yoast SEO schema output. For all the post types you've enabled Video SEO for, it will automatically add a videoObject piece when it encounters a video embed on the page that it recognizes.

Single posts

For all posts and other post types that have Article schema, the output will change as follows:

  • Article
    • Added video attribute, that references the videoObject
  • videoObject
    • @type: videoObject
    • @id: <canonical>#video
    • name: <post title>
    • thumbnailUrl: <video thumbnail url>
    • description: <post description>
    • width: <width of the video> - in pixels
    • height: <height of the video> - in pixels
    • duration: <duration of the video> -  in ISO 8601 format
    • uploadDate: <post date of the post containing the video> - in ISO 8601 format
    • embedUrl: if available
    • contentUrl: if available
    • isFamilyFriendly: bool, defaults to yes, can be set to no.
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Organization",
            "@id": "https://example.com/#organization",
            "name": "Yoast",
            "url": "https://example.com/",
            "sameAs": [
                "https://www.facetest.com/yoast",
                "https://www.linkedin.com/company/yoast-com/",
                "https://en.wikipedia.org/wiki/Yoast",
                "https://twitter.com/yoast"
            ],
            "logo": {
                "@type": "ImageObject",
                "@id": "https://example.com/#logo",
                "url": "https://example.com/wp-content/uploads/2019/03/Yoast_Logo_tagline_Large_RGB.png",
                "caption": "Yoast"
            },
            "image": {
                "@id": "https://example.com/#logo"
            }
        },
        {
            "@type": "WebSite",
            "@id": "https://example.com/#website",
            "url": "https://example.com/",
            "name": "one.wordpress.test",
            "publisher": {
                "@id": "https://example.com/#organization"
            },
            "potentialAction": {
                "@type": "SearchAction",
                "target": "https://example.com/?s={search_term_string}",
                "query-input": "required name=search_term_string"
            }
        },
        {
            "@type": "WebPage",
            "@id": "https://example.com/video-test/#webpage",
            "url": "https://example.com/video-test/",
            "inLanguage": "en-US",
            "name": "Video test - one.wordpress.test",
            "isPartOf": {
                "@id": "https://example.com/#website"
            },
            "image": {
                "@type": "ImageObject",
                "@id": "https://example.com/video-test/#primaryimage",
                "url": "https://example.com/wp-content/uploads/2019/04/gk3jxtsgkts.jpg",
                "caption": ""
            },
            "primaryImageOfPage": {
                "@id": "https://example.com/video-test/#primaryimage"
            },
            "datePublished": "2019-04-10T19:12:04+00:00",
            "dateModified": "2019-04-10T19:22:57+00:00",
            "breadcrumb": {
                "@id": "https://example.com/video-test/#breadcrumb"
            }
        },
        {
            "@type": "BreadcrumbList",
            "@id": "https://example.com/video-test/#breadcrumb",
            "itemListElement": [
                {
                    "@type": "ListItem",
                    "position": 1,
                    "item": {
                        "@type": "WebPage",
                        "@id": "https://example.com/",
                        "url": "https://example.com/",
                        "name": "Home"
                    }
                },
                {
                    "@type": "ListItem",
                    "position": 2,
                    "item": {
                        "@type": "WebPage",
                        "@id": "https://example.com/video-test/",
                        "url": "https://example.com/video-test/",
                        "name": "Video test"
                    }
                }
            ]
        },
        {
            "@type": "Article",
            "@id": "https://example.com/video-test/#article",
            "isPartOf": {
                "@id": "https://example.com/video-test/#webpage"
            },
            "author": {
                "@id": "https://example.com/author/admin/#author",
                "name": "Joost de Valk"
            },
            "publisher": {
                "@id": "https://example.com/#organization"
            },
            "headline": "Video test",
            "datePublished": "2019-04-10T19:12:04+00:00",
            "dateModified": "2019-04-10T19:22:57+00:00",
            "commentCount": 0,
            "mainEntityOfPage": "https://example.com/video-test/#webpage",
            "image": {
                "@id": "https://example.com/video-test/#primaryimage"
            },
            "articleSection": "",
            "video": [
                {
                    "@id": "https://example.com/video-test/#video"
                }
            ]
        },
        {
            "@type": "Person",
            "@id": "https://example.com/author/admin/#author",
            "name": "Joost de Valk",
            "image": {
                "@type": "ImageObject",
                "@id": "https://example.com/#personlogo",
                "url": "http://0.gravatar.com/avatar/f08c3c3253bf14b5616b4db53cea6b78?s=96&d=mm&r=g",
                "caption": "Joost de Valk"
            },
            "description": "This is my bio",
            "sameAs": [
                "jdevalk",
                "https://twitter.com/jdevalk"
            ]
        },
        {
            "@type": "VideoObject",
            "@id": "https://example.com/video-test/#video",
            "name": "Video test - one.wordpress.test",
            "thumbnailUrl": "https://example.com/wp-content/uploads/2019/04/gk3jxtsgkts.jpg",
            "description": "This is a YouTube video: https://youtu.be/gk3jXtsgKTs?list=PL4CtPfBUiliqDkJVAgYwdGCC7LcWQnvKo",
            "uploadDate": "2019-04-10T19:12:04+00:00",
            "width": "480",
            "height": "270",
            "embedUrl": "https://www.youtube.com/embed/gk3jXtsgKTs",
            "duration": "PT36M19S",
            "isFamilyFriendly": "true"
        }
    ]
}

Single page

For post types that are not set up to get Article schema, we output a slightly different graph:

  • WebPage
    • Added video attribute, that references the videoObject
  • VideoObject - exactly the same as on on single post.
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Organization",
            "@id": "https://example.com/#organization",
            "name": "Yoast",
            "url": "https://example.com/",
            "sameAs": [
                "https://www.facetest.com/yoast",
                "https://www.linkedin.com/company/yoast-com/",
                "https://en.wikipedia.org/wiki/Yoast",
                "https://twitter.com/yoast"
            ],
            "logo": {
                "@type": "ImageObject",
                "@id": "https://example.com/#logo",
                "url": "https://example.com/wp-content/uploads/2019/03/Yoast_Logo_tagline_Large_RGB.png",
                "caption": "Yoast"
            },
            "image": {
                "@id": "https://example.com/#logo"
            }
        },
        {
            "@type": "WebSite",
            "@id": "https://example.com/#website",
            "url": "https://example.com/",
            "name": "one.wordpress.test",
            "publisher": {
                "@id": "https://example.com/#organization"
            },
            "potentialAction": {
                "@type": "SearchAction",
                "target": "https://example.com/?s={search_term_string}",
                "query-input": "required name=search_term_string"
            }
        },
        {
            "@type": "WebPage",
            "@id": "https://example.com/video-page/#webpage",
            "url": "https://example.com/video-page/",
            "inLanguage": "en-US",
            "name": "Video Page - one.wordpress.test",
            "isPartOf": {
                "@id": "https://example.com/#website"
            },
            "datePublished": "2019-04-11T07:50:51+00:00",
            "dateModified": "2019-04-11T07:50:52+00:00",
            "breadcrumb": {
                "@id": "https://example.com/video-page/#breadcrumb"
            },
            "video": [
                {
                    "@id": "https://example.com/video-page/#video"
                }
            ]
        },
        {
            "@type": "BreadcrumbList",
            "@id": "https://example.com/video-page/#breadcrumb",
            "itemListElement": [
                {
                    "@type": "ListItem",
                    "position": 1,
                    "item": {
                        "@type": "WebPage",
                        "@id": "https://example.com/",
                        "url": "https://example.com/",
                        "name": "Home"
                    }
                },
                {
                    "@type": "ListItem",
                    "position": 2,
                    "item": {
                        "@type": "WebPage",
                        "@id": "https://example.com/video-page/",
                        "url": "https://example.com/video-page/",
                        "name": "Video Page"
                    }
                }
            ]
        },
        {
            "@type": "VideoObject",
            "@id": "https://example.com/video-page/#video",
            "name": "Video Page - one.wordpress.test",
            "thumbnailUrl": "https://example.com/wp-content/uploads/2019/04/gk3jxtsgkts-1.jpg",
            "description": "This is a video page https://youtu.be/gk3jXtsgKTs?list=PL4CtPfBUiliqDkJVAgYwdGCC7LcWQnvKo",
            "uploadDate": "2019-04-11T07:50:51+00:00",
            "width": "480",
            "height": "270",
            "embedUrl": "https://www.youtube.com/embed/gk3jXtsgKTs",
            "duration": "PT36M19S",
            "isFamilyFriendly": "true"
        }
    ]
}