Skip to content
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.

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

chore: use a partial for the custom flows callout #1704

Merged
merged 3 commits into from
Nov 14, 2024
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
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: 2 additions & 0 deletions docs/_partials/custom-flows-callout.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, use the [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
3 changes: 1 addition & 2 deletions docs/custom-flows/add-email.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom flow for adding an email to a user's account
description: Learn how to use Clerk's API to build a custom flow for adding an email to a user's account.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

Users are able to add multiple email addresses to their account.

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/add-phone.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom flow for adding a phone number to a user's account
description: Learn how to use Clerk's API to build a custom flow for adding a phone number to a user's account.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

Users are able to add multiple phone numbers to their account.

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/bot-sign-up-protection.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Add bot protection to your custom sign-up flow
description: Learn how to add Clerk's bot protection to your custom sign-up flow.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

Clerk provides the ability to add a CAPTCHA widget to your sign-up flows to protect against bot sign-ups. Clerk's [`<SignUp />`](/docs/components/authentication/sign-up) component handles this flow out-of-the-box. However, if you're building a custom user interface, this guide will show you how to add the CAPTCHA widget to your custom sign-up flow.

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/email-password-mfa.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom sign-in flow with multi-factor authentication
description: Learn how to build a custom email/password sign-in flow that requires multi-factor authentication (MFA).
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

[Multi-factor verification (MFA)](/docs/authentication/configuration/sign-up-sign-in-options) is an added layer of security that requires users to provide a second verification factor to access an account.

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/email-password.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom email/password authentication flow
description: Learn how to build a custom email/password sign-up and sign-in flow using Clerk's API.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

This guide will walk you through how to build a custom email/password sign-up and sign-in flow.

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/email-sms-otp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom email or SMS OTP authentication flow
description: Learn how build a custom email or SMS one time code (OTP) authentication flow using Clerk's API.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

Clerk supports passwordless authentication, which lets users sign in and sign up without having to remember a password. Instead, users receive a one-time password (OTP), also known as a one-time code, via email or SMS, which they can use to authenticate themselves.

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/forgot-password.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Create a custom Forgot Password flow using Clerk's API
description: Create a custom forgot password flow for your users using the lower level methods provided by the ClerkJS SDK.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, you should use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

Clerk's [prebuilt components](/docs/components/overview) provide a **Forgot Password** flow for your users out-of-the-box. However, if you're building a custom user interface, this guide will show you how to use Clerk's API to build a custom **Forgot Password** flow.

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/google-one-tap.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom Google One Tap authentication flow
description: Learn how to build a custom Google One Tap authentication flow using Clerk's API.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

[Google One Tap](https://developers.google.com/identity/gsi/web/guides/features) enables users to press a single button to authentication in your Clerk application with a Google account.

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/invitations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Sign-up with application invitations
description: Learn how to use Clerk's API to build a custom flow for handling application invitations.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, you should use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

When a user visits an [invitation](/docs/users/invitations) link, and no custom redirect URL was specified, then they will be redirected to Clerk's [Account Portal sign-up page](/docs/customization/account-portal/overview#sign-up) and **their email address will be automatically verified.**

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/manage-sms-based-mfa.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom flow for managing SMS-based multi-factor authentication
description: Learn how to use Clerk's API to build a custom flow for managing SMS-based multi-factor authentication.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

[Multi-factor verification (MFA)](/docs/authentication/configuration/sign-up-sign-in-options) is an added layer of security that requires users to provide a second verification factor to access an account.

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/manage-totp-based-mfa.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom flow for managing TOTP-based multi-factor authentication
description: Learn how to use Clerk's API to build a custom flow for managing TOTP-based multi-factor authentication.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

[Multi-factor verification (MFA)](/docs/authentication/configuration/sign-up-sign-in-options) is an added layer of security that requires users to provide a second verification factor to access an account.

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/multi-session-applications.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom multi-session flow
description: Learn how to use Clerk's API to add multi-session handling to your application.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

A multi-session application is an application that allows multiple accounts to be signed in from the same browser at the same time. The user can switch from one account to another seamlessly. Each account is independent from the rest and has access to different resources.

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/oauth-connections.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom flow for authenticating with OAuth connections
description: Learn how to use Clerk's API to build a custom sign-up and sign-in flow that supports OAuth connections.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, you should use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

## Before you start

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/passkeys.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom authentication flow using passkeys
description: Learn how to use Clerk's API to build a custom authentication flow using passkeys.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

Clerk supports passwordless authentication via passkeys, enabling users to sign in without having to remember a password. Instead, users select a passkey associated with their device, which they can use to authenticate themselves.

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/saml-connections.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom flow for authenticating with SAML connections
description: Learn how to use Clerk's API to build a custom sign-up and sign-in flow that supports OAuth connections.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, you should use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

## Before you start

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/sign-out.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom sign-out flow
description: Learn how to use Clerk's API to build a custom sign-out flow using Clerk's signOut() function.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, you should use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

Clerk's [`<UserButton />`](/docs/components/user/user-button) and [`<SignOutButton />`](/docs/components/unstyled/sign-out-button) components provide an out-of-the-box solution for signing out users. However, if you're building a custom solution, you can use the [`signOut()`](/docs/references/javascript/clerk/clerk#sign-out) function to handle the sign-out process.

Expand Down
3 changes: 1 addition & 2 deletions docs/custom-flows/user-impersonation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom flow for handling user impersonation
description: Learn how to build a custom flow using Clerk's API that handles user impersonation.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, you should use Clerk's [Account Portal pages](/docs/customization/account-portal/overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

User impersonation is a way to offer customer support by logging into your application from their accounts. Doing so enables you to directly reproduce and remedy any issues they're experiencing.

Expand Down
3 changes: 1 addition & 2 deletions docs/organizations/accept-organization-invitations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Accept organization invitations
description: Learn how to use Clerk's API to build a custom flows for handling organization invitations.
---

> [!WARNING]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, you should use Clerk's [Account Portal pages](/docs/customization/account-portal//overview) or [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

When a user visits an [organization invitation](/docs/organizations/invitations) link, and no custom redirect URL was specified, and they have an account for your application, then they will be redirected to Clerk's [Account Portal sign-in page](/docs/customization/account-portal/overview#sign-in). If they do not have an account for your application, they will be redirected to Clerk's [Account Portal sign-up page](/docs/customization/account-portal/overview#sign-up).

Expand Down
3 changes: 1 addition & 2 deletions docs/organizations/creating-organizations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom flow for creating organizations
description: Learn how to use Clerk's API to build a custom flow for creating organizations.
---

> [!CAUTION]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To create organizations using a _prebuilt_ UI, you should use Clerk's [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

[Organizations](/docs/organizations/overview) are a powerful feature in Clerk that allow you to group users together and manage their permissions. Organizations can be created and managed using the [Clerk Dashboard](https://dashboard.clerk.com), but you can also allow users within your application to create organizations.

Expand Down
3 changes: 1 addition & 2 deletions docs/organizations/custom-organization-switcher.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom flow for switching organizations
description: Learn how to use Clerk's API to build a custom flow for switching between organizations.
---

> [!CAUTION]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To switch organizations using a _prebuilt_ UI, you should use Clerk's [`<OrganizationSwitcher />`](/docs/components/organization/organization-switcher) component.
<Include src="_partials/custom-flows-callout" />

This guide will demonstrate how to use Clerk's API to build a custom flow for switching between organizations.

Expand Down
3 changes: 1 addition & 2 deletions docs/organizations/inviting-users.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,7 @@ description: Learn how to use Clerk's API to build a custom flow for creating an

{/* TODO: POST-IA rename this file. Don't do right now because the sidebar is going to be changed for the IA anyways, and it's one less redirect we have to deal with. */}

> [!CAUTION]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To invite users to an organization using a _prebuilt_ UI, you should use Clerk's [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

Organization members with appropriate [permissions](/docs/organizations/roles-permissions) can invite new users to their organization and manage those invitations. The invitation recipient can be either an existing user of your application or a new user. If they are a new user, they will need to sign up in order to accept the invitation.

Expand Down
3 changes: 1 addition & 2 deletions docs/organizations/manage-invitations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom flow for managing a user's organization invitations
description: Learn how to use Clerk's API to build a custom flow for managing a user's organization invitations.
---

> [!CAUTION]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To use a _prebuilt_ UI, you should use Clerk's [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

This guide will demonstrate how to use Clerk's API to build a custom flow for managing a user's [organization invitations](/docs/organizations/overview#organization-invitations).

Expand Down
3 changes: 1 addition & 2 deletions docs/organizations/manage-membership-requests.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom flow for managing organization membership requests
description: Learn how to use Clerk's API to build a custom flow for managing organization membership requests.
---

> [!CAUTION]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To manage organization membership requests using a _prebuilt_ UI, you should use Clerk's [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

This guide will demonstrate how to use Clerk's API to build a custom flow for managing [organization membership requests](/docs/organizations/overview#membership-requests).

Expand Down
3 changes: 1 addition & 2 deletions docs/organizations/managing-roles.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom flow for managing member roles in an organization
description: Learn how to use Clerk's API build a custom flow for managing member roles in an organization.
---

> [!CAUTION]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To manage member roles in an organization using a _prebuilt_ UI, you should use Clerk's [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

Organization members with appropriate [permissions](/docs/organizations/roles-permissions#permissions) can manage a member's [role](/docs/organizations/roles-permissions#roles) and remove members within an organization.

Expand Down
3 changes: 1 addition & 2 deletions docs/organizations/updating-organizations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom flow for updating an organization
description: Learn how to use Clerk's API to build a custom flow for updating an organization in your application.
---

> [!CAUTION]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To update organizations using a _prebuilt_ UI, you should use Clerk's [prebuilt components](/docs/components/overview).
<Include src="_partials/custom-flows-callout" />

Organization members with appropriate [permissions](/docs/organizations/roles-permissions) can update an organization. Currently, only the organization name and slug can be updated.

Expand Down
3 changes: 1 addition & 2 deletions docs/organizations/viewing-memberships.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ title: Build a custom flow for viewing a user's organization memberships
description: Learn how to use Clerk's API to build a custom flow for viewing a user's organization memberships.
---

> [!CAUTION]
> This guide is for users who want to build a _custom_ user interface using the Clerk API. To view the list of a user's organization memberships using a _prebuilt_ UI, you should use Clerk's [`<OrganizationList/>`](/docs/components/organization/organization-list) component.
<Include src="_partials/custom-flows-callout" />

This guide will demonstrate how to use Clerk's API to build a custom flow for viewing the list of a user's organization memberships.

Expand Down
Loading