# Sign-up apps

> Let visitors sign up on your published document to get their own private, editable copy at their own address.

Source: https://hyperclay.com/docs/sign-up-apps/

You can turn a published document into a sign-up app (also called a multi-tenant app) so visitors can create an account and get their own editable copy of your document at their own address. Your original document stays unchanged.

> [!TIP]
> If visitors only need to keep their edits in their own browser without creating an account, use the ClayJS [people and visitor drafts](https://clayjs.com/docs/plugins/people/) plugin instead. See [Free documents for visitors](https://clayjs.com/docs/guide/free-documents/) in the ClayJS guide.

## Enable signups on a document

1. Make sure your document is public. Private documents refuse visitor signups with a 404 error.
2. If your document uses a [custom domain](https://hyperclay.com/docs/custom-domains/), configure a wildcard custom domain (`*.yourdomain.com`) on the document first. Hyperclay requires a wildcard domain when custom domains are attached so each user's copy can be served on its own subdomain.
3. Open the document's file actions menu and click **Enable signups**.
4. In the **Enable signups** dialog, click **Enable signups** to confirm.

You can turn signups off at any time by opening the same menu and clicking **Disable signups**. Turning signups off prevents new visitors from signing up, while copies that people already created continue to work.

## Link to the signup, login, and password reset pages

After enabling signups on a document named `<app-name>.html`, add links to these three routes in your document's interface so visitors can create an account and return to their copy:

| Action | URL | What it does |
| --- | --- | --- |
| **Sign up** | `https://<your-username>.hyperclay.com/_/signup/<app-name>.html` | Creates an account and a personal copy of the document |
| **Login** | `https://<your-username>.hyperclay.com/_/login/<app-name>.html` | Signs an existing user in to their copy |
| **Forgot password** | `https://<your-username>.hyperclay.com/_/forgot-password/<app-name>.html` | Sends a password reset email |

## What happens when a visitor signs up

1. On the signup page (`/_/signup/<app-name>.html`), the visitor enters a **Username** (lowercase letters, numbers, and underscores), **Email address**, **Password** (at least 8 characters, avoiding common passwords), and **Confirm password**, then clicks **Create app account**. (A visitor who is already signed in to an existing Hyperclay account sees a **Create instance** button instead.)
2. Hyperclay sends a **Confirm your email** message with a confirmation link (`/_/confirm-email/<token>`), and the page asks the visitor to check their email to activate their account.
3. Hyperclay copies your document's current HTML into a new root-level document in the visitor's own namespace, with its own version history starting at `Initial version`. If the visitor already has a document with that file name, Hyperclay names the new copy `<app-name>-1.html`, `<app-name>-2.html`, and so on.
4. The visitor is redirected to their copy at `https://<their-username>.hyperclay.com/<app-name>.html`, or `https://<their-username>.<yourdomain.com>/<app-name>.html` when your document uses a wildcard custom domain.

## Ownership and updates

Each copy belongs to the person who signed up, not to you:

- You cannot view a list of who signed up or edit someone else's copy from your workspace.
- Each copy is a snapshot of your document's HTML at the moment the visitor signed up. Later edits you make to your original document do not automatically flow into existing copies. If you want copies to pull template updates when you publish changes, build your document with the [ClayJS upgrade plugin](https://clayjs.com/docs/plugins/upgrade/).

## Plan limits

Enabling signups requires an active paid plan (**Personal** or **Maker**) or team editor access on a paid workspace. If your plan lapses, you can still click **Disable signups**, but turning signups back on requires an active subscription.

There is no limit on how many visitors can sign up for your sign-up app. Your plan limits how many of your own documents can have signups enabled at the same time:

- **Personal**: 1 sign-up app to start, growing by 1 for each month you remain subscribed, up to a maximum of 3.
- **Maker**: 5 sign-up apps to start, growing by 2 for each month you remain subscribed, up to a maximum of 25.
