# Overview

## Welcome to Waitlisty

Waitlisty is a cutting-edge micro SaaS product designed to revolutionize how businesses and individuals create and manage waitlists. With a focus on simplicity and effectiveness, Waitlisty offers a customizable waitlist form builder, tailored for product launches and other events where anticipation and demand need to be meticulously cultivated. Our platform integrates unique gamification elements, enabling you to incentivize and track referrals, turning your waitlist into a powerful marketing tool.

### Why a Viral Waitlist?

In today's digital age, creating buzz and engagement around your product or event is crucial. A viral waitlist does more than just collect names; it creates a sense of community and excitement. Here's why it's beneficial:

1. **Enhanced Engagement**: Gamification elements encourage participants to actively engage with and promote your waitlist, increasing visibility and interest.
2. **Organic Growth**: Leveraging the power of referrals, your waitlist can grow exponentially, tapping into networks beyond your immediate reach.
3. **Valuable Insights**: Gain insights into your most engaged and influential customers, allowing for targeted follow-ups and marketing strategies.
4. **Build Anticipation**: A growing waitlist generates anticipation, creating a buzz around your product or event even before its launch.
5. **Customer Validation**: Early interest helps in validating the market demand for your offering, providing invaluable feedback for product development.

### Who Benefits from Waitlisty?

Waitlisty is versatile and beneficial for a wide range of users:

1. **Product Launchers**: Ideal for startups and companies planning to launch new products. Create a buzz and validate your product before it hits the market.
2. **Event Organizers**: From exclusive events to online webinars, manage your attendees effectively while maximizing reach and interest.
3. **Content Creators and Influencers**: Grow your audience for upcoming content, projects, or collaborations.
4. **Retail and E-commerce**: Perfect for exclusive sales, product drops, or opening a new store or online platform.
5. **SaaS Businesses**: Gather early adopters for your software and build a community of engaged users.
6. **Educational Platforms**: Use for course enrollments, especially for courses with limited seats or exclusive access.

Waitlisty is more than a tool; it's your partner in creating successful, engaging, and viral campaigns. Start building your waitlist today and turn anticipation into success!


# Signup

Register and embed your custom viral waitlist in 5 minutes!

1. Visit the [registration page](https://waitlisty.io/register).

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2FxCCvfPdaal7xaXQVtiQp%2FScreenshot%202023-12-28%20at%2011.08.28%E2%80%AFPM.png?alt=media&amp;token=a2ed5a7b-8c84-4a68-8568-be628ce8d505" alt="Waitlisty registration" width="563"><figcaption></figcaption></figure>

2. Fill out the form and verify your email.
3. You'll be redirected to the projects dashboard.


# Create Waitlist

After registering for an account and after you verify your email address, you will be redirected to the Waitlisty home page. Log in and you will be taken to the Waitlisty dashboard. This is where you will create your first Waitlisty project.

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2F66qyNlxpwUbIfOoilXfh%2Fwww.waitlisty.io_projects.png?alt=media&amp;token=61073fbb-b12f-4c24-82bd-cf5f7ba61e56" alt="" width="563"><figcaption></figcaption></figure>

Click **Get started** to create a new Waitlisty project.

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2FMiCDhD1niMxpz1J6hsAo%2Fezgif-2-5397c1ce6e.gif?alt=media&amp;token=0f181484-6fa3-4934-8848-43e48f4a5852" alt=""><figcaption></figcaption></figure>

**Project name -** This will be the name of your waitlist. Something like "Our Book Launch" or "Blog Launch Waitlist".

**Waitlist URL -** This is the URL where your waitlist form will live. The referral link that is generated during signups will direct to this URL with a referral code.

You will be directed to the projects dashboard after the successful creation of a new project. Feel free to create as many projects as you like. We allow up to **100 free submissions** to any project. Additional submission may be purchased from the upgrades menu for a project.


# Waitlisty Landing Page

Every waitlist has an associated no-code landing page.

If you don't want to bother with the embeddable form, or if you don't have a website yet, you can use the provided landing page.

Every Waitlisty waitlist has an associated landing page URL that you can share. The landing page includes the Waitlisty widget.

Here's a link to Waitlisty's example landing page: <https://waitlisty.io/landing/14>

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2FLjA7pk3e9Bdbj9PxJ5ES%2FCleanShot%202025-01-24%20at%2016.43.47%402x.png?alt=media&amp;token=b2e40b13-d5a2-4a61-b489-28bfd5501d15" alt=""><figcaption><p>An example of a Waitlisty landing page</p></figcaption></figure>

### Customize your landing page by purchasing a premium waitlist

If you upgrade your waitlist to premium, you can access all customizations we offer for the landing page. You can also remove the Waitlisty branding when you upgrade a waitlist to premium.

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2FiZvU3RzAbbugZ2mWvNol%2FCleanShot%202025-01-24%20at%2016.47.45%402x.png?alt=media&amp;token=77b5f03e-debd-4997-8fa8-aaf01bf101f0" alt=""><figcaption></figcaption></figure>


# Referral Codes

Every user that signs up for your waitlist gets a unique referral code.

### What is the referral code for?

When a user joins the waitlist, they are provided with a unique referral code embedded in a shareable URL. This code can be shared with others, allowing the user to move up in the waitlist whenever someone joins using their code. This incentivizes users to spread the word and potentially access the service sooner.

### How do my users use their referral codes?

When a user signs up and is added to the waitlist, they will receive a unique URL on the thank-you page. This URL contains their referral code, and by sharing it with others, they can increase their chances of moving up the waitlist as more people join using their link.

### A waitlist user lost their referral link, how can I help them?

Currently, the best way to assist someone who lost their referral code/referral URL is to look in your submissions table for their email. There is a `Referral URL`column in the table that you can copy/paste to them in an email.

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2FmntHOYHNTtv6vpjaiqiy%2FCleanShot%202025-02-03%20at%2012.27.15%402x.png?alt=media&amp;token=c3382c2e-1b2a-4663-b684-4efd0f737e10" alt=""><figcaption><p>You can find referral codes and referral URLs in your Submissions table for a given waitlist</p></figcaption></figure>

### How are the referral URLs generated?

When you created your waitlist, you provided a URL for the project. This URL *should* be where you're embedding your Waitlisty widget. If a user joins your waitlist through the widget, the referral URL will be the project URL *plus* their referral code.

If your users join your waitlist through the associated Waitlisty landing page, then the referral URL will be the landing page URL *plus* their unique referral code.


# Embed Your Form

With Waitlisty's no-code form builder, you can create a customized, embeddable form in less than 5 minutes!

### Embeddable Form

Our embeddable form is an excellent way to get up and running quickly. Collect an email *or* a name and email. Customize font colors, sizes, borders and placeholder text. Then all you need to do is copy and paste two lines of code into your website.

#### When to use the embeddable form?

1. You want a no-code solution
2. You want to get up and running quickly
3. You only need to collect a name and an email

#### How do I embed the form in my website?

The embeddable form requires that two lines of code be copied and pasted into your website. You will need to paste the script snippet into the `<head />` of your website and then paste the form `<div>` snippet into the space / page where you want your form to appear. Your form will be displayed as an iframe in your website.

#### Step 1. Visit the Form builder page

From your projects dashboard, find and click the **Form builder** link.

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2FIOodyLmly8Quq1LGP18g%2FScreenshot%202023-12-29%20at%209.31.13%E2%80%AFAM.png?alt=media&amp;token=becd04ea-b78b-43ec-b251-5306db9eabd7" alt="" width="563"><figcaption></figcaption></figure>

#### Step 2. Find and copy the script

On the form builder page, click on "Get embed code" in the form preview box.

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2F0TMX1HN8I380nQYtJ0qH%2FCleanShot%202024-07-27%20at%2011.34.47%402x.png?alt=media&amp;token=75263dfc-ee6b-4467-a4df-607c0b2a4967" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2Fh9CLPefEppJ42oX7gBAa%2FCleanShot%202024-07-27%20at%2011.37.06%402x.png?alt=media&amp;token=a57874d3-1c91-4c25-88a4-261dccb66dcd" alt=""><figcaption></figcaption></figure>

You can also copy and paste the code below:

```html
<script src="https://jzcjrtlxrpzxgszlwttl.supabase.co/storage/v1/object/public/formbuilder_v2/formBuilder_v2.js" defer></script>
```

#### Step 3. Find and copy the css \<link>

The css link will be pasted into the `<head>` of your site's homepage. Check out our documentation for specific frameworks :arrow\_left:

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2Fw7r2Uc0bKnmMxkQbCS3E%2FCleanShot%202024-07-27%20at%2011.39.08%402x.png?alt=media&amp;token=5ea09196-259a-459d-9413-7d38eddce04f" alt=""><figcaption></figcaption></figure>

#### Step 4. Find and copy the html div

Copy this div and paste it into your website wherever you want your form to appear.

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2FW4Fdw46b2M6Q9mcLNJgK%2FCleanShot%202024-07-27%20at%2011.38.05%402x.png?alt=media&amp;token=17a12694-fe6c-4620-bdbc-2a4be6c938bf" alt=""><figcaption></figcaption></figure>

This snippet will work with the script that you pasted earlier. It will pull the appropriate waitlist from the server and load as an iframe on your website. You can also paste this snippet:

```html
<div class="waitlisty-widget" data-key-id="FORM_CODE"></div>
```

Replace **FORM\_CODE** with the unique code of your custom form (found on the form builder page).

### Framework references

We have references for specific frameworks. Check out the table of contents on the left side of your screen. :arrow\_left:


# HTML/CSS

The simplest way to embed a Waitlisty form - directly in a vanilla HTML / CSS site

Here's an example of embedding the script and div elements into a vanilla html / css site.

<pre class="language-html"><code class="lang-html">&#x3C;!doctype html>
&#x3C;html lang="en">
  &#x3C;head>
    &#x3C;meta charset="UTF-8" />
    &#x3C;meta name="viewport" content="width=device-width, initial-scale=1.0" />
    &#x3C;!-- Our Waitlisty CSS -->
    &#x3C;link rel="stylesheet" href="https://jzcjrtlxrpzxgszlwttl.supabase.co/storage/v1/object/public/formbuilder_v2/formBuilder_v2.css" />
    &#x3C;title>You Wesbite&#x3C;/title>
  &#x3C;/head>
  &#x3C;body>
    &#x3C;div>This is a website with a form in it.&#x3C;/div>
    &#x3C;!-- Our Waitlisty widget -->
    <a data-footnote-ref href="#user-content-fn-1">&#x3C;div class="waitlisty-widget" data-key-id="4zE41Vc">&#x3C;/div></a>
    &#x3C;!-- Our Waitlisty javascript -->
    &#x3C;script src="https://jzcjrtlxrpzxgszlwttl.supabase.co/storage/v1/object/public/formbuilder_v2/formBuilder_v2.js" defer>&#x3C;/script>
  &#x3C;/body>
&#x3C;/html>
</code></pre>

[^1]:


# Next.js (App Router)

Next.js doesn't allow us to use a \<link> element in our RootLayout, so here's the workaround using a \<Script> component and injecting the css.

```tsx

import Script from 'next/script'
import { type Metadata } from 'next'

import dynamic from 'next/dynamic'

export const metadata: Metadata = {
  title: {
    template: '%s - Waitlisty',
    default: 'Waitlisty - Build excitement for your product',
  },
  description: 'Build excitement for your product',
}

// A css loader string will be injected with a <Script> component
const cssLoader = `
    let head = document.getElementsByTagName('HEAD')[0];
    let link = document.createElement('link');
    link.rel = 'stylesheet';
    link.type = 'text/css';
    link.href = 'https://jzcjrtlxrpzxgszlwttl.supabase.co/storage/v1/object/public/formbuilder_v2/formBuilder_v2.css?t=2024-07-22T17%3A06%3A40.577Z';
    head.appendChild(link);
`

export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en">
      {/* Here's the script component */}
      <Script
        id="waitlist-css"
        type=""
        dangerouslySetInnerHTML={{ __html: cssLoader }}
      ></Script>
      <body suppressHydrationWarning={true}>
        {children}
      </body>
      {/* Our Waitlisty widget script */}
      <Script src="https://jzcjrtlxrpzxgszlwttl.supabase.co/storage/v1/object/public/scripts/waitlisty-widget.js" defer></Script>
    </html>
  )
}
```


# Zapier

Use our Zapier app to create workflows based on Waitlisty signups.

You can use Zapier to receive waitlist submissions on your favorite apps like Google Sheets, Airtable, Newsletter services like Mailchimp, HubSpot Convertkit, and many more.

### What is Zapier?

Zapier is an online automation tool that connects your favorite apps, such as Gmail, Slack, Mailchimp, and more. You can connect two or more apps to automate repetitive tasks without coding or relying on developers to build the integration.

With Zapier, you can connect Waitlisty Waitlist to thousands of apps and web services. Zapier can automatically trigger workflows in other apps whenever a new user signs up for your waitlist. When new triggers happen in Waitlisty, Zapier will automatically send data to the other apps you've connected.

### How to Integrate Zapier

**After choosing a project, proceed to the integrations page.**

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2FZJwy9v9SSSMq5YjKbFaM%2FCleanShot%202025-02-05%20at%2016.32.33%402x.png?alt=media&amp;token=652867be-c7a7-4b14-a073-1f16b08b94c7" alt=""><figcaption></figcaption></figure>

#### **Step 1. Generate an access token for Zapier**

On the integrations page, click on the Generate API Key button in the Zapier Integration box.

* This will generate a unique access token for your waitlist project. Copy the access token.

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2FkcMc0GWb767pQnWCrxgX%2FCleanShot%202025-02-05%20at%2016.33.36%402x.png?alt=media&amp;token=91424043-246f-4222-825e-57a04be13831" alt=""><figcaption><p>Click Generate API Key</p></figcaption></figure>

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2F0WkwhMYzv3uRIT7JFGCA%2FCleanShot%202025-02-05%20at%2016.34.14%402x.png?alt=media&amp;token=b31a5309-431d-4066-a1b7-30040517e146" alt=""><figcaption><p>Copy the API Key</p></figcaption></figure>

#### **Step 2. Create a new Zapier Zap**

Follow the steps to create a new Zapier Zap

* Log in to your Zapier account and go to the My Apps section or click on this link - <https://zapier.com/app/zaps>.
* Then click the **+ Create Zap** button.

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2Fee20PHMSzgAeXtcbvCLI%2FCleanShot%202025-02-05%20at%2016.35.26%402x.png?alt=media&amp;token=5fcc1f5c-6535-4d45-a939-cad68d9f4590" alt=""><figcaption><p>Create a new Zapier Zap</p></figcaption></figure>

Create a trigger action

* You'll be taken to the Zap editor
* Click on **1. Trigger** button and search for **Waitlisty** in the popup.
* Select **Waitlisty** from the list of apps.

<figure><img src="https://2983130113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3sfNBak5xrxoekUVDnqS%2Fuploads%2FYpvhUyW8loZhFgWbHW74%2FCleanShot%202025-02-05%20at%2016.39.22.gif?alt=media&amp;token=3d5a6637-095f-4399-b960-33c09776307a" alt=""><figcaption></figcaption></figure>

#### Step 3. Integrate with Waitlisty

You'll see the options for **Trigger Event** on the right side of the page.

* Select the **Waitlisty Signup** event from the list.
* Then click **continue.**
* You will be asked to connect your Waitlisty account.
* Paste the API Key that you copied from Waitlisty into the popup input.
* You'll then test the trigger. This will pull in the latest Waitlisty submission from your project. If you do not have any submissions, a sample submission will be generated.

Then you'll select an event action. This event action will be performed whenever someone submits to your Waitlisty waitlist.

### Payload Events

Waitlisty currently supports the following events:

* New Waitlisty signup (someone submits a Waitlisty form)

The following is available in the **waitlist signup** payload:

| Key                | Type                                                | Description                                                   |
| ------------------ | --------------------------------------------------- | ------------------------------------------------------------- |
| event\_type        | "new\_signup"                                       | The type of event                                             |
| created\_at        | string                                              | The timestamp when the signup happened.                       |
| email              | string                                              | The user's email.                                             |
| full\_name         | string                                              | The user's full name (if entered).                            |
| status             | string                                              |                                                               |
| referral\_code     | string                                              | The referral code for the user.                               |
| referral\_points   | number                                              | How many points the user has (default 5 points per referral). |
| position           | number                                              | Their position in the list.                                   |
| referred\_by\_code | string                                              | The referral code of who referred them.                       |
| user\_json         | json (extra data like questions and responses, etc) | JSON of extra data collected in the form.                     |
| waitlist\_id       | number                                              | The id for the waitlist project.                              |


