{
  "$schema": "https://datapackage.org/profiles/2.0/datapackage.json",
  "name": "hreflang-polish-web-2026-10-30",
  "title": "hreflang, html lang and canonical on Polish homepages",
  "description": "Every .pl site in a pinned Tranco list whose homepage answered with HTML: its hreflang annotations in HTML and HTTP headers, each code checked against ISO 639-1 and ISO 3166-1, self-reference, x-default, canonical, <html lang>, where the language versions live, and links to language versions without hreflang.",
  "version": "2026-10-30",
  "created": "2026-11-17T13:52:55.210Z",
  "homepage": "https://www.outofplace.space/blog/hreflang-polish-web",
  "keywords": [
    "hreflang",
    "x-default",
    "html lang",
    "canonical",
    "international SEO",
    "Poland"
  ],
  "licenses": [
    {
      "name": "CC-BY-4.0",
      "path": "https://creativecommons.org/licenses/by/4.0/",
      "title": "Creative Commons Attribution 4.0"
    }
  ],
  "contributors": [
    {
      "title": "Outofplace Poland sp. z o.o.",
      "roles": [
        "creator"
      ],
      "path": "https://www.outofplace.space"
    }
  ],
  "sources": [
    {
      "title": "Tranco list Y8YYG (https://doi.org/10.14722/ndss.2019.23386)",
      "path": "https://tranco-list.eu/list/Y8YYG/1000000"
    }
  ],
  "resources": [
    {
      "name": "sites",
      "path": "sites.csv",
      "type": "table",
      "format": "csv",
      "mediatype": "text/csv",
      "encoding": "utf-8",
      "bytes": 834838,
      "hash": "sha256:ef2c1d87e406be5155b16ca86649a0e8acd699f264055eb2bfcc61f09d843eb2",
      "dialect": {
        "header": true,
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "quoteChar": "\"",
        "doubleQuote": true
      },
      "schema": {
        "fields": [
          {
            "name": "rank_tranco",
            "type": "integer",
            "description": "Rank in the Tranco list."
          },
          {
            "name": "rank_sample",
            "type": "integer",
            "description": "Rank among the sample's homepages."
          },
          {
            "name": "domain",
            "type": "string",
            "description": "The .pl domain in the Tranco list."
          },
          {
            "name": "origin",
            "type": "string",
            "description": "The origin its homepage ended on."
          },
          {
            "name": "cms",
            "type": "string",
            "description": "CMS group from the CMS study of the same census (wordpress-polish-web)."
          },
          {
            "name": "translation_plugin",
            "type": "string",
            "description": "WordPress only: wpml, polylang, translatepress, widget (GTranslate and other in-browser translators), other, or empty."
          },
          {
            "name": "truncated",
            "type": "integer",
            "description": "1 when the homepage was cut at 1 MiB."
          },
          {
            "name": "html_lang",
            "type": "string",
            "description": "The lang attribute of <html>, as written."
          },
          {
            "name": "html_lang_primary",
            "type": "string",
            "description": "Its ISO 639-1 language, empty when missing or not a language."
          },
          {
            "name": "polish_share",
            "type": "number",
            "description": "Share of the visible text's letters that are Polish-only (ą ć ę ł ń ó ś ź ż)."
          },
          {
            "name": "letters",
            "type": "integer",
            "description": "Letters in the visible text."
          },
          {
            "name": "has_hreflang",
            "type": "integer",
            "description": "1 when the homepage has an hreflang annotation (HTML link or HTTP Link header)."
          },
          {
            "name": "in_head",
            "type": "integer",
            "description": "Annotations in <link> elements before <body>."
          },
          {
            "name": "in_header",
            "type": "integer",
            "description": "Annotations in the HTTP Link header."
          },
          {
            "name": "in_body",
            "type": "integer",
            "description": "Annotations in <link> elements after <body> (ignored by Google; not counted elsewhere)."
          },
          {
            "name": "codes",
            "type": "integer",
            "description": "Distinct hreflang values."
          },
          {
            "name": "langs",
            "type": "string",
            "description": "Valid ISO 639-1 languages named, space-separated."
          },
          {
            "name": "lang_count",
            "type": "integer",
            "description": "How many."
          },
          {
            "name": "multilingual",
            "type": "integer",
            "description": "1 when the annotations and the page's own language (html lang, else Polish when the text reads Polish) name two languages or more."
          },
          {
            "name": "alternates",
            "type": "integer",
            "description": "Annotations, x-default aside, that point at another address than the homepage."
          },
          {
            "name": "self_ref",
            "type": "string",
            "description": "self (a language code points at the homepage), variant (at an address that redirects to it, or differs by protocol, www or a trailing slash), x-default-only, none."
          },
          {
            "name": "x_default",
            "type": "integer",
            "description": "1 when an x-default annotation is present."
          },
          {
            "name": "invalid",
            "type": "integer",
            "description": "1 when any hreflang value is not ISO 639-1 (+ ISO 3166-1 alpha-2) or x-default."
          },
          {
            "name": "underscore",
            "type": "integer",
            "description": "1 when a value uses _ (en_GB)."
          },
          {
            "name": "country_as_language",
            "type": "integer",
            "description": "1 when a value starts with a country code that is no language (ua, cz)."
          },
          {
            "name": "bad_region",
            "type": "integer",
            "description": "1 when a value has a region that is no ISO 3166-1 alpha-2 code (en-uk, es-419)."
          },
          {
            "name": "other_code",
            "type": "integer",
            "description": "1 when a value is malformed or a three-letter code."
          },
          {
            "name": "relative",
            "type": "integer",
            "description": "1 when an annotation's href is not a full URL with http or https."
          },
          {
            "name": "duplicate",
            "type": "integer",
            "description": "1 when one hreflang value points at two different addresses."
          },
          {
            "name": "lang_match",
            "type": "string",
            "description": "match / mismatch between <html lang> and the code the homepage gives itself; no-lang when html lang is missing; n/a without a self-reference."
          },
          {
            "name": "canonical_to",
            "type": "string",
            "description": "The first rel=canonical: self, variant, alternate (another address in the hreflang set), elsewhere, invalid (no href), none."
          },
          {
            "name": "layout",
            "type": "string",
            "description": "Where the alternates live: folder, parameter, subdomain, domain, mixed, none."
          },
          {
            "name": "switch_langs",
            "type": "string",
            "description": "Languages named by links to another language version of the site (path, subdomain, lang parameter, hreflang or lang attribute)."
          },
          {
            "name": "js_translate",
            "type": "integer",
            "description": "1 when the page loads an in-browser translation widget (Google Translate element, GTranslate, Weglot, Linguise, ConveyThis)."
          }
        ],
        "missingValues": [
          ""
        ]
      }
    },
    {
      "name": "annotations",
      "path": "annotations.csv",
      "type": "table",
      "format": "csv",
      "mediatype": "text/csv",
      "encoding": "utf-8",
      "bytes": 732477,
      "hash": "sha256:03fbc39dc7efe43d744733098db11d6935ed07fe0e1a6f04bb3be42919ff5b56",
      "dialect": {
        "header": true,
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "quoteChar": "\"",
        "doubleQuote": true
      },
      "schema": {
        "fields": [
          {
            "name": "origin",
            "type": "string",
            "description": "The homepage's origin."
          },
          {
            "name": "code",
            "type": "string",
            "description": "The hreflang value, lower-cased."
          },
          {
            "name": "kind",
            "type": "string",
            "description": "ok, x-default, underscore, country-as-language, bad-region, other."
          },
          {
            "name": "lang",
            "type": "string",
            "description": "Its ISO 639-1 language when there is one."
          },
          {
            "name": "where",
            "type": "string",
            "description": "head, body or header."
          },
          {
            "name": "absolute",
            "type": "integer",
            "description": "1 when the href is a full http(s) URL."
          },
          {
            "name": "points",
            "type": "string",
            "description": "self, self-variant or other."
          }
        ],
        "missingValues": [
          ""
        ]
      }
    },
    {
      "name": "checks",
      "path": "checks.csv",
      "type": "table",
      "format": "csv",
      "mediatype": "text/csv",
      "encoding": "utf-8",
      "bytes": 5091,
      "hash": "sha256:a8a7edaca8145c8144949eb5488267a64bd554bb316e60347e4145cdffbbfb46",
      "dialect": {
        "header": true,
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "quoteChar": "\"",
        "doubleQuote": true
      },
      "schema": {
        "fields": [
          {
            "name": "dimension",
            "type": "string",
            "description": "all, cms_versions, cms_multi or wp_plugin."
          },
          {
            "name": "segment",
            "type": "string",
            "description": "The group (all, a CMS, a WordPress translation plugin group)."
          },
          {
            "name": "metric",
            "type": "string",
            "description": "The test, as named in 02-analyze.mjs METRICS."
          },
          {
            "name": "k",
            "type": "integer",
            "description": "Homepages that meet the test."
          },
          {
            "name": "n",
            "type": "integer",
            "description": "Homepages in the base."
          },
          {
            "name": "value",
            "type": "number",
            "description": "k / n."
          },
          {
            "name": "ci_low",
            "type": "number",
            "description": "95% Wilson interval, lower bound."
          },
          {
            "name": "ci_high",
            "type": "number",
            "description": "95% Wilson interval, upper bound."
          }
        ],
        "missingValues": [
          ""
        ]
      }
    },
    {
      "name": "languages",
      "path": "languages.csv",
      "type": "table",
      "format": "csv",
      "mediatype": "text/csv",
      "encoding": "utf-8",
      "bytes": 2805,
      "hash": "sha256:2d5ed188cbbc3c542dcf40c864a7b52fbd232d15637b47f792fa440ad66b06cb",
      "dialect": {
        "header": true,
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "quoteChar": "\"",
        "doubleQuote": true
      },
      "schema": {
        "fields": [
          {
            "name": "lang",
            "type": "string",
            "description": "ISO 639-1 language."
          },
          {
            "name": "k",
            "type": "integer",
            "description": "Homepages that meet the test."
          },
          {
            "name": "n",
            "type": "integer",
            "description": "Homepages in the base."
          },
          {
            "name": "value",
            "type": "number",
            "description": "k / n."
          },
          {
            "name": "ci_low",
            "type": "number",
            "description": "95% Wilson interval, lower bound."
          },
          {
            "name": "ci_high",
            "type": "number",
            "description": "95% Wilson interval, upper bound."
          }
        ],
        "missingValues": [
          ""
        ]
      }
    },
    {
      "name": "codes",
      "path": "codes.csv",
      "type": "table",
      "format": "csv",
      "mediatype": "text/csv",
      "encoding": "utf-8",
      "bytes": 950,
      "hash": "sha256:0ebf7676e7abe4daf7cfc8a52beda683d55244e24df41a1de8925a3f7e015aeb",
      "dialect": {
        "header": true,
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "quoteChar": "\"",
        "doubleQuote": true
      },
      "schema": {
        "fields": [
          {
            "name": "code",
            "type": "string",
            "description": "An hreflang value that isn't valid."
          },
          {
            "name": "kind",
            "type": "string",
            "description": "Why."
          },
          {
            "name": "sites",
            "type": "integer",
            "description": "Multilingual homepages using it."
          }
        ],
        "missingValues": [
          ""
        ]
      }
    },
    {
      "name": "html-lang",
      "path": "html_lang.csv",
      "type": "table",
      "format": "csv",
      "mediatype": "text/csv",
      "encoding": "utf-8",
      "bytes": 173,
      "hash": "sha256:673cf85df88efdc4492b0b6066753ff2b8ef360ab345cd72590ed71bd10e8bad",
      "dialect": {
        "header": true,
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "quoteChar": "\"",
        "doubleQuote": true
      },
      "schema": {
        "fields": [
          {
            "name": "lang",
            "type": "string",
            "description": "pl, missing, en or other: the <html lang> of homepages whose text reads as Polish."
          },
          {
            "name": "k",
            "type": "integer",
            "description": "Homepages that meet the test."
          },
          {
            "name": "n",
            "type": "integer",
            "description": "Homepages in the base."
          },
          {
            "name": "value",
            "type": "number",
            "description": "k / n."
          },
          {
            "name": "ci_low",
            "type": "number",
            "description": "95% Wilson interval, lower bound."
          },
          {
            "name": "ci_high",
            "type": "number",
            "description": "95% Wilson interval, upper bound."
          }
        ],
        "missingValues": [
          ""
        ]
      }
    },
    {
      "name": "verification",
      "path": "verification.csv",
      "type": "table",
      "format": "csv",
      "mediatype": "text/csv",
      "encoding": "utf-8",
      "bytes": 922,
      "hash": "sha256:5c6f0a353f2d8ed55f70223f4cbf2f9d48ff6654c7a2ec4a5a77ce551a752d39",
      "dialect": {
        "header": true,
        "delimiter": ",",
        "lineTerminator": "\r\n",
        "quoteChar": "\"",
        "doubleQuote": true
      },
      "schema": {
        "fields": [
          {
            "name": "group",
            "type": "string",
            "description": "switch or away (03-verify.mjs)."
          },
          {
            "name": "domain",
            "type": "string",
            "description": "The homepage read by hand."
          },
          {
            "name": "label",
            "type": "string",
            "description": "What it was."
          },
          {
            "name": "still_in_group",
            "type": "integer",
            "description": "1 when the final rules still put it in the group."
          }
        ],
        "missingValues": [
          ""
        ]
      }
    },
    {
      "name": "summary",
      "path": "summary.json",
      "description": "Headline numbers from the CSVs.",
      "format": "json",
      "mediatype": "application/json",
      "encoding": "utf-8",
      "bytes": 33906,
      "hash": "sha256:ae8842cd44a824318bbd62f6b6f702f71bb395dd757f038600da8e2fdd34ae8d"
    }
  ]
}
