CrystalCommerce Passport
Help and common questions
Passport is the sign-in for the CrystalCommerce admin, POS and storefronts. These are the questions we hear most, with what to do.
- I forgot my password
- It says my password was found in a data breach
- I can't sign in, even though my password is right
- My two-step code is rejected
- I lost my phone or authenticator app
- Recovery codes: where they are and why to keep them
- The old "forgot password" or "unlock account" link says unavailable
- I can sign in to the admin but not to core1
- How do I add or remove people at my store?
- It says an app needs two-step sign-in
- Which email do I use? I think I have two accounts
- Who do I contact?
I forgot my password
On the sign-in page choose Forgot password? and enter an email address of your Passport. If it has a Passport, we email a link to choose a new password. The link works once and lasts 30 minutes.
If you use two-step sign-in, you will also be asked for a code from your authenticator app, a recovery code or a passkey before you can choose the new password.
No email? Give it a minute, check your spam folder, and make sure you used an address that belongs to your Passport. You can ask again after a few minutes.
It says my password was found in a data breach
When you sign in with the right password, we check it against lists of passwords that have appeared in public data breaches. If yours is on one, we won't sign you in with it. We email a link to your main address so you can choose a new password.
This does not mean Passport was hacked. It means that password has been exposed somewhere, often on another website where it was reused, so anyone could try it here.
What to do: open the link in the email, choose a password you don't use anywhere else, and sign in. Setting a new password signs you out of your other devices and apps.
I can't sign in, even though my password is right
To protect your account, sign-in pauses for an hour after 5 wrong passwords, or 5 wrong two-step codes, within 15 minutes. While it is paused, nothing you type will work, including the right password. Wrong codes on a single sign-in attempt also end that attempt, so you have to start again from the sign-in page.
What to do: wait up to an hour, then sign in once, carefully. If you have two-step turned on, you can end the pause sooner by resetting your password and confirming with your two-step code or a recovery code (see I forgot my password). If the pause came from wrong codes, the reset may have to wait until the 15 minutes are up. A reset without a two-step check does not end the pause, so please don't keep resetting over and over.
A pause that staff put on an account (for example after a "this wasn't me" report) is different: only CrystalCommerce support can lift it. See Who do I contact?
My two-step code is rejected
- The code changes every 30 seconds. Wait for a fresh one and type it right away.
- Your phone's clock must be right, because the code depends on the time. Turn on automatic date and time in your phone's settings.
- Make sure you are reading the entry for this account. If your authenticator app has several CrystalCommerce entries, or you have more than one Passport, the codes will not match.
- Don't keep guessing: 5 wrong codes in 15 minutes pause sign-in for an hour (see the question above).
Still no luck? Use one of your recovery codes instead of the app code. See Recovery codes.
I lost my phone or authenticator app
Use a recovery code at the two-step step. Each recovery code works once.
If you don't have a recovery code either, there is no way to reset two-step yourself. Contact CrystalCommerce support: they can reset your two-step for you. The next time you sign in you will be asked to prove you can open your email, and then to set up two-step again.
Once you are back in: make new recovery codes and keep them somewhere safe, away from your phone.
Recovery codes: where they are and why to keep them
Recovery codes are ten one-time codes that let you in when your authenticator app isn't available. They are shown once, when you set up two-step, and we can't show them again.
- Sign in to Passport and open Sign-in and security in the menu.
- Under Two-step sign-in, choose Make new recovery codes. You may be asked to sign in again first.
- Save the new codes in a password manager or print them. The old ones stop working as soon as you make new ones.
The page shows how many codes you have left. Make a new set when it runs low.
The old "forgot password" or "unlock account" link says unavailable
Signing in to the CrystalCommerce admin, POS and storefronts now goes through Passport, so the old reset and unlock pages inside those apps no longer work.
What to do: go to the sign-in page and choose Forgot password?. See I forgot my password. If your sign-in is paused, see this question.
I can sign in to the admin but not to core1
Passport covers the newer CrystalCommerce apps: the admin, the POS and storefronts. Core1 is the older system and it is separate, with its own sign-in and its own list of staff. Being added as staff in the new admin does not add you to core1.
What to do: ask the account holder of your store to add you as staff in core1. If that doesn't help, contact CrystalCommerce support. Resetting your password in Passport usually isn't the fix for this.
How do I add or remove people at my store?
Only the store's account holder can do this, in Passport.
- Sign in to Passport and choose My collections in the menu.
- Open your store, or choose Staff and permissions on its row.
- To add someone, choose Invite staff, enter their email and what they may do, and send the invitation: the link we email works only for that address and expires in 7 days. To change what someone can do, select them in the list and save. To remove someone, select them, tick the confirmation and choose Remove from collection.
Each person can be an Account holder (every privilege), Staff (only the areas you tick) or Member (no privileges).
Don't see your store in the list, or no staff link? You are probably not the account holder. Ask them, or contact support.
It says an app needs two-step sign-in
Two-step sign-in is required for CrystalCommerce staff, for the account holder of a store, and for store staff who have at least one permission. They are asked to set it up when they sign in. Some apps, such as the store admin, also stop anyone who hasn't turned it on.
If you only just signed up, your account may have a personal collection and no store yet. In that case Passport has nothing to connect you to a store admin, so ask your store's account holder to invite you (see adding people).
To turn on two-step: sign in to Passport, open Sign-in and security, and under Two-step sign-in set up an authenticator app. Then sign in to the app again.
Which email do I use? I think I have two accounts
Use the email address your store invited or added you with. You can sign in with any address that belongs to your Passport, and you can add more under Emails in Passport. If a breach check makes you choose a new password, that link goes to your main address, and security notices go to all your verified addresses.
If the same address is on more than one Passport, sign-in can't tell which one you mean and will refuse it.
Think you have two? Contact support with both addresses and the stores you work at. Don't create another one.
Who do I contact?
Contact CrystalCommerce support the way you normally do for your store.
Tell them the email you sign in with, your store's name, when it happened and what you saw. Never send your password, a two-step code or a recovery code, and we will never ask for them.