---
title: Canonical links on internationalized hosts
url: https://namegarage.com/blog/canonical-link-headers
author: Namegarage
date: '2026-11-21'
description: The homepage and Markdown articles send valid canonical link headers
  when the configured website uses an internationalized hostname.
ai-disclosure: ai-assisted
---

# Canonical links on internationalized hosts

This article was prepared with AI assistance and reviewed by a person before publication.

Our homepage and Markdown articles send an HTTP `Link` header pointing readers and crawlers to the canonical HTML page. When the configured site hostname contained Unicode, the middleware could fail before sending the response because Fetch header values cannot contain arbitrary Unicode characters.

The site builder now uses the same URL serialization for those headers that it uses for the catalog manual. An internationalized hostname becomes its ASCII form, while its configured port and the intended page path are retained. The header still points to the configured site when a request arrives through a preview URL.
