chore: canonical forward slash

README.md

@@ -32,10 +32,17 @@
   - [Screenshots and videos](#screenshots-and-videos)
     - [Compressing images](#compressing-images)
     - [Recording and compressing videos](#recording-and-compressing-videos)
+  - [Ory Console](#ory-console)
+    - [Navigate to Ory Console Pages](#navigate-to-ory-console-pages)
   - [Testing](#testing)
   - [Formatting documentation](#formatting-documentation)
   - [Adding content to "Examples" page](#adding-content-to-examples-page)
   - [CLI and API reference - auto-generated content](#cli-and-api-reference---auto-generated-content)
+  - [SEO components](#seo-components)
+    - [CanonicalURL](#canonicalurl)
+      - [When to use CanonicalURL](#when-to-use-canonicalurl)
+      - [How to use CanonicalURL](#how-to-use-canonicalurl)
+      - [How to verify CanonicalURL is working](#how-to-verify-canonicalurl-is-working)
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
@@ -540,3 +547,70 @@ The `cmd/clidoc/main.go` is the general path for all Ory projects.
 
 The command to generate the CLI docs can be found here:
 https://github.com/ory/x/blob/master/clidoc/generate.go#L96
+
+## SEO components
+
+### CanonicalURL
+
+The `CanonicalURL` component ensures search engines know the authoritative URL
+for a page, even though Vercel already handles trailing slash redirects. This is
+important for SEO consistency.
+
+#### When to use CanonicalURL
+
+Use this component on:
+
+- **Any `index.mdx` file**: These files serve content at their parent path
+  (e.g., `/api/index.mdx`)
+- **Files matching parent directory names**: When a file shares its parent
+  directory's name (e.g., `docs/kratos/organizations/organizations.mdx`)
+
+Common examples include:
+
+- Index Path (`/api/index.mdx`, `/elements/index.mdx`, `/identities/index.mdx`)
+- Matching parent directory names
+  (`docs/kratos/organizations/organizations.mdx`,
+  `docs/self-hosted/oel/monitoring/monitoring.mdx`)
+
+#### How to use CanonicalURL
+
+Add the component at the beginning of your MDX file after the front matter:
+
+```mdx
+---
+id: your-page-id
+title: Your Page Title
+---
+
+import CanonicalURL from "@site/src/components/CanonicalUrl"
+
+<CanonicalURL path="your/canonical/path" />
+
+Your content here...
+```
+
+The component automatically:
+
+- Generates the full canonical URL using the site's base URL
+- Removes trailing slashes to ensure URL consistency
+- Adds the appropriate `<link rel="canonical">` tag to the page's HTML head
+
+This ensures search engines understand which version of the URL should be
+indexed and helps consolidate page authority for better SEO performance.
+
+#### How to verify CanonicalURL is working
+
+1. Open the page in your browser
+2. Right-click and select "View Page Source" (not "Inspect")
+3. Search for `<link rel="canonical"` in the HTML
+4. Confirm the canonical URL exists and points to the correct path without
+   trailing slash
+
+Example:
+
+```html
+<link rel="canonical" href="https://www.ory.sh/docs/kratos/organizations" />
+```
+
+If you see a trailing slash in the canonical URL or if there's no canonical tag
+at all, the component may not be properly implemented.

docs/account-experience/index.mdx

@@ -4,6 +4,12 @@ title: Account Experience Overview
 sidebar_label: Account Experience
 ---
 
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/account-experience" />
+```
+
 The Ory Account Experience is the default user interface for all self-service screens like login, registration, or consent. It can
 be accessed under `https://your-slug.projects.oryapis.com/ui`. New Ory Network projects are automatically configured to use the
 Account Experience. You can find various customizations and settings in the Ory Console under `Account Experience`.

docs/api/index.mdx

@@ -4,6 +4,12 @@ title: gRPC + REST API Overview
 sidebar_label: APIs
 ---
 
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/api" />
+```
+
 ```mdx-code-block
 import ApiTypes from './_common/api-types.mdx'
 

docs/elements/index.mdx

@@ -3,6 +3,12 @@ id: index
 title: Ory Elements Introduction
 ---
 
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/elements" />
+```
+
 import WelcomePageSection from "@site/src/components/Welcome/welcome"
 import { elements } from "@site/src/pages/_assets/welcome-content"
 import { elementsArchitectureGraph } from "@site/src/pages/_assets/ui-graphs"

docs/elements/reference/@ory/elements-react/index.md → docs/elements/reference/@ory/elements-react/index.mdx

@@ -1,3 +1,15 @@
+---
+id: index
+title: "@ory/elements-react"
+sidebar_label: "@ory/elements-react"
+---
+
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/elements/reference/@ory/elements-react" />
+```
+
 # @ory/elements-react
 
 This package provides the core functionality for Ory Elements in React.

docs/elements/reference/@ory/elements-react/theme/index.md → docs/elements/reference/@ory/elements-react/theme/index.mdx

@@ -1,3 +1,15 @@
+---
+id: index
+title: "@ory/elements-react/theme"
+sidebar_label: "theme"
+---
+
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/elements/reference/@ory/elements-react/theme" />
+```
+
 # @ory/elements-react/theme
 
 This package provides the default theme for Ory Elements React.

docs/elements/reference/@ory/nextjs/app/index.md → docs/elements/reference/@ory/nextjs/app/index.mdx

@@ -1,3 +1,15 @@
+---
+id: index
+title: "@ory/nextjs/app"
+sidebar_label: "app"
+---
+
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/elements/reference/@ory/nextjs/app" />
+```
+
 # @ory/nextjs/app
 
 ## Interfaces

docs/elements/reference/@ory/nextjs/middleware/index.mdx

@@ -0,0 +1,17 @@
+---
+id: index
+title: "@ory/nextjs/middleware"
+sidebar_label: "middleware"
+---
+
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/elements/reference/@ory/nextjs/middleware" />
+```
+
+# @ory/nextjs/middleware
+
+## Functions
+
+- [createOryMiddleware](functions/createOryMiddleware.md)

docs/elements/reference/@ory/nextjs/pages/index.md → docs/elements/reference/@ory/nextjs/pages/index.mdx

@@ -1,3 +1,15 @@
+---
+id: index
+title: "@ory/nextjs/pages"
+sidebar_label: "pages"
+---
+
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/elements/reference/@ory/nextjs/pages" />
+```
+
 # @ory/nextjs/pages
 
 ## Hooks

docs/elements/reference/index.mdx

@@ -0,0 +1,21 @@
+---
+id: index
+title: Ory Elements Reference
+sidebar_label: Reference
+---
+
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/elements/reference" />
+```
+
+# Ory Elements Reference
+
+## Modules
+
+- [@ory/elements-react](@ory/elements-react/index.mdx)
+- [@ory/elements-react/theme](@ory/elements-react/theme/index.mdx)
+- [@ory/nextjs/app](@ory/nextjs/app/index.mdx)
+- [@ory/nextjs/middleware](@ory/nextjs/middleware/index.mdx)
+- [@ory/nextjs/pages](@ory/nextjs/pages/index.mdx)

docs/hydra/self-hosted/deploy-hydra-example.mdx

@@ -477,4 +477,4 @@ server {
 - Read the [Prepare for production](./production).
 - Fork the [Ory Hydra Node.js UI Reference](https://github.com/ory/hydra-login-consent-node) or
   [build a custom UI in the language of your choice](../sdk/01_overview.md).
-- [Add Identity and Account Management](../../identities/index.md)
+- [Add Identity and Account Management](../../identities/index.mdx)

docs/identities/get-started/index.mdx

@@ -4,6 +4,12 @@ title: Identity management guide - Day 1 essentials
 sidebar_label: Overview
 ---
 
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/identities/get-started" />
+```
+
 # Identity management guide
 
 This guide shows how to implement basic authentication flows with Ory. It covers the essential setup and implementation details

docs/identities/index.md → docs/identities/index.mdx

@@ -4,6 +4,12 @@ title: Introduction to Ory Kratos Identities
 sidebar_label: Introduction
 ---
 
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/identities" />
+```
+
 Ory Kratos Identities is an API-first identity and user management system built on top of the widely deployed open-source
 [Ory Kratos](https://github.com/ory/kratos) following
 [cloud architecture best practices](ecosystem/software-architecture-philosophy.mdx). It implements mechanisms that allow handling

docs/keto/index.md → docs/keto/index.mdx

@@ -4,6 +4,12 @@ title: Introduction to Ory Keto Permissions
 sidebar_label: Introduction
 ---
 
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/keto" />
+```
+
 Ory Permissions is a modern permission system you can use to create a complete authorization system for your application or
 website, no matter the size or the complexity of the ACLs (access-control lists) your use case requires. Ory Permissions, based on
 the open-source Ory Keto Permission Server, is the first open-source implementation of the design principles and specifications

docs/kratos/organizations/organizations.mdx

@@ -3,6 +3,12 @@ id: organizations
 title: B2B SSO & SAML
 ---
 
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/kratos/organizations" />
+```
+
 # B2B Single Sign-On & SAML
 
 ```mdx-code-block

docs/kratos/social-signin/09_ory.mdx

@@ -6,7 +6,7 @@ sidebar_label: Ory
 
 # Ory
 
-This document explains how to add [Ory OAuth2](../../oauth2-oidc/index.md) as an OIDC provider to your Ory Network project.
+This document explains how to add [Ory OAuth2](../../oauth2-oidc/index.mdx) as an OIDC provider to your Ory Network project.
 
 The setup we will describe here is as follows:
 

docs/migrate-to-ory/index.mdx

@@ -5,6 +5,12 @@ sidebar_label: Migrate to Ory
 sidebar_position: 1
 ---
 
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/migrate-to-ory" />
+```
+
 This tutorial will guide you through the process of migrating your existing authentication system to Ory Identities, creating Ory
 Network projects, setting up identity schemas, and customizing the user interface to match your current interface.
 

docs/oathkeeper/index.mdx

@@ -3,6 +3,12 @@ id: index
 title: Introduction to Ory Oathkeeper Zero Trust Proxy
 ---
 
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/oathkeeper" />
+```
+
 ```mdx-code-block
 import Help from '@site/docs/_common/need-selfhosted-support.mdx'
 

docs/oauth2-oidc/index.md → docs/oauth2-oidc/index.mdx

@@ -4,6 +4,12 @@ title: Introduction to Ory Hydra OAuth2
 sidebar_label: Introduction
 ---
 
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/oauth2-oidc" />
+```
+
 OAuth2 is the industry-standard protocol that enables secure machine-to-machine communication and grants limited access to data
 and services on behalf of users. OpenID Connect, built on top of OAuth2, is required to become a social sign-in provider.
 

docs/polis/admin-portal/index.mdx

@@ -3,6 +3,12 @@ id: index
 title: Get started with Admin Portal
 ---
 
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/polis/admin-portal" />
+```
+
 Ory Polis comes with an Admin Portal that allows you to manage **Enterprise SSO**, **Directory Sync** and **Setup Links** products
 via an easy to use web interface.
 

docs/polis/directory-sync/index.mdx

@@ -3,6 +3,12 @@ id: index
 title: Directory Sync
 ---
 
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/polis/directory-sync" />
+```
+
 Directory sync helps organizations automate the provisioning and de-provisioning of their users. It is based on the System for
 Cross-domain Identity Management (SCIM) protocol.
 

docs/polis/index.mdx

@@ -4,6 +4,12 @@ title: Introduction to Ory Polis
 sidebar_label: Introduction
 ---
 
+```mdx-code-block
+import CanonicalUrl from "@site/src/components/CanonicalUrl"
+
+<CanonicalUrl path="/polis" />
+```
+
 # Introduction to Ory Polis
 
 Ory Polis - formerly known as BoxyHQ Jackson - is an Enterprise Single Sign-On (SSO) service for SAML and OIDC identity providers.