HTML5 game publishing

Structured Data for Game Pages: What to Add and What to Avoid

BreadcrumbList, an honest VideoGame block, why fake ratings are risky, and how to test JSON-LD on pages with embedded games.

PlayKovo Team4 min read
Games currently available on PlayKovo. Open a title to see its current listing.

Structured data is the small block of JSON-LD in a page's head that tells search engines what the page is about in a machine-readable way. For game pages, it is easy to get wrong in two directions: adding nothing at all, or adding fake ratings and claims that can get a site a manual action. This post explains what structured data makes sense on a page that embeds a PlayKovo game, what to avoid, and how to check it.

What structured data can and cannot do

Structured data helps search engines understand your page. Some types can make a page eligible for rich results, such as breadcrumbs in the search snippet. It does not guarantee a better ranking, and it does not guarantee any rich result at all. Google decides when to show them.

So the goal is not tricks. The goal is to describe your page accurately, so search engines get a clear picture with less guessing.

A game page usually sits in a clear hierarchy: Home, Games, a category, the game. That is exactly what BreadcrumbList describes, and Google supports it as a rich result. It can show the path in the search snippet instead of a raw URL.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Home",
      "item": "https://example.com/" },
    { "@type": "ListItem", "position": 2, "name": "Games",
      "item": "https://example.com/games" },
    { "@type": "ListItem", "position": 3, "name": "Puzzle Games",
      "item": "https://example.com/games/puzzle" },
    { "@type": "ListItem", "position": 4, "name": "Water Sort Puzzle" }
  ]
}
</script>

Make sure the same breadcrumb is also visible on the page. Structured data should describe content the visitor can see.

Describing the game itself

Schema.org has a VideoGame type. Google does not offer a special rich result for it, but it is still a valid, accurate way to describe what the page contains. A careful version only uses facts you actually know:

{
  "@context": "https://schema.org",
  "@type": "VideoGame",
  "name": "Water Sort Puzzle",
  "description": "Your own one- or two-sentence description.",
  "url": "https://example.com/games/water-sort-puzzle",
  "image": "https://example.com/images/water-sort-puzzle.jpg",
  "genre": "Puzzle",
  "gamePlatform": "Web browser",
  "playMode": "SinglePlayer",
  "isAccessibleForFree": true
}

A few rules for embedded games:

  • Do not list yourself as the author or publisher of the game. You did not make it. The PlayKovo partner terms ask you not to present catalog games as your own, and structured data counts as a claim. If you add an author field, it should be the actual developer, and if you do not know who that is, leave the field out.
  • Write your own description. Copying the feed description into both the page and the JSON-LD adds nothing. Your own text is more useful to readers and to search engines.
  • Only claim what is true. If the game is single player, say single player. If you are not sure whether it works on phones, leave it out, or check the device support field in the feed.

What not to add

Fake or borrowed ratings

The most common mistake on game sites is an aggregateRating with made-up numbers, or numbers copied from another site, to get stars in search results. Google's structured data guidelines require that ratings reflect real reviews collected on your own page and visible to users. Fake ratings can lead to a manual action that removes rich results for the whole site. If you do not have a real rating system with real votes, do not add ratings.

Prices and offers

Free browser games do not need Offer markup with a price of zero to look attractive. It does not help, and it can trigger warnings if fields are incomplete. isAccessibleForFree already states that the game is free.

Markup for content that is not on the page

Do not add FAQ, HowTo or video markup unless the page really has that content in visible form. Also, Google has reduced how often it shows some of these types, so the effort rarely pays off even when the markup is valid.

Organization and WebSite markup

On your homepage, Organization markup with your site name, logo and URL helps search engines connect your brand to your site. WebSite markup with your site name can help Google show the right site name in results. These describe your site, so use your own name and logo here, never PlayKovo's.

The basics matter more than JSON-LD

Structured data is a small addition. These things matter more for a game page:

  • A unique title tag and meta description for each game page, written by you.
  • A visible heading with the game name.
  • Your own text: what the game is, how to play it, why it is on your site.
  • Controls and instructions in HTML, not only inside the iframe. Search engines do not read text inside the game.
  • A good image with alt text, and a fast page.
  • Internal links to related games and categories.

A page with these and no structured data is better than a thin page with perfect JSON-LD.

How to test

  1. Google's Rich Results Test shows which rich results your page is eligible for and lists errors.
  2. The Schema Markup Validator (from schema.org) checks general schema.org syntax, including types Google does not use for rich results, like VideoGame.
  3. Search Console reports structured data errors across the whole site over time, under the enhancements section.

Generate the JSON-LD from the same data that renders the page, ideally in the same template. Then it cannot drift away from what the visitor sees.

A minimal plan

  • Every game page: BreadcrumbList plus an accurate VideoGame block with your own description.
  • Homepage: Organization and WebSite with your own name.
  • No ratings unless you collect real ones on that page.
  • No author or publisher fields that suggest you made the game.

For more on building game pages from the PlayKovo catalog, see the other posts on the developers and partners blog.

We use optional cookies for site analytics and site advertising. You can change your choice later. Privacy policy.