Skip to content

Customer passkeys

How your customers add a passkey to their account at your store, name and remove it, sign in with it, and what happens when your store's address changes.

Updated

Your customers can sign in to your store with a passkey instead of a code by email: their fingerprint, face or screen lock on a phone or computer, or a password manager that keeps passkeys. It works on every store, on its Sherpo address or on your own domain, and on every plan. Signing in with an email code or with Google stays as it is.

Everything happens on your store’s own pages: the passkey is made for your store’s address and never leaves it.

Adding a passkey

  1. The customer opens their account. Signed in at your store, they open Profile (/account/profile), where Passkeys lists the ones they hold, and press Add a passkey.
  2. They confirm on their device. Their browser or password manager makes the passkey for the address they’re on, and keeps it.
  3. The profile lists it, named Passkey and saying it was added. Rename gives it a name they’ll recognize, such as “Work laptop”.

If adding one fails (the device already holds a passkey for their account at your store, the customer already has as many as an account holds, or the device refused it), the profile says why. An account holds up to 20 passkeys.

Offered after signing in

When a customer signs in with an email code or with Google, holds no passkey for the address they’re on and their browser can make one, a small dialog asks Sign in faster next time. Add a passkey makes one right there, the same as on the profile. After Not now, or closing their device’s prompt, the store doesn’t ask again on that browser for 30 days. If the device couldn’t show its prompt, the dialog says the passkey wasn’t added and stays open to try again. Once they add one from it, it doesn’t ask again on that browser. It asks at most once per sign-in, never over the checkout, and never after signing in with a passkey.

Naming and removing one

Under Passkeys, each passkey shows its name, whether it’s synced across the customer’s devices, when it was added and when it was last used. One made on another of your store’s addresses also names the address it’s for.

  • Rename gives it a new name, up to 64 characters.
  • Remove deletes it once confirmed. The passkey no longer signs in at your store, and every device it signed in is signed out, except the one removing it. The customer should delete it from their password manager too, since the store can’t reach their device.

Signing in with a passkey

The sign-in dialog offers a passkey two ways:

  • From the email field. As the dialog opens, the customer’s browser offers their passkeys for your store in the email field’s suggestions. Picking one and confirming on their device signs them in.
  • With the button. Sign in with a passkey asks the browser at once.

Either way they stay on the page they were on, now signed in. If the device offers a passkey your store doesn’t know (one they removed, say), the dialog says so and lets them try another way.

When your store’s address changes

A passkey works on the store address it was made on. When your store moves to another address, such as from its Sherpo address to your own domain:

  • In browsers that support related origins (Chrome, Edge and Safari), the sign-in dialog offers Use a passkey saved for the old address, and the customer’s passkeys keep working on the new one, as long as the old address still points to your store. Your Sherpo address always does, and so does your previous one after you change it. A Sherpo address from before that is held for your store for 90 days; after that another store can claim it, and once one does, passkeys saved for it stop working at yours.
  • In Firefox, and in any browser that can’t use them, when a passkey sign-in doesn’t go through, the dialog says that passkeys saved for the old address can’t be used there: the customer signs in by email once and adds a passkey again on their profile.
  • Removing a custom domain ends its passkeys. Once the domain no longer points to your store, passkeys made on it stop working in every browser: when a passkey sign-in doesn’t go through, the sign-in dialog says so, and its customers sign in by email and add a new one.

New passkeys are always made for the address the customer is on.

A passkey works only at its store

A passkey belongs to the customer’s account at the store where they added it. Each store has its own address, so a customer’s device only offers your store’s passkeys on your store; a customer of two of your stores adds a passkey at each.

Passkeys aren’t offered on a preview of your store, only on its own addresses.

Type to search…

↑↓ navigate↵ selectEsc close