---
title: "Customer Accounts"
description: "Enable passwordless customer accounts with OTP login"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.firearmcart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer Accounts

Allow customers to create accounts and access order history, manage addresses, and set their preferred FFL dealer — all with a simple one-time code login. No passwords required.
---

## Features

| Feature | Description |
|---------|-------------|
| **Passwordless login** | Customers sign in with a 6-digit one-time code sent to their email |
| **Order history** | View recent orders with their date, status, and total |
| **Profile management** | Update name, phone number, and marketing preferences |
| **Address book** | Save multiple addresses and choose a default |
| **FFL dealer selection** | Set a preferred FFL dealer for firearms purchases |

---

## Enabling Customer Accounts

1. Navigate to **Settings > General**
2. Find the **Customer Accounts** card
3. Toggle **Enable customer accounts** on
4. Click **Save Settings**
> **Note:** When enabled, a "Sign In" or "Account" link appears in your storefront navigation (depending on your theme).

---

## How Login Works

Customer accounts use one-time passcode (OTP) authentication — no passwords to remember or reset.

### Login Flow

1. Customer clicks the account link on your storefront to reach the **Sign in** page
2. Customer enters their email address and clicks **Continue**
3. A 6-digit verification code is sent to their email
4. Customer enters the code and clicks **Verify** (or uses **Resend code** if it never arrived)
5. They're signed in and redirected to their account dashboard — or straight back to checkout if that is where they came from

### Security Details

| Detail | Value |
|--------|-------|
| **Code length** | 6 digits |
| **Code expiration** | 10 minutes |
| **Max verification attempts** | 5 per code |
| **Rate limit** | 5 codes per hour per email |
| **Session duration** | 30 days |

> **Tip:** If a customer doesn't have an account yet, one is automatically created when they first verify their email.

---

## Customer Account Features

### Order History

The **Order History** card lists the customer's 20 most recent orders, showing:

- Order number
- Order date
- Order status
- Order total

### Profile Management

Customers can update their profile information:

| Field | Description |
|-------|-------------|
| **First name** | Customer's first name |
| **Last name** | Customer's last name |
| **Phone** | Contact phone number |
| **Subscribe to marketing emails** | Opt in or out of marketing communications |

The email address is fixed — it is the identity the customer signs in with.

### Address Book

Customers can manage multiple addresses from the **Addresses** card:

- Add addresses with **+ Add address**
- Edit existing addresses
- Delete addresses
- Tick **Set as default address** to make one the default

Each saved address serves as both a shipping and a billing address, and the default flag applies to both at once — there is no separate default shipping and default billing on the storefront.

> **Tip:** The first address added is automatically set as the default.

### FFL Dealer Selection

The **Preferred FFL Dealer** section is added to the account page automatically when customer accounts are enabled. Customers can:

- Search for FFL dealers by name (at least 3 characters) or by 5-digit ZIP code, with a search radius
- Set a preferred FFL location for future orders
- Remove their FFL preference

This saves customers time at checkout: when a cart has no dealer chosen yet, the customer's preferred FFL is pre-selected.

### Events and Subscriptions

If your store uses the Events or Reload (subscriptions) plugins, the account page also shows **My Registrations** and **My Subscriptions**, where customers manage the classes they signed up for and their recurring orders.

---

## Troubleshooting

### Customer Not Receiving Code

**Symptoms:** Customer doesn't receive the verification email

**Solutions:**
- Check the customer's spam/junk folder
- Verify the email address is correct
- Ensure your store's email configuration is working
- Check if the customer has exceeded the rate limit (5 codes per hour)

### Customer Can't Sign In

**Symptoms:** Verification code is rejected

**Solutions:**
- Ensure the code hasn't expired (10-minute window)
- Check that the customer hasn't exceeded 5 verification attempts
- Have the customer request a new code

### Account Link Not Showing

**Symptoms:** No sign-in link on the storefront

**Solutions:**
- Verify customer accounts are enabled in **Settings > General**
- Check that your theme supports customer account links

---

## Related Documentation

- [Managing Customers](/customers/customer-management) - Admin customer management
- [FFL Compliance](/ffl-compliance) - FFL dealer requirements
- [Orders](/orders) - Order management

Source: https://docs.firearmcart.com/customers/customer-accounts/index.mdx