Skip to main content
Docs

Build URLs

These are all methods on the Clerk class that help you manage URL creation on the Clerk dashboard configuration.

buildUrlWithAuth()

function buildUrlWithAuth(to: string, options?: BuildUrlWithAuthParams): string;

Decorates the provided url with the auth token for development instances.

Properties

  • Name
    to
    Type
    string
    Description

    The route to create a URL towards

  • Name
    options
    Type
    BuildUrlWithAuthParams
    Description

    Options to apply toward the URL builder

  • Name
    useQueryParam
    Type
    boolean | null | undefined
    Description

    Controls if dev browser JWT is added as a query param

Returns

TypeDescription
stringThe built URL decorated with the auth token

buildSignInUrl()

function buildSignInUrl(options?: RedirectOptions): string;

Returns the configured url where <SignIn /> is mounted or a custom sign-in page is rendered.

Properties

  • Name
    options
    Type
    RedirectOptions | undefined
    Description

    Options used to control the redirect in the constructed URL

Returns

TypeDescription
stringThe built sign-in URL

buildSignUpUrl()

function buildSignUpUrl(options?: RedirectOptions): string;

Returns the configured url where <SignUp /> is mounted or a custom sign-up page is rendered.

Properties

  • Name
    options
    Type
    RedirectOptions | undefined
    Description

    Options used to control the redirect in the constructed URL

Returns

TypeDescription
stringThe built sign-up URL

buildUserProfileUrl()

function buildUserProfileUrl(): string;

Returns the url where <UserProfile /> is mounted or a custom user-profile page is rendered.

Returns

TypeDescription
stringThe url where <UserProfile /> is mounted or a custom user-profile page is rendered.

buildHomeUrl()

function buildHomeUrl(): string;

Returns the url that you've configured in your app's Clerk dashboard.

Returns

TypeDescription
stringThe url that you've configured in your app's Clerk dashboard.

buildCreateOrganizationUrl()

function buildCreateOrganizationUrl(): string;

Returns the configured url where <CreateOrganization /> is mounted or a custom create-organization page is rendered.

Returns

TypeDescription
stringThe configured url where <CreateOrganization /> is mounted or a custom create-organization page is rendered.

buildOrganizationProfileUrl()

function buildOrganizationProfileUrl(): string;

Returns the configured url where <OrganizationProfile /> is mounted or a custom organization-profile page is rendered.

Returns

TypeDescription
stringThe configured url where <OrganizationProfile /> is mounted or a custom organization-profile page is rendered.

Feedback

What did you think of this content?

Last updated on