{"canonical_url":"https://engineer.company/nb/glossary/hreflang/","content_markdown":"# hreflang\n\n## Hva det er\n\n`hreflang` er et HTML-attributt som oppgir hvilket språk siden i den andre enden av en lenke er\nskrevet på. HTML tillater det på elementene `a`, `area` og `link`, men bruken som gjorde det kjent,\ner et sett med `link rel=\"alternate\"`-elementer i sidens `head`, ett per språkversjon. Med dem\nforteller et nettsted søkemotorene at flere adresser har det samme innholdet på ulike språk.\n\n```html\n\u003clink rel=\"alternate\" hreflang=\"en\" href=\"https://example.com/guide/\" /\u003e\n\u003clink rel=\"alternate\" hreflang=\"da\" href=\"https://example.com/da/guide/\" /\u003e\n\u003clink rel=\"alternate\" hreflang=\"x-default\" href=\"https://example.com/guide/\" /\u003e\n```\n\nHTML-standarden kaller attributtet «purely advisory», altså rent veiledende. Verdien må være en\ngyldig språkkode etter BCP 47, og en nettleser skal hente språket til en side den har lastet ned,\nfra siden selv, aldri fra lenken som førte dit. Sammen med `rel=\"alternate\"` markerer en `hreflang`\nsom avviker fra dokumentets eget språk, at målet er en oversettelse.\n\nSøkemotorene gjorde den veiledende merknaden til et fast regelverk. Google beskriver tre likeverdige\nmåter å levere settet på: `link`-elementer i `head`, en `Link`-header i HTTP for PDF-er og andre\nfiler som mangler `head`, og oppføringer i en XML-sitemap. Hver versjon lister både seg selv og alle\nde andre, med fullstendige adresser. Et par teller bare når begge sidene nevner hverandre, slik at\net annet nettsted ikke kan utgi seg for å være en oversettelse av ditt. Kodene er et språk fra ISO\n639-1, valgfritt fulgt av en region fra ISO 3166-1, og en region alene er ugyldig. Den reserverte\nverdien `x-default` peker ut siden for lesere hvis språk ikke matcher noen av de andre, og Google\npåpeker at den ble laget for sider der leseren velger språk selv.\n\nTo naboer er lette å forveksle med det. Attributtet `lang` sier hvilket språk teksten foran leseren\ner på; `hreflang` sier hvilket språk en lenket side er på. Google skriver at de ikke bruker noen av dem\ntil å avgjøre hvilket språk en side har, så `hreflang` kan ikke gjøre en side norsk. Det forteller\nen søkemotor at en norsk side den allerede har gjenkjent, hører sammen med en engelsk. Og en\nkanonisk URL slår sammen duplikater til én indeksert adresse, mens `hreflang` identifiserer språkalternativer og hjelper en søkemotor med å velge hvilken versjon den skal vise.\n\n## Hvorfor det er viktig\n\nValget `hreflang` skriver ned, er om språkversjonene av en side utgjør én klynge eller vurderes som\nseparate sider. Står de hver for seg, konkurrerer hver versjon på egne premisser, og en søkemotor\nkan vise den engelske siden til en norsk leser eller liste begge versjonene i de samme resultatene.\nErklært som en klynge forstås versjonene som ett og samme innhold, og søkemotoren kan tilby den\nversjonen som passer til leserens språkinnstillinger.\n\nKlyngen gir bare mening når versjonene faktisk er det samme innholdet. Et nettsted på ett språk\nklarer seg helt uten `hreflang`, og to språkseksjoner som skiller seg i substans, er heller ingen\nklynge. Regionale varianter med små forskjeller, som sider for `en-GB` og `en-US` med ulike priser,\ndanner derimot en klynge.\n\nPrisen er bokføring, og den vokser med kvadratet av antall språk. Hver versjon av hver side bærer\nhele listen, så når du legger til, flytter eller trekker tilbake én oversettelse, endres `head` i\nhver eneste søskenside. En liste som er riktig på de fleste sidene og feil på noen få, svikter i det\nstille: parene som peker begge veier, blir brukt, og resten forkastes uten noen synlig feilmelding.\nDerfor egner `hreflang` seg dårlig for håndredigering og godt for en generator som avleder hver\nsides sett fra én liste. Det `hreflang` endrer, er hvilken av flere versjoner en søker får se.\n\n## Slik ser det ut i praksis\n\nDette nettstedet\n[bygger språkversjonene fra ett innholdstre](/nb/portfolio/built-a-multilingual-hugo-site-in-3-languages/),\nså hver side har et sett med tilsvarende oversettelser å oppgi.\n\nÉn mal avgjør hvilke oversettelser som annonseres, og resultatet brukes flere steder: `hreflang`-settet i\n`head`, taggene `og:locale:alternate` som lenkeforhåndsvisninger bruker, alternativene i sitemapen,\n`inLanguage` i nettstedets strukturerte sidedata og, etter ett trekk til, språkstripen leseren ser.\nListen tar med siden selv, og det gir selvreferansen reglene krever. Kodene angir bare språk, for eksempel `en`,\n`da` og `uk`, så hver versjon tilbys alle som leser det språket, uansett hvor de befinner seg, og den\nengelske oppføringen skrives en gang til som `x-default`. Både `head` og sitemapen bærer settet,\ngenerert fra den samme listen, så de to kan ikke gli fra hverandre.\n\nSkillet mellom maskiner og lesere er bevisst. På et tidligere implementeringstrinn [ble den ukrainske versjonen annonsert til søkeroboter og oppført i sitemapene](/nb/credits/), mens språkstripen i topplinjen utelot den. Ett konfigurasjonsflagg styrte skillet: søkeroboter fikk gjensidige ukrainske alternativer, mens bare språkstripen for leseren ble endret. Et annet flagg, for\net språk som er bygd men ikke klart, fjerner språket fra begge listene og merker sidene `noindex`.\nEn side på et slikt språk deklarerer heller ingen søsken, fordi en `hreflang` fra en side som ikke\nannonseres, til en som annonseres, er et par en søkemotor bare ser fra den ene enden.\n\nKopier følger samme logikk. En side som serveres på et av de fokuserte underdomenene, og som har sin\nkanoniske adresse pekende tilbake til hovednettstedet, sender ut null `hreflang`: settet leses på\nden siden søkemotoren har godtatt som kanonisk, og en kopi som navngir oversettelsene på sin egen\nvert, ville motsi linjen rett over. Språkvelgeren virker likevel, for en leser som vil ha dansk,\nskal fortsatt få dansk.\n\nEn kontroll av de bygde sidene slår fast at hver side med alternativer tar med `x-default` og sitt\neget språk, og at hvert alternativ er en bygd side, er på et annonsert språk og peker tilbake.\nRegelen om selvreferanse fortjener plassen sin. Nettstedsgeneratoren tilbyr to lister med nesten\nlike navn: `.Translations`, som utelater den gjeldende siden, og `.AllTranslations`, som tar den\nmed. Glipper du på det ene ordet, forsvinner sidens eget språk fra `head` og fra språkstripen på én\ngang, og de to er fortsatt enige med hverandre. Mot et bygg som var ødelagt med vilje, var dette ene\nkontrollpunktet det eneste som fanget 528 av de 792 sidene.\n\n## Hvor det går galt\n\n**Søkere får se versjonen på feil språk.** En norsk leser sendes til den engelske siden, eller begge\nversjonene dukker opp side om side. Parene peker bare én vei: den norske siden nevner den engelske,\nmen den engelske lister fortsatt bare språkene den hadde fra før, og søkemotorer overser et par som\nmangler returlenken. Bygg hver sides sett fra én liste som inkluderer siden selv, og test\ngjensidigheten på det ferdig bygde resultatet.\n\n**Et helt språks annoteringer har null virkning.** Oppmerkingen er der og er gyldig HTML, men\nversjonene behandles som om de var urelaterte. Kodene peker på feil ting: `ua` eller `dk` der\nspråkene er `uk` og `da`, `be` ment som Belgia når det er koden for belarusisk, eller `en-UK` der\n`en-GB` var ment, siden `UK` er en reservert regionkode som Google overser. Bruk et språk fra ISO\n639-1, legg til en region fra ISO 3166-1 bare der innholdet varierer fra land til land, og husk at\nen gyldig BCP 47-kode likevel kan være en som Google ikke støtter.\n\n**Oversettelsene faller ut av indeksen.** Bare originalspråket vises i søk, og oversettelsene\nbehandles som duplikater av det. Hver oversettelse oppgir originalen som sin kanoniske URL, og det\nber om at oversettelsen slås sammen og forsvinner, mens `hreflang` ber om at den vises. Gjør hver\nspråkversjon til sin egen kanoniske side; Googles veiledning er at den kanoniske siden bør være på\nsamme språk.\n\n**En side som ba om å holdes utenfor søk, blir annonsert likevel.** Et utkastspråk merket `noindex`\ndukker opp blant alternativene på publiserte sider, eller lister dem fra sin egen `head`.\nAnnonseringen og direktivet ble satt på forskjellige steder, så nettstedet gir en søkerobot to svar\nom den samme adressen. Bestem per språk, annonsert i begge retninger eller i ingen, legg avgjørelsen\ni én innstilling som hver liste leser, og kontroller de bygde sidene mot den.\n\n## Les mer\n\n- [HTML Standard: the hreflang attribute](https://html.spec.whatwg.org/multipage/links.html#attr-hyperlink-hreflang)\n  — hva attributtet betyr på en lenke, og hvorfor en nettleser skal la være å stole på det.\n- [HTML Standard: lenketypen «alternate»](https://html.spec.whatwg.org/multipage/links.html#rel-alternate)\n  — hvordan `hreflang` og `type` beskriver en oversettelse eller et annet format av det samme\n  dokumentet.\n- [RFC 5646: Tags for Identifying Languages](https://www.rfc-editor.org/rfc/rfc5646) — BCP\n  47-syntaksen som verdien i attributtet må følge.\n- [Google Search Central: localized versions of your pages](https://developers.google.com/search/docs/specialty/international/localized-versions)\n  — de tre leveringsmåtene, regelen om gjensidighet og `x-default`.\n\n\u003chttps://engineer.company/nb/glossary/hreflang/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"For deg med et flerspråklig nettsted: hvordan hreflang kobler språkversjonene, hvorfor lenkene må gå begge veier og hvilke koder Google overser.","formats":{"gemtext":"https://engineer.company/nb/glossary/hreflang/index.gmi","gopher":"https://engineer.company/nb/glossary/hreflang/gophermap","html":"https://engineer.company/nb/glossary/hreflang/","json":"https://engineer.company/nb/glossary/hreflang/index.json","markdown":"https://engineer.company/nb/glossary/hreflang/index.md","pdf":"https://engineer.company/nb/glossary/hreflang/index.pdf"},"kind":"page","language":"nb","title":"Hva er hreflang?","url":"https://engineer.company/nb/glossary/hreflang/","version":1}