diff --git a/docs/identities/sign-in/_static/two-step-registration.png b/docs/identities/sign-in/_static/two-step-registration.png deleted file mode 100644 index f8be47919..000000000 Binary files a/docs/identities/sign-in/_static/two-step-registration.png and /dev/null differ diff --git a/docs/identities/sign-in/two-step-registration.mdx b/docs/identities/sign-in/two-step-registration.mdx index 71238a04c..a39ef1013 100644 --- a/docs/identities/sign-in/two-step-registration.mdx +++ b/docs/identities/sign-in/two-step-registration.mdx @@ -5,30 +5,16 @@ sidebar_label: Two-step registration slug: two-step-registration --- -With a one-step registration, when you enable multiple authentication strategies (for example password, code via email, and -passkey), the identity traits will be repeated for each authentication strategy. +[Identity traits](../../kratos/manage-identities/managing-users-identities-metadata#traits) are data associated with an identity +that can be modified by the user. The traits are configured through the identity schema. -Compare this to a two-step registration: Now, the user is prompted for the identity traits in the first step, and asked to choose -a credential method for authentication next. This results in a more stream-lined user experience. +With a one-step registration - also called _unified registration_ - the identity traits will be repeated for each authentication +strategy. For example the identity traits will be repeated for the password, the code via email, and the passkey method. For this +reason unified registration is recommended for use cases where you have only one or two authentication methods enabled. -:::info +With a two-step registration - also called _profile-first registration_ - the user is prompted for the identity traits in the +first step, and asked to choose a credential method for authentication next. This results in a more stream-lined user experience +when you have more than two authentication methods enabled. -Identity traits are data associated with an identity that can be modified by the user. The traits are configured through the -identity schema. - -[Learn more about identity traits](../../kratos/manage-identities/managing-users-identities-metadata#traits) - -::: - -![Registration with two-step registration vs one-step registration](./_static/two-step-registration.png) - -To disable the legacy one-step registration, Go to and switch off **Enable legacy -one-step registration** or use the Ory CLI: - -```bash -ory list workspaces # to get the workspace id -ory list projects --workspace # to get the project id - -ory patch project --project --workspace \ - --replace '/services/identity/config/selfservice/flows/registration/enable_legacy_one_step=false' -``` +To disable the one-step unified registration, Go to and disable **Enable +unified sign up**.