docs: shorten page titles for SEO (#11750)

## What

Shorten the `title` frontmatter on 20 docs pages so that the rendered
`<title>` tag stays within the 70-character SEO limit.

The root layout appends ` | ZITADEL Docs` (15 chars) to every page
title, meaning the raw frontmatter `title` must be ≤ 55 characters. A
site scan flagged all 20 pages for the "Title too long" warning (titles
ranged from 71 to 92 characters in the final rendered tag).

## Why

Search engines may truncate or ignore `<title>` tags longer than 70
characters, hurting click-through rates and keyword relevance in search
results.

## How

Each title was rewritten to:
- Fit within 55 characters (leaving room for ` | ZITADEL Docs`)
- Front-load the primary search keyword (product name, protocol, or
feature)
- Include "ZITADEL" where users realistically search for `{feature}
ZITADEL`
- Avoid generic filler words ("Configure", "Set up", "Support for")

All 20 files already have a `sidebar_label` field that preserves the
original descriptive title for sidebar navigation — no navigation
changes result from this PR.

## Pages updated

| Page | Before (chars) | After (chars) |
|---|---|---|
| concepts/features/passkeys | 82 | 64 |
| guides/integrate/identity-providers/openldap | 72 | 58 |
| guides/solution-scenarios/b2b | 78 | 59 |
| guides/integrate/services/cloudflare-oidc | 86 | 54 |
| guides/integrate/login/hosted-login | 71 | 55 |
| guides/integrate/service-accounts/private-key-jwt | 76 | 56 |
| guides/integrate/service-accounts/client-credentials | 78 | 60 |
| guides/integrate/services/google-cloud | 92 | 57 |
| guides/solution-scenarios/saas | 88 | 65 |
| guides/migrate/sources/auth0 | 73 | 65 |
| guides/integrate/login-ui/oidc-standard | 81 | 55 |
| guides/integrate/login-ui/username-password | 73 | 59 |
| guides/integrate/login-ui/device-auth | 78 | 60 |
| guides/integrate/identity-providers/linkedin_oauth | 72 | 58 |
| guides/integrate/identity-providers/pingfederate-saml | 74 | 61 |
| guides/integrate/service-accounts/personal-access-token | 82 | 62 |
| legal/service-description/cloud-service-description | 76 | 61 |
| guides/integrate/login/login-users | 83 | 55 |
| guides/integrate/identity-providers/migrate | 74 | 65 |
| guides/manage/console/projects-overview | 71 | 62 |

All final `<title>` values are between 54 and 66 characters (well under
the 70-char limit).
This commit is contained in:
Florian Forster
2026-03-04 11:14:11 +00:00
committed by GitHub
parent 3f3413a230
commit 2763e93a61
20 changed files with 20 additions and 20 deletions
@@ -1,5 +1,5 @@
--- ---
title: "Passkeys in ZITADEL: Passwordless phishing-resistant authentication" title: "Passkeys & Passwordless Authentication in ZITADEL"
description: "Implement modern phishing-resistant passwordless authentication with FIDO2 passkeys." description: "Implement modern phishing-resistant passwordless authentication with FIDO2 passkeys."
sidebar_label: Passkeys sidebar_label: Passkeys
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Set up LinkedIn as an OAuth Identity Provider in ZITADEL title: LinkedIn OAuth Identity Provider in ZITADEL
description: "Configure LinkedIn as an OAuth Identity Provider in ZITADEL to enable secure login with LinkedIn credentials" description: "Configure LinkedIn as an OAuth Identity Provider in ZITADEL to enable secure login with LinkedIn credentials"
sidebar_label: LinkedIn generic OAuth sidebar_label: LinkedIn generic OAuth
id: linkedin-oauth id: linkedin-oauth
@@ -1,5 +1,5 @@
--- ---
title: Migrate from Generic Provider to specific Identity Provider title: Migrate from Generic to Specific Identity Provider
description: "Migrate from generic OIDC provider to Entra ID or Google using API requests or Terraform for user connectivity" description: "Migrate from generic OIDC provider to Entra ID or Google using API requests or Terraform for user connectivity"
sidebar_label: Migrate IdP sidebar_label: Migrate IdP
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Set up Local OpenLDAP as an Identity Provider in ZITADEL title: OpenLDAP Identity Provider Setup in ZITADEL
description: "Configure a local OpenLDAP server as an Identity Provider in ZITADEL to authenticate users with custom credentials" description: "Configure a local OpenLDAP server as an Identity Provider in ZITADEL to authenticate users with custom credentials"
sidebar_label: Local OpenLDAP sidebar_label: Local OpenLDAP
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Set up PingFederate as a SAML Identity Provider in ZITADEL title: PingFederate SAML Identity Provider in ZITADEL
description: "Configure PingFederate as a SAML Identity Provider in ZITADEL to enable secure authentication and single sign-on" description: "Configure PingFederate as a SAML Identity Provider in ZITADEL to enable secure authentication and single sign-on"
sidebar_label: PingFederate SAML sidebar_label: PingFederate SAML
id: pingfederate-saml id: pingfederate-saml
@@ -1,5 +1,5 @@
--- ---
title: Support for the Device Authorization Grant in a Custom Login UI title: Device Authorization Grant in Custom Login UI
description: "Implement the OAuth 2.0 Device Authorization Grant in your custom login UI for browserless devices." description: "Implement the OAuth 2.0 Device Authorization Grant in your custom login UI for browserless devices."
sidebar_label: Device Authorization sidebar_label: Device Authorization
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Support for the OpenID Connect(OIDC) Standard in a Custom Login UI title: OpenID Connect (OIDC) in Custom Login UI
description: "Support for the full OpenID Connect (OIDC) standard when building a custom login UI with ZITADEL." description: "Support for the full OpenID Connect (OIDC) standard when building a custom login UI with ZITADEL."
sidebar_label: OIDC Standard sidebar_label: OIDC Standard
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Register and Login User with Password in a Custom Login UI title: Username & Password Login in Custom Login UI
description: "Create a new user with profile data and verify their email address using ZITADEL's registration flow" description: "Create a new user with profile data and verify their email address using ZITADEL's registration flow"
sidebar_label: Username and Password sidebar_label: Username and Password
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Login users into your application with a hosted login UI title: "Hosted Login UI: Authenticate Your Users"
description: "Securely authenticate users via ZITADEL's hosted Single Sign-On (SSO) login page, supporting OIDC and SAML protocols." description: "Securely authenticate users via ZITADEL's hosted Single Sign-On (SSO) login page, supporting OIDC and SAML protocols."
sidebar_label: Hosted Login UI sidebar_label: Hosted Login UI
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Log users into your application with different authentication options title: User Authentication Options with ZITADEL
description: "Overview of authentication protocols supported by ZITADEL, including OpenID Connect and SAML, for unified user login." description: "Overview of authentication protocols supported by ZITADEL, including OpenID Connect and SAML, for unified user login."
sidebar_label: Authentication Options sidebar_label: Authentication Options
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Configure client credential authentication for service accounts title: OAuth Client Credentials for Service Accounts
description: "Authenticate service accounts using the industry-standard OAuth 2.0 Client Credentials flow." description: "Authenticate service accounts using the industry-standard OAuth 2.0 Client Credentials flow."
sidebar_label: Client credential authentication sidebar_label: Client credential authentication
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Configure personal access token authentication for service accounts title: Personal Access Token Auth for Service Accounts
description: "Generate and manage Personal Access Tokens (PAT) for service accounts to enable non-interactive API access to ZITADEL." description: "Generate and manage Personal Access Tokens (PAT) for service accounts to enable non-interactive API access to ZITADEL."
sidebar_label: Personal access token authentication sidebar_label: Personal access token authentication
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Configure private key JWT authentication for service accounts title: Private Key JWT Auth for Service Accounts
description: "Use RFC 7523 Private Key JWT authentication for secure, certificate-based service account login in ZITADEL." description: "Use RFC 7523 Private Key JWT authentication for secure, certificate-based service account login in ZITADEL."
sidebar_label: Private key JWT authentication sidebar_label: Private key JWT authentication
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Configure ZITADEL as an OIDC Identity Provider on Cloudflare Zero Trust title: Cloudflare Zero Trust OIDC with ZITADEL
description: "Configure ZITADEL as an OIDC Identity Provider on Cloudflare Zero Trust with custom user info and authentication flows" description: "Configure ZITADEL as an OIDC Identity Provider on Cloudflare Zero Trust with custom user info and authentication flows"
sidebar_label: Cloudflare Zero Trust sidebar_label: Cloudflare Zero Trust
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Log in with ZITADEL on Google Cloud with Workforce Identity Federation (OIDC) title: ZITADEL on Google Cloud Workforce Identity
description: "Configure Workforce Identity Federation with ZITADEL to log in users and assign roles on Google Cloud using OIDC claims" description: "Configure Workforce Identity Federation with ZITADEL to log in users and assign roles on Google Cloud using OIDC claims"
sidebar_label: Google Cloud sidebar_label: Google Cloud
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Organize applications, services, and roles with projects title: "ZITADEL Projects: Manage Apps, Services & Roles"
description: "Use projects to group applications and manage roles and authorizations across multiple clients." description: "Use projects to group applications and manage roles and authorizations across multiple clients."
sidebar_label: Projects sidebar_label: Projects
sidebar_position: 4 sidebar_position: 4
@@ -1,5 +1,5 @@
--- ---
title: Migrate from Auth0 to ZITADEL (Including Password Hashes) title: Migrate from Auth0 to ZITADEL with Password Hashes
description: "Migrate users, metadata, and password hashes from Auth0 to ZITADEL." description: "Migrate users, metadata, and password hashes from Auth0 to ZITADEL."
sidebar_label: From Auth0 sidebar_label: From Auth0
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Authentication and authorization in multi-tenancy B2B scenarios title: B2B Multi-Tenant Authentication with ZITADEL
description: "Implement multi-tenancy authentication and authorization for B2B applications using ZITADEL." description: "Implement multi-tenancy authentication and authorization for B2B applications using ZITADEL."
sidebar_label: B2B sidebar_label: B2B
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Set up a SaaS Product with Authentication and Authorization using ZITADEL title: SaaS Authentication and Authorization with ZITADEL
description: "Multi-tenancy authentication for a SaaS product using ZITADEL." description: "Multi-tenancy authentication for a SaaS product using ZITADEL."
sidebar_label: Software-as-a-Service sidebar_label: Software-as-a-Service
--- ---
@@ -1,5 +1,5 @@
--- ---
title: Service description for ZITADEL Cloud and ZITADEL Enterprise title: ZITADEL Cloud & Enterprise Service Description
description: "Description of services and service levels for ZITADEL Cloud and Enterprise subscriptions." description: "Description of services and service levels for ZITADEL Cloud and Enterprise subscriptions."
sidebar_label: Service description sidebar_label: Service description
custom_edit_url: null custom_edit_url: null