diff --git a/docs/actions/require-verified-address.mdx b/docs/actions/require-verified-address.mdx index 5f1698236..accbb5fdc 100644 --- a/docs/actions/require-verified-address.mdx +++ b/docs/actions/require-verified-address.mdx @@ -197,64 +197,3 @@ To re-enable this legacy behavior: ory patch identity-config --project --workspace \ --add '/feature_flags/legacy_continue_with_verification_ui=true' ``` - -## Verification on address change - -When a user updates their email address or phone number in the settings flow, Ory sends a verification code to the new address. By -default, the settings flow will display a success message when the profile is updated, but the address remains unverified until -the user completes the verification process. - -### Show verification screen after address change - -If you want users to be immediately redirected to verify their new address after changing it, you can configure the -`show_verification_ui` hook for the settings flow. This will redirect the user to the verification screen instead of showing a -success message. - -To enable this behavior, use the Ory CLI: - -```shell -ory patch identity-config {project_id} \ - --add '/selfservice/flows/settings/after/profile/hooks/0/hook="show_verification_ui"' -``` - -```mdx-code-block - - -``` - -For browser clients using native forms, Ory redirects to the verification flow with HTTP 302. - -```mdx-code-block - - -``` - -The settings endpoint returns a 400 error with a `continue_with` field that contains the verification flow: - -```json -{ - "id": "...", - "ui": { - "action": "...", - "method": "...", - "nodes": [ - /* ... */ - ] - }, - "continue_with": [ - { - "action": "show_verification_ui", - "flow": { - "id": "d859f6af-1dfe-453e-9320-d572e10edeea", - "verifiable_address": "example@ory.sh", - "url": "https://ory.example.org/verification?flow=d859f6af-1dfe-453e-9320-d572e10edeea" - } - } - ] -} -``` - -```mdx-code-block - - -```