From 8c624274b2034535648b2cfb00d643986fcce597 Mon Sep 17 00:00:00 2001 From: vinckr Date: Thu, 22 Jan 2026 14:42:05 -0300 Subject: [PATCH 1/3] fix: improve identity schema example --- .../15_customize-identity-schema.mdx | 21 +++++++------------ 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/docs/kratos/manage-identities/15_customize-identity-schema.mdx b/docs/kratos/manage-identities/15_customize-identity-schema.mdx index c616c8fa6c..a1a4b44ca6 100644 --- a/docs/kratos/manage-identities/15_customize-identity-schema.mdx +++ b/docs/kratos/manage-identities/15_customize-identity-schema.mdx @@ -1312,14 +1312,8 @@ You may also mix usernames and passwords: ### Advanced schema -The following identity schema includes first name, last name, a nickname, and numerical fields for the users' age. There are also -two checkboxes for specifying the newsletter subscription and enterprise customer status. - -:::note - -This identity schema is just an example. It contains too many fields to be used in production. - -::: +The identity schema defines personal fields for first name, last name, nickname, and age, and includes two checkboxes: one +required for accepting the terms of service and one optional for newsletter subscription. ````mdx-code-block @@ -1386,14 +1380,15 @@ This identity schema is just an example. It contains too many fields to be used "type": "integer", "title": "How old are you?" }, - "newsletter": { + "tos": { "type": "boolean", - "title": "Newsletter subscription" + "title": "I accept the [terms of service](https://example.com/tos)", + "const": true }, - "enterprise": { + "newsletter": { "type": "boolean", - "title": "Are you an Enterprise customer?" - } + "title": "I want to sign up for the newsletter" + }, }, "required": [ "email" From 1d4611cdad0962a90ea3b943ec39b08c5bb15c72 Mon Sep 17 00:00:00 2001 From: vinckr Date: Fri, 23 Jan 2026 09:07:27 -0300 Subject: [PATCH 2/3] chore: grammar --- .../kratos/manage-identities/15_customize-identity-schema.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/kratos/manage-identities/15_customize-identity-schema.mdx b/docs/kratos/manage-identities/15_customize-identity-schema.mdx index a1a4b44ca6..3aa5fb01bc 100644 --- a/docs/kratos/manage-identities/15_customize-identity-schema.mdx +++ b/docs/kratos/manage-identities/15_customize-identity-schema.mdx @@ -1312,8 +1312,8 @@ You may also mix usernames and passwords: ### Advanced schema -The identity schema defines personal fields for first name, last name, nickname, and age, and includes two checkboxes: one -required for accepting the terms of service and one optional for newsletter subscription. +The following identity schema defines personal fields for first name, last name, nickname, and age, and includes two checkboxes: +one required for accepting the terms of service and one optional for newsletter subscription. ````mdx-code-block From 95adc5549497576f181eb41ba76456deecf37001 Mon Sep 17 00:00:00 2001 From: vinckr Date: Fri, 23 Jan 2026 09:27:46 -0300 Subject: [PATCH 3/3] fix: add clarification --- .../manage-identities/15_customize-identity-schema.mdx | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/kratos/manage-identities/15_customize-identity-schema.mdx b/docs/kratos/manage-identities/15_customize-identity-schema.mdx index 3aa5fb01bc..5b05db6585 100644 --- a/docs/kratos/manage-identities/15_customize-identity-schema.mdx +++ b/docs/kratos/manage-identities/15_customize-identity-schema.mdx @@ -1313,7 +1313,10 @@ You may also mix usernames and passwords: ### Advanced schema The following identity schema defines personal fields for first name, last name, nickname, and age, and includes two checkboxes: -one required for accepting the terms of service and one optional for newsletter subscription. +one required for accepting the terms of service and one optional for newsletter subscription. +To render links in a checkbox label, use markdown link syntax. Links open in a new tab. +To make a checkbox required, add `"const": true` to the property definition. This differs from text fields, which use the required +array. ````mdx-code-block