Skip to content

Document connection-based sign-up in self-registration flow #6254

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
DilshanSenarath merged 1 commit into from
Jul 12, 2026
Merged

Document connection-based sign-up in self-registration flow #6254

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion en/includes/guides/flows/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Design and customize key user journeys in your application with Flows. A flow de

{{product_name}} lets you build fully customizable flows for the following user interactions.

- **Self registration** - Create seamless registration experiences for new users, with support for multi-step forms, data validation, and identity verification checks.
- **Self registration** - Create seamless registration experiences for new users, with support for multi-step forms, data validation, and identity verification checks. Users can also sign up through a supported connection such as Google, Apple, Facebook, Microsoft, or GitHub.

- **Password recovery** - Build secure recovery processes to help users regain access, using steps such as email verification or one-time passwords (OTP).

Expand Down
26 changes: 19 additions & 7 deletions en/includes/guides/flows/self-registration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -93,17 +93,29 @@

With these changes, new users will only provide the essentials **Email** and **password** and must verify their email via Magic Link before completing registration.

{% if product_name == "WSO2 Identity Platform" %}
## Add a connection-based sign-up option

!!! Note
When using a connection-based sign-up option (such as Google or Microsoft), configure the authorized redirect URL in the connection settings as: `https://accounts.asgardeo.io/t/{tenant-domain}/accounts/register`
You can let users register through an external identity provider by adding a connection widget to the flow. The following connections are supported:

{% else %}
- [Google]({{base_path}}/guides/authentication/social-login/add-google-login/)
- [Apple]({{base_path}}/guides/authentication/social-login/add-apple-login/)
- [Facebook]({{base_path}}/guides/authentication/social-login/add-facebook-login/)
- [Microsoft]({{base_path}}/guides/authentication/social-login/add-microsoft-login/)
- [GitHub]({{base_path}}/guides/authentication/social-login/add-github-login/)

!!! Note
When using a connection-based sign-up option (such as Google or Microsoft), configure the authorized redirect URL in the connection settings as: `https://{is_host}/t/{tenant-domain}/accounts/register`
To add a connection to the self-registration flow:

{% endif %}
1. Register the connection under **Console** > **Connections** by following the setup guide linked above for the provider you want to use.

2. {% if product_name == "WSO2 Identity Platform" %}In the connection settings, set the authorized redirect URL to: `https://accounts.asgardeo.io/t/{tenant-domain}/accounts/register`{% else %}In the connection settings, set the authorized redirect URL to: `https://{is_host}/t/{tenant-domain}/accounts/register`{% endif %}

3. Open the **Self Registration** flow in the Flow Builder.

4. From the **Widgets** panel, drag the `Continue with {Provider}` widget onto the canvas.
Comment thread
DilshanSenarath marked this conversation as resolved.

5. Draw a connection from the widget's button to the next step (for example, the End node for immediate completion, or a follow-up step such as profile completion).

Check warning on line 116 in en/includes/guides/flows/self-registration.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'widget's'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'widget's'?", "location": {"path": "en/includes/guides/flows/self-registration.md", "range": {"start": {"line": 116, "column": 31}}}, "severity": "WARNING"}

6. Save and enable the flow.

## Reference

Expand Down
Loading