docs: identifier first authentication

docs/identities/sign-in/actions.mdx

@@ -1,9 +1,11 @@
 ---
 id: actions
 title: Customize login and registration flows with webhooks and actions
-sidebar_label: Customize login and registration
+sidebar_label: Login and registration actions
 ---
 
+# Login and registration webhooks and actions
+
 ```mdx-code-block
 import Tabs from "@theme/Tabs"
 import TabItem from "@theme/TabItem"

docs/identities/sign-in/identifier-first-authentication.mdx

@@ -0,0 +1,36 @@
+---
+id: identifier-first-authentication
+title: Identifier first authentication
+sidebar_label: Identifier first authentication
+---
+
+Identifier first authentication first requests the user's identifier such as an email or username before prompting for a password
+or other authentication methods.
+
+This guide explains how to enable and use identifier first authentication in Ory Network and self-hosted Ory Kratos.
+
+## Ory Network
+
+To enable it:
+
+1. Log in to the [Ory Console](https://console.ory.sh).
+2. Select your project.
+3. Navigate to [Project Settings > Advanced](https://console.ory.sh/projects/current/settings/advanced).
+4. Enable "New Account Experience".
+5. Click "Save Changes".
+6. Test the flow in your application by navigating to the login page.
+
+To disable this feature, follow the same steps and disable "New Account Experience".
+
+## Self-hosted Ory Kratos
+
+For Ory Enterprise License and Ory Apache 2.0 License users, set the following configuration in your `kratos.yaml` config file:
+
+```yaml title="kratos-config.yaml"
+selfservice:
+  flows:
+    login:
+      style: identifier_first
+```
+
+To disable this feature, set `style` to `unified`.

src/sidebar.ts

@@ -163,7 +163,7 @@ const guidesSidebar = (flat: boolean): ExtendSidebar => {
     ...items,
     {
       type: "category",
-      label: "Authentication and login",
+      label: "Login and registration",
       collapsed: false,
       collapsible: false,
       link: {
@@ -219,7 +219,7 @@ const guidesSidebar = (flat: boolean): ExtendSidebar => {
             },
             {
               type: "category",
-              label: "Multi-factor Authentication",
+              label: "Multi-factor authentication",
               items: [
                 "kratos/mfa/lookup-secrets",
                 "kratos/mfa/totp",
@@ -228,13 +228,22 @@ const guidesSidebar = (flat: boolean): ExtendSidebar => {
                 "kratos/mfa/step-up-authentication",
               ],
             },
-            "identities/sign-in/two-step-registration",
-            "identities/sign-in/login-hint",
+            {
+              type: "category",
+              label: "Customize user experience",
+              items: [
+                "identities/sign-in/two-step-registration",
+                "identities/sign-in/identifier-first-authentication",
+                "identities/sign-in/login-hint",
+                "getting-started/custom-ui",
+                "identities/sign-in/actions",
+              ],
+            },
           ],
     },
     {
       type: "category",
-      label: "Emails & SMS",
+      label: "Emails and SMS",
       collapsed: false,
       collapsible: false,
       link: {
@@ -260,19 +269,26 @@ const guidesSidebar = (flat: boolean): ExtendSidebar => {
       items: flat
         ? []
         : [
-            "identities/sign-in/actions",
-            "actions/revoke-active-sessions",
-            "actions/session",
-            "actions/require-verified-address",
             {
               type: "category",
-              label: "Integrations",
+              label: "Identity management",
               items: [
-                "actions/integrations/hubspot",
-                "actions/integrations/mailchimp",
-                "actions/integrations/segment",
+                "identities/sign-in/actions",
+                "actions/revoke-active-sessions",
+                "actions/session",
+                "actions/require-verified-address",
+                {
+                  type: "category",
+                  label: "Integrations",
+                  items: [
+                    "actions/integrations/hubspot",
+                    "actions/integrations/mailchimp",
+                    "actions/integrations/segment",
+                  ],
+                },
               ],
             },
+            "hydra/guides/claims-at-refresh",
           ],
     },
     {
@@ -373,7 +389,6 @@ const guidesSidebar = (flat: boolean): ExtendSidebar => {
                 "hydra/guides/audiences",
                 "hydra/guides/jwt",
                 "hydra/guides/client-token-expiration",
-                "hydra/guides/claims-at-refresh",
                 "oauth2-oidc/claims-scope",
               ],
             },