Document `useWaitlist()` by brkalow · Pull Request #2754 · clerk/clerk-docs

brkalow · 2025-10-30T02:46:31Z

This pull request contains changes generated by a Cursor Cloud Agent

cursor · 2025-10-30T02:46:32Z

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
_{Learn more about Cursor Agents}

vercel · 2025-10-30T02:46:37Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
clerk-docs	Ready	Preview	Feb 4, 2026 7:47pm

docs/reference/hooks/use-waitlist.mdx

alexcarpenter · 2025-11-19T14:42:51Z

docs/reference/hooks/use-waitlist.mdx

+    await waitlist.join({ emailAddress })
+  }
+
+  if (waitlist.id) {


Does waitlist contain a status?

It does not, it's a single-step submission

Co-authored-by: bryce <bryce@clerk.dev>

The Waitlist resource doesn't use the "Future" API pattern, so rename the docs accordingly and update all references. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

alexisintech · 2026-01-12T19:59:15Z

docs/reference/javascript/waitlist.mdx

+sdk: js-frontend
+---
+
+The `Waitlist` object provides methods and properties to manage waitlist entries in your application. It is used when you want to build a custom waitlist UI instead of using the prebuilt [`<Waitlist />`](/docs/reference/components/authentication/waitlist) component.


Suggested change

The `Waitlist` object provides methods and properties to manage waitlist entries in your application. It is used when you want to build a custom waitlist UI instead of using the prebuilt [`<Waitlist />`](/docs/reference/components/authentication/waitlist) component.

The `Waitlist` object provides methods and properties to manage waitlist entries in your application. It's useful for building a [custom flow](!custom-flow) instead of using the prebuilt [`<Waitlist />`](/docs/reference/components/authentication/waitlist) component.

docs/reference/javascript/waitlist.mdx

SarahSoutoul · 2026-01-12T20:43:06Z

docs/reference/hooks/use-waitlist.mdx

@brkalow We prob want to add SDK-specific examples on top of the Next.js, like the other hooks have. So you'd need to use the <If /> component to have examples for Expo, React, React Router, Tanstack React Start and Chrome Extension on top of Next.js. We can remove Remix tho from the frontmatter, as we've done so for all other hooks.

alexisintech · 2026-01-13T23:28:13Z

for testing expo, is it @clerk/expo or @clerk/clerk-expo@canary ? I know for core-3 we're changing the package name, i've tried both and can't seem to find the import

alexisintech · 2026-01-13T23:28:25Z

hmm i've got the canary version for clerk react, but useWaitlist() isn't appearing as exported from @clerk/clerk-react

alexcarpenter · 2026-01-13T23:30:11Z

Its just @clerk/react now https://github.com/clerk/javascript/blob/main/packages/react/package.json#L2

alexisintech · 2026-01-13T23:40:58Z

just need to test expo, having issues as one usually does with expo.
also, is the waitlist api available for ios and android? if so, let's get team mobile to conjure up examples for the custom flow :~)

brkalow · 2026-01-14T01:29:01Z

@alexisintech It'll be from @clerk/expo@canary.

docs/reference/javascript/waitlist.mdx

docs/reference/hooks/use-waitlist.mdx

Co-authored-by: Michael Novotny <manovotny@gmail.com>

alexisintech · 2026-01-14T21:18:29Z

@alexisintech It'll be from @clerk/expo@canary.

hmm yeah i figured and i had tried it but its not coming up as exported

alexisintech · 2026-01-14T21:35:58Z

update: chris and i are on it to figure out expo stuff 😎

docs/reference/hooks/use-waitlist.mdx

alexcarpenter · 2026-01-15T20:57:50Z

@alexisintech we were missing some exports clerk/javascript#7609

will be merging soon once we get the tests passing again.

alexisintech

🫡 🫡 🫡

expo giving bug

alexisintech · 2026-01-21T02:42:46Z

went to start my expo app and its giving this error despite not having anything google set up in the app at all. it's using the plain email/password auth flows. cc @chriscanin

chriscanin · 2026-01-21T19:22:20Z

@alexisintech Looking into this when I get a chance!

manovotny · 2026-02-04T16:56:58Z

Any updates @chriscanin?

chriscanin · 2026-02-04T17:00:28Z

@manovotny Yes, @alexisintech has tested the canary release for the fix here: #2916 (comment)

@alexisintech has reported a type issue with the publishable key. I am looking into that now, but this PR should resolve the issue that we see above as well.

Looks like this was happening in multiple PR's.

alexisintech · 2026-02-04T19:44:24Z

@manovotny Yes, @alexisintech has tested the canary release for the fix here: #2916 (comment)

@alexisintech has reported a type issue with the publishable key. I am looking into that now, but this PR should resolve the issue that we see above as well.

Looks like this was happening in multiple PR's.

what i've been doing is merging pr's into core-3 if the only thing they're waiting on is the expo sdk, and then before core-3 ships, i'm going to do a full sweep and test all the expo examples - as to not block anymore pr's that are only waiting on the expo sdk

so we can go ahead and merge this one in

vercel bot deployed to Preview October 30, 2025 02:47 View deployment

brkalow changed the title ~~Document useWaitlistHook~~ Document useWaitlist() Oct 30, 2025

alexcarpenter reviewed Nov 19, 2025

View reviewed changes

vercel bot deployed to Preview November 19, 2025 17:45 View deployment

Base automatically changed from ds.feat/custom-flow-apis to core-3 January 9, 2026 16:03

vercel bot had a problem deploying to Preview January 9, 2026 16:53 Failure

cursoragent and others added 2 commits January 9, 2026 11:11

Add useWaitlist hook and WaitlistFuture documentation

198cffa

Co-authored-by: bryce <bryce@clerk.dev>

remove usage of react state

9300ff8

brkalow force-pushed the cursor/document-usewaitlisthook-c634 branch from 9adef8b to 9300ff8 Compare January 9, 2026 17:12

vercel bot deployed to Preview January 9, 2026 17:13 View deployment

Rename WaitlistFuture to Waitlist in docs

36b36a2

The Waitlist resource doesn't use the "Future" API pattern, so rename the docs accordingly and update all references. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

vercel bot deployed to Preview January 9, 2026 19:36 View deployment

brkalow marked this pull request as ready for review January 9, 2026 22:34

brkalow requested a review from a team as a code owner January 9, 2026 22:34

alexisintech reviewed Jan 12, 2026

View reviewed changes

SarahSoutoul reviewed Jan 12, 2026

View reviewed changes

alexisintech self-assigned this Jan 12, 2026

docs review

06297c3

vercel bot had a problem deploying to Preview January 12, 2026 23:41 Failure

add examples for other sdks

0bc83f7

vercel bot deployed to Preview January 13, 2026 23:41 View deployment

manovotny reviewed Jan 14, 2026

View reviewed changes

docs/reference/javascript/waitlist.mdx Show resolved Hide resolved

docs/reference/hooks/use-waitlist.mdx Outdated Show resolved Hide resolved

update javascript example

cae730e

Update docs/reference/hooks/use-waitlist.mdx

03bd684

Co-authored-by: Michael Novotny <manovotny@gmail.com>

vercel bot deployed to Preview January 14, 2026 21:02 View deployment

SarahSoutoul reviewed Jan 15, 2026

View reviewed changes

docs/reference/hooks/use-waitlist.mdx Outdated Show resolved Hide resolved

SarahSoutoul reviewed Jan 15, 2026

View reviewed changes

docs/reference/hooks/use-waitlist.mdx Show resolved Hide resolved

Update docs/reference/hooks/use-waitlist.mdx

7585a0a

vercel bot deployed to Preview January 19, 2026 17:24 View deployment

SarahSoutoul approved these changes Jan 19, 2026

View reviewed changes

alexisintech previously approved these changes Jan 21, 2026

View reviewed changes

Merge branch 'core-3' into cursor/document-usewaitlisthook-c634

4ab9391

vercel bot deployed to Preview February 4, 2026 19:47 View deployment

alexisintech merged commit c8902f8 into core-3 Feb 4, 2026
2 checks passed

alexisintech deleted the cursor/document-usewaitlisthook-c634 branch February 4, 2026 19:48

	The `Waitlist` object provides methods and properties to manage waitlist entries in your application. It is used when you want to build a custom waitlist UI instead of using the prebuilt [`<Waitlist />`](/docs/reference/components/authentication/waitlist) component.
	The `Waitlist` object provides methods and properties to manage waitlist entries in your application. It's useful for building a [custom flow](!custom-flow) instead of using the prebuilt [`<Waitlist />`](/docs/reference/components/authentication/waitlist) component.

Conversation

brkalow commented Oct 30, 2025

Uh oh!

cursor bot commented Oct 30, 2025

Uh oh!

vercel bot commented Oct 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

alexcarpenter Nov 19, 2025

Choose a reason for hiding this comment

Uh oh!

brkalow Nov 19, 2025

Choose a reason for hiding this comment

Uh oh!

alexisintech Jan 12, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

SarahSoutoul Jan 12, 2026

Choose a reason for hiding this comment

Uh oh!

alexisintech commented Jan 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

alexisintech commented Jan 13, 2026

Uh oh!

alexcarpenter commented Jan 13, 2026

Uh oh!

alexisintech commented Jan 13, 2026

Uh oh!

brkalow commented Jan 14, 2026

Uh oh!

Uh oh!

Uh oh!

alexisintech commented Jan 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

alexisintech commented Jan 14, 2026

Uh oh!

Uh oh!

Uh oh!

alexcarpenter commented Jan 15, 2026

Uh oh!

alexisintech left a comment

Choose a reason for hiding this comment

Uh oh!

alexisintech commented Jan 21, 2026

Uh oh!

chriscanin commented Jan 21, 2026

Uh oh!

manovotny commented Feb 4, 2026

Uh oh!

chriscanin commented Feb 4, 2026

Uh oh!

alexisintech commented Feb 4, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

vercel bot commented Oct 30, 2025 •

edited

Loading

alexisintech commented Jan 13, 2026 •

edited

Loading

alexisintech commented Jan 14, 2026 •

edited

Loading