# Passwordless login

Last updated: May 14, 2025

## Overview

Passwordless login allows a frictionless login experience for your customers.

{% hint style="success" %}
Passwordless login feature is available on our [<mark style="color:blue;">💎 Excel plan.</mark>](https://help.smartrr.com/docs/getting-started/onboarding/plans)&#x20;
{% endhint %}

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Fb5HuFzOxRVY69FbQF5Ff%2FDesktop%20%E2%80%93%20Check%20Your%20Email.png?alt=media&#x26;token=d27486d7-d030-4a05-8d5a-714d4965dc58" alt=""><figcaption><p>Example of <strong>magic link</strong> passwordless type. Magic links allow the customer to log in with a link sent to their email address.</p></figcaption></figure>

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FqgxlAIrceFQvPaxny4bs%2FDesktop%20%E2%80%93%20Enter%20Code%2C%20Success%20(1%20Second).jpg?alt=media&#x26;token=00e6393e-4e38-4ddf-aa9d-3584685a1998" alt=""><figcaption><p>Example of <strong>one-time code</strong> passwordless type. prompts the customer to paste a six-digit generated code sent to their email address.</p></figcaption></figure>

## Passwordless Login Setup

### Step 1: Smartrr Admin

In Smartrr's admin, navigate to **Theming** in the left-hand menu. Under the **Advanced** settings tab, you will see a toggle to turn on Passwordless log-in. &#x20;

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FucL43ny5CKEuinCQbZGV%2Fpasswordless.gif?alt=media&#x26;token=451b2061-0746-47e6-b7ea-d1e9c6d45420" alt=""><figcaption><p>The default passwordless login type is Magic Link. Select to change to One Time Code if you prefer. </p></figcaption></figure>

Press **Save changes** and confirm changes will be applied to either your live theme or a duplicate of your current live theme.&#x20;

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Ftd18SdlssRCUs256T0yy%2FScreenshot%202024-04-10%20at%201.45.34%E2%80%AFPM.png?alt=media&#x26;token=413ed7f7-a2ee-424a-b968-0d671dad58b4" alt=""><figcaption></figcaption></figure>

### Step 2: Shopify Liquid&#x20;

After passwordless has been toggled on in your Smartrr admin, a liquid file called <mark style="color:purple;">**`smartrr-passwordless-login.liquid`**</mark> snippet file will be generated in the Shopify theme you saved to. Please check in the selected theme to see if this file is present.&#x20;

Next, check the following code has been injected into the theme’s <mark style="color:purple;">**`main-login.liquid file or customers/login.liquid file`**</mark>. If this code is not injected, please copy onto **line 1** of the file:&#x20;

{% code overflow="wrap" %}

```
// <div id="smartrr_passwordless_form" class="customer login section-{{ section.id }}-padding">
    {%- form 'customer_login', novalidate: 'novalidate' -%}
      {% render 'smartrr-passwordless-login' %}
    {%- endform -%}
  </div>
```

{% endcode %}

Finally, check your shop's account login page to confirm Smartrr's passwordless login page is visible. By default, the page should look like this:&#x20;

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FKMwTtyxHhHbeYVbJPcdU%2FDesktop%20%E2%80%93%20Login.png?alt=media&#x26;token=d89835e9-c9d2-4147-90d0-d78a6eaaa911" alt=""><figcaption><p>Default login page for Magic Link passwordless login.</p></figcaption></figure>

{% hint style="info" %}
🎨 Want to apply additional styling to your shop's passwordless login page? Use CSS to style at the top of the <mark style="color:purple;">**`smartrr-passwordless-login.liquid file`**</mark>.
{% endhint %}

If you need any assistance in the setup process or additional theming for the login page, please contact us at [<mark style="color:blue;">support@smartrr.com</mark>](mailto:support@smartrr.com).

### Step 3: Disabling reCAPTCHA (required for Magic Link ONLY)

When using Magic Link as your passwordless login option you will need to disable reCAPTCHA for login within your Shopify store.

To do this go to Shopify: **Sales Channels > Online Store > Preferences > deselect "Enable reCAPTCHA on login, create account and password recovery pages"** (see below).

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Fc0SP8AzX7WVm2wWJvFx1%2Fimage.png?alt=media&#x26;token=c4a050d1-839e-4eed-ad37-5bdb4eac2bdf" alt=""><figcaption><p>This is the required reCAPTCHA configuration for using Smartrr Magic Link.</p></figcaption></figure>

## Customer Notifications

You can configure what the emails look like for both Magic Link and One Time Code passwordless options from the Customer Notifications settings in the Smartrr App.&#x20;

Scroll down to the card for Passwordless Login. Click on emails to edit.&#x20;

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FXZCGpNUKMURFjoWZCXEy%2FScreenshot%202024-04-10%20at%201.45.54%E2%80%AFPM.png?alt=media&#x26;token=7670282a-eb9d-4d56-8418-359c2dd04703" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FoqSyYzaos87DJe4bW24u%2FScreenshot%202024-04-10%20at%201.46.37%E2%80%AFPM.png?alt=media&#x26;token=a8bf6310-4909-49c2-8d9f-9137583d0546" alt=""><figcaption><p>Default email for One Time Code passwordless login type.</p></figcaption></figure>

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Fs4puGthd7wL3WUbWXqt4%2FScreenshot%202024-04-10%20at%201.48.44%E2%80%AFPM.png?alt=media&#x26;token=05f82474-d8c0-4fa6-908a-06316c858108" alt=""><figcaption><p>Default email for Magic Link passwordless login type.</p></figcaption></figure>

## FAQs

#### 1. Why do customers still need to enter a password when initially creating an account?

Due to Shopify limitations, customers will still be expected to create a password if they creating a new account with your store. After this, the customer will not be required to use this password again to log in to their account and will be able to log in with a one-time code.&#x20;

#### 2. Can I revert back to traditional Shopify login from passwordless login?

Technically, yes. Under Theming > Advanced, switch the radio option from Passwordless login back to Traditional login. However, if you switch back to traditional from passwordless login, all customers will be required to reset their passwords upon next log in.

{% hint style="warning" %}
**Note:** If you switch back to traditional from passwordless login, all customers will be required to reset their passwords upon next log in.&#x20;
{% endhint %}

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FyhMCm0xER4ZksNQDO4hT%2FScreenshot%202024-04-10%20at%201.50.14%E2%80%AFPM.png?alt=media&#x26;token=526d5eda-b8cb-40ea-bdd2-da3976e840f6" alt=""><figcaption></figcaption></figure>