Why Magic link authentication in Supabase? - Purpose & Use Cases

The Big Idea

What if your users could log in instantly without passwords or frustration?

The Scenario

Imagine you run a website where users must log in. You ask them to create passwords and remember them. When they forget, you have to reset passwords manually or send reset emails. This takes time and frustrates users.

The Problem

Manually managing passwords is slow and risky. Users forget passwords often, leading to many support requests. Sending reset emails manually can cause delays and errors. It also creates security risks if passwords are weak or reused.

The Solution

Magic link authentication solves this by sending users a special link to their email. Clicking the link logs them in instantly without passwords. This is faster, safer, and easier for users and developers.

Before vs After

✗ Before

if (checkPassword(userInput)) { loginUser(); } else { showError(); }

✓ After

sendMagicLink(email); // user clicks link to login

What It Enables

It enables password-free, secure, and seamless user login experiences that reduce friction and support overhead.

Real Life Example

A newsletter site lets users log in by sending a magic link to their email. Users never need to remember passwords, making sign-in quick and simple.

Key Takeaways

Manual password handling is slow and error-prone.

Magic links let users log in securely without passwords.

This improves user experience and reduces developer workload.

Practice

1. What is the main purpose of magic link authentication in Supabase?

easy

A. Authenticate users using biometric data like fingerprints

B. Require users to enter a password and a code sent via SMS

C. Use social media accounts for login

D. Allow users to log in by clicking a link sent to their email without using a password

Solution

1. Step 1: Understand magic link authentication

   Magic link authentication lets users log in by clicking a special link sent to their email, avoiding passwords.

2. Step 2: Compare options with this definition

   Only Allow users to log in by clicking a link sent to their email without using a password describes login via email link without passwords, matching the magic link concept.

3. Final Answer:

   Allow users to log in by clicking a link sent to their email without using a password -> Option D

4. Quick Check:

   Magic link = login via email link without password [OK]

Hint: Magic link means login by email link, no password needed [OK]

Common Mistakes:

• Confusing magic link with password or biometric login
• Thinking magic link requires SMS codes
• Assuming social login is magic link

2. Which is the correct way to call Supabase's magic link sign-in method in JavaScript?

easy

A. supabase.auth.signInWithPassword({ email: '[e-mail]' })

B. supabase.auth.signInWithOtp({ email: '[e-mail]' })

C. supabase.auth.signInWithMagicLink('[e-mail]')

D. supabase.auth.loginWithOtp('[e-mail]')

Solution

1. Step 1: Recall Supabase magic link method name

   The correct method is signInWithOtp with an object containing the email.

2. Step 2: Match method and parameter format

   supabase.auth.signInWithOtp({ email: '[e-mail]' }) uses signInWithOtp with an object { email: '...' }, which is correct syntax.

3. Final Answer:

   supabase.auth.signInWithOtp({ email: '[e-mail]' }) -> Option B

4. Quick Check:

   Method name and parameter object = supabase.auth.signInWithOtp({ email: '[e-mail]' }) [OK]

Hint: Use signInWithOtp with email in an object [OK]

Common Mistakes:

• Using wrong method names like signInWithPassword
• Passing email as a string instead of an object
• Confusing method names with social login

3. What will the following code do?

const { data, error } = await supabase.auth.signInWithOtp({ email: '[e-mail]' });
console.log(data);
console.log(error);

medium

A. Send a magic link to '[e-mail]' and log data with confirmation info, error null

B. Return error because email format is invalid

C. Throw a syntax error because signInWithOtp requires a password

D. Send a magic link to '[e-mail]' and log data with user info, error null

Solution

1. Step 1: Understand signInWithOtp behavior

   This method sends a magic link to the email and returns data about the request, not user info immediately.

2. Step 2: Analyze console output

   Data contains confirmation info about sending the link; error is null if successful. No syntax error or invalid email here.

3. Final Answer:

   Send a magic link to '[e-mail]' and log data with confirmation info, error null -> Option A

4. Quick Check:

   signInWithOtp sends link, returns confirmation data [OK]

Hint: signInWithOtp returns confirmation data, not user info [OK]

Common Mistakes:

• Expecting immediate user info in data
• Thinking password is required
• Assuming invalid email error for valid format

4. You wrote this code but users report they never receive magic links:

await supabase.auth.signInWithOtp('[e-mail]');

What is the problem?

medium

A. The method name is incorrect, should be signInWithMagicLink

B. Magic links require a password parameter

C. The email should be passed inside an object, not as a string

D. You must call a separate sendMagicLink function after signInWithOtp

Solution

1. Step 1: Check method parameter format

   signInWithOtp expects an object with an email property, not a plain string.

2. Step 2: Identify why magic link is not sent

   Passing a string causes the method to fail silently or not send the email, so users get no link.

3. Final Answer:

   The email should be passed inside an object, not as a string -> Option C

4. Quick Check:

   Email must be in object for signInWithOtp [OK]

Hint: Pass email as { email: '...' }, not just a string [OK]

Common Mistakes:

• Passing email as string instead of object
• Thinking password is needed for magic link
• Using wrong method names

5. You want to implement magic link login but only allow users with emails from 'example.com'. Which approach is best?

hard

A. Before calling signInWithOtp, check if email ends with '@example.com' and reject others

B. Call signInWithOtp for all emails, then filter users after login

C. Use signInWithOtp and set a password for domain restriction

D. Configure Supabase to block all emails except 'example.com' automatically

Solution

1. Step 1: Understand domain restriction needs

   To restrict login to a domain, validate the email before sending magic link.

2. Step 2: Choose best practice

   Checking email domain in your app before calling signInWithOtp prevents sending links to unauthorized users.

3. Final Answer:

   Before calling signInWithOtp, check if email ends with '@example.com' and reject others -> Option A

4. Quick Check:

   Pre-check email domain before magic link send [OK]

Hint: Validate email domain before sending magic link [OK]

Common Mistakes:

• Sending magic links to all emails then filtering
• Thinking password is needed for domain restriction
• Assuming Supabase blocks domains automatically