# Let users log in with a magic link

> Turn on magic links, create a magic link template, and let users log in from a link sent by email, with limits on expiry, use count and IP address.

Source: https://tadabase.com/docs/users-security/magic-links  
Status: Verified Nov 17, 2026. Checked against the current product

A magic link logs a user in when they click it, with no password. Users can ask for one from your Login component, or you can put one in an email you send them. Each link expires, can be used a set number of times, and is logged.

## Turn on magic links

1. **Open User Settings** In the builder, open **Settings** > **User Settings**, **General** tab.
2. **Enable Magic Links** Scroll to **Magic Links** and turn on **Enable Magic Links**, then save. A **Magic Links** tab appears at the top of User Settings.

> **Note:** Magic links are a plan feature. If your plan does not include them, the switch shows an upgrade icon and the Magic Links tab offers an upgrade instead.

## Create a magic link template

A magic link template sets the rules every link made from it follows. You need at least one before you can send links.

1. **Open the Magic Links tab** In **User Settings**, open **Magic Links**, then **Templates**, and click **Add New**.
2. **Fill in the template** Enter a **Magic Link Name** and set the options in the table below.
3. **Save** Click **Save**. The switch at the top of the form turns the template **Active** or **Inactive**; links from an inactive template stop working.

| Option | What it does |
| --- | --- |
| **Link Expiration Time (Minutes)** | How long each link stays valid after it is created. |
| **Maximum Link Usage** | How many successful logins one link allows. Set it to `1` for a link that works once. |
| **Magic Link Landing Page** | The page the link opens. It must contain a Login component. |
| **Redirect User Upon Successful Login** | Where the user goes after logging in: **No** (the app's home page), **Login Component Settings** (the redirect rules of the Login component on the landing page), **To a Page in the App** or **To a URL**. A redirect set on the link in an email takes priority. |
| **Send Webhook** | Sends a webhook to the **Webhook URL** each time someone uses a link. |
| **Allowed IP Addresses/CIDR Blocks** | Only these IP addresses or ranges, separated by commas, can use the link (for example `203.0.113.0/24`). |
| **Skip 2fa** | If your app uses two-factor authentication, a user who logs in with the link is not asked for a code. HIPAA-protected apps always ask for the code. |

![The Magic Links tab of User Settings with the Templates, Active Links and Access Logs tabs and a list of magic link templates](https://tadabase.com/docs-shots/users-security-magic-links-templates.webp)

## Let users ask for a link from the Login component

Once magic links are on and a template exists, the Login component gets a **Magic Link Form**: the user enters their email and receives a link.

1. **Edit the Login component** Open the page with your Login component and edit the component.
2. **Choose the template** Open the **Magic Link Form** section and pick a template under **Magic Link Template**.
3. **Write the email** On the **Magic Link Template** email tab, choose **Use Template** to send one of your email templates, or **Custom** to write the subject and body here. In a custom body, `{magicLink}` is the link and `{name}` is the user's name.
4. **Show the form first (optional)** In the component's options, set **Default Form** to **Magic Link** to open the magic link form instead of the password form.

The user sees "The magic link has been sent to your email." The Login component's role and status rules still apply: a user they exclude gets "You don't have permission to continue." instead.

## Send a magic link in an email

1. **Open an email template** Open the email template you want to send from your app's **Email Templates**.
2. **Add the magic link** On the template's **Magic Link** tab, click **Add Magic Link**. Choose the template under **Select Magic Link**, set **Link Type** to **Full HTML** (a ready-made link) or **URL** (the bare address), and pick **Redirect Upon Login**, or leave **Use Magic Link Template Settings**.
3. **Send it** Send the template from a workflow's **Send Email** step. Each email gets its own link for the user it is sent about.

The **Magic Link** tab only appears on email templates when magic links are turned on.

## What happens when the link is clicked

- A valid link logs the user in and sends them to the redirect you chose.
- If two-factor authentication is on and **Skip 2fa** is off, the user is asked for the emailed code first.
- An expired link shows "This magic link has expired and can no longer be used."
- A link that has reached **Maximum Link Usage** shows "This magic link has reached its usage limit and can no longer be used."
- A link from an inactive template shows "This magic link configuration is no longer active."
- A link opened from an address outside **Allowed IP Addresses/CIDR Blocks** is refused.
- If your app is set to **Single sign-on only**, users cannot request links from the Login component; links you send still work.

## Check who used a link

In **User Settings** > **Magic Links**:

- **Active Links** lists every link created: the user, the template, the record it was sent about, allowed sessions, successes, failures, expiry and status. Click **Disable** to stop an active link working.
- **Access Logs** lists every attempt to use a link, with the user, status, IP address and time.
