From 91a89d259630eb75d12fa9214c5fffc4b8b4f78b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mi=C5=82osz=20Szekiel?= <12242002+mszekiel@users.noreply.github.com> Date: Fri, 15 May 2026 12:35:33 +0200 Subject: [PATCH 1/3] chore(kratos): update Console URLs after organization nav refactor The Ory Console moved organization management out from under Authentication to a top-level entry, and the detail page now uses a left-rail layout with dedicated routes per sub-section. Update the screenshot URLs accordingly. Companion to ory-corp/cloud#11899. --- docs/kratos/organizations/organizations.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/kratos/organizations/organizations.mdx b/docs/kratos/organizations/organizations.mdx index c0e380175..5cb893531 100644 --- a/docs/kratos/organizations/organizations.mdx +++ b/docs/kratos/organizations/organizations.mdx @@ -517,7 +517,7 @@ link with the organization administrators. ```mdx-code-block import BrowserWindow from "@site/src/theme/BrowserWindow" - + ![Onboarding portal link](./_static/onboarding-portal-link.png) ``` @@ -552,7 +552,7 @@ For social sign-in, all upstream data is available as `std.extVar('claims')`, in non-standard fields. [Social Sign-In mapping](https://www.ory.com/docs/kratos/social-signin/data-mapping#write-a-jsonnet-data-mapper) - + ![Onboarding portal link](./_static/onboarding-portal-link-mappers.png) From 17e77dc227f08def604b9bc9b7d3cfc8b6e8e795 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mi=C5=82osz=20Szekiel?= <12242002+mszekiel@users.noreply.github.com> Date: Fri, 15 May 2026 16:22:24 +0200 Subject: [PATCH 2/3] chore(console): move Organizations to top-level nav in ConsoleLink Mirror the Ory Console nav refactor: Organizations is now a top-level entry with sub-routes for Overview, B2B SSO, Onboarding Portal, SCIM clients, and Identities. Update the four ConsoleLink references in the Kratos organizations guide so they render and link to the new Organizations section. --- docs/kratos/organizations/organizations.mdx | 8 ++-- .../ConsoleLink/console-nav-data.ts | 36 ++++++++++++++++-- src/components/ConsoleLink/console-routes.ts | 38 ++++++++++++++----- 3 files changed, 65 insertions(+), 17 deletions(-) diff --git a/docs/kratos/organizations/organizations.mdx b/docs/kratos/organizations/organizations.mdx index 5cb893531..e4514ff48 100644 --- a/docs/kratos/organizations/organizations.mdx +++ b/docs/kratos/organizations/organizations.mdx @@ -65,7 +65,7 @@ Organizations require identifier-first authentication and two-step registration To create, update, or delete organizations via the Ory Console, go to -. +. ```mdx-code-block @@ -132,7 +132,7 @@ After creating an organization, continue by adding one or more SSO OIDC connecti ``` -Go to and continue by configuring the selected organization. +Go to and continue by configuring the selected organization. ```mdx-code-block @@ -280,7 +280,7 @@ Before proceeding, ensure you are on a plan that supports SAML SSO. SAML is avai ``` -1. Go to to create an organization. +1. Go to to create an organization. 2. Select "Add a new Enterprise SAML SSO connection" and follow the instructions to configure the SAML connection. Fill out the following form fields: @@ -508,7 +508,7 @@ servers. Guided walkthroughs are available for Microsoft Entra ID, Google Worksp ##### Create a link -Go to and continue by configuring the selected organization. +Go to and continue by configuring the selected organization. On the **Edit Organization** page, under the **Onboarding Portal** section, click **Generate link**. If your project has a custom domain configured, you must choose between the project slug and the custom domain as the link's base URL. You can then share this diff --git a/src/components/ConsoleLink/console-nav-data.ts b/src/components/ConsoleLink/console-nav-data.ts index 5b712d063..d60047157 100644 --- a/src/components/ConsoleLink/console-nav-data.ts +++ b/src/components/ConsoleLink/console-nav-data.ts @@ -97,10 +97,6 @@ export const authenticationPaths: Path[] = [ href: routes.project.saml.route, pill: "Preview", }, - { - title: "Organizations", - href: routes.project.authentication.organizations.route, - }, { title: "Sessions", href: routes.project.authentication.sessionSettings.route, @@ -127,6 +123,33 @@ export const authenticationPaths: Path[] = [ }, ] +export const organizationsPaths: Path[] = [ + { + title: "All organizations", + href: routes.project.organizations.route, + }, + { + title: "Overview", + href: routes.project.organizations.details.route, + }, + { + title: "B2B SSO", + href: routes.project.organizations.b2bSso.route, + }, + { + title: "Onboarding Portal", + href: routes.project.organizations.onboardingPortal.route, + }, + { + title: "SCIM clients", + href: routes.project.organizations.scim.route, + }, + { + title: "Identities", + href: routes.project.organizations.identities.route, + }, +] + export const oauthPaths: Path[] = [ { title: "Clients and applications", @@ -235,6 +258,11 @@ export const projectPaths: RootPath[] = [ href: routes.project.authentication.route, paths: authenticationPaths, }, + { + title: "Organizations", + href: routes.project.organizations.route, + paths: organizationsPaths, + }, { title: "Branding", href: routes.project.accountExperience.theming.route, diff --git a/src/components/ConsoleLink/console-routes.ts b/src/components/ConsoleLink/console-routes.ts index 09336423a..7acf111d0 100644 --- a/src/components/ConsoleLink/console-routes.ts +++ b/src/components/ConsoleLink/console-routes.ts @@ -251,15 +251,35 @@ export const routes = { href: (project: string) => `/projects/${project}/authentication/sessions`, }, - organizations: { - route: "/projects/[project]/authentication/organizations", - href: (project: string) => - `/projects/${project}/authentication/organizations`, - edit: { - route: "/projects/[project]/authentication/organizations/[id]", - href: (project: string, id: string) => - `/projects/${project}/authentication/organizations/${id}`, - }, + }, + organizations: { + route: "/projects/[project]/organizations", + href: (project: string) => `/projects/${project}/organizations`, + details: { + route: "/projects/[project]/organizations/[organization]", + href: (project: string, organization: string) => + `/projects/${project}/organizations/${organization}`, + }, + b2bSso: { + route: "/projects/[project]/organizations/[organization]/b2b-sso", + href: (project: string, organization: string) => + `/projects/${project}/organizations/${organization}/b2b-sso`, + }, + onboardingPortal: { + route: + "/projects/[project]/organizations/[organization]/onboarding-portal", + href: (project: string, organization: string) => + `/projects/${project}/organizations/${organization}/onboarding-portal`, + }, + scim: { + route: "/projects/[project]/organizations/[organization]/scim", + href: (project: string, organization: string) => + `/projects/${project}/organizations/${organization}/scim`, + }, + identities: { + route: "/projects/[project]/organizations/[organization]/identities", + href: (project: string, organization: string) => + `/projects/${project}/organizations/${organization}/identities`, }, }, hostedUI: { From a2b6cdf1d4067db1d31cfa603d7e073d9d772599 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mi=C5=82osz=20Szekiel?= <12242002+mszekiel@users.noreply.github.com> Date: Fri, 15 May 2026 16:34:54 +0200 Subject: [PATCH 3/3] fix(console): drop unresolvable organization sub-routes from nav data The Organizations sub-routes (Overview, B2B SSO, Onboarding Portal, SCIM, Identities) all require an [organization] id; ConsoleLink only replaces [project] in URLs, so those entries would render broken links. Keep only the All organizations entry, which is the actual target of every ConsoleLink reference in the Kratos guide. --- .../ConsoleLink/console-nav-data.ts | 20 ------------------- 1 file changed, 20 deletions(-) diff --git a/src/components/ConsoleLink/console-nav-data.ts b/src/components/ConsoleLink/console-nav-data.ts index d60047157..f04baa230 100644 --- a/src/components/ConsoleLink/console-nav-data.ts +++ b/src/components/ConsoleLink/console-nav-data.ts @@ -128,26 +128,6 @@ export const organizationsPaths: Path[] = [ title: "All organizations", href: routes.project.organizations.route, }, - { - title: "Overview", - href: routes.project.organizations.details.route, - }, - { - title: "B2B SSO", - href: routes.project.organizations.b2bSso.route, - }, - { - title: "Onboarding Portal", - href: routes.project.organizations.onboardingPortal.route, - }, - { - title: "SCIM clients", - href: routes.project.organizations.scim.route, - }, - { - title: "Identities", - href: routes.project.organizations.identities.route, - }, ] export const oauthPaths: Path[] = [