From d6448148cf338506592a72e462e863267a45c0de Mon Sep 17 00:00:00 2001
From: Jimmy <jimmy@cai.im>
Date: Tue, 17 Feb 2026 20:01:23 +0100
Subject: [PATCH] feat: add option to set a custom canonical url (#1267)

* add option to set a custom canonical url

* style: use `with` to load cannonicalurl

* style: change to canonicalUrl

Frontmatter is case-insensitive so it does not matter

---------

Co-authored-by: FarisZR <35614734+FarisZR@users.noreply.github.com>
---
 layouts/_partials/head/head.html | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/layouts/_partials/head/head.html b/layouts/_partials/head/head.html
index 9f01e48..16b2891 100644
--- a/layouts/_partials/head/head.html
+++ b/layouts/_partials/head/head.html
@@ -8,7 +8,11 @@
 {{- $title := partial "data/title" . -}}
 <title>{{ $title }}</title>
 
-<link rel='canonical' href='{{ .Permalink }}'>
+{{ with .Params.canonicalUrl }}
+<link rel="canonical" href="{{ . }}">
+{{ else }}
+<link rel="canonical" href="{{ .Permalink }}">
+{{ end }}
 
 {{- partial "head/custom-font.html" . -}}
 {{- partial "head/style.html" . -}}