# Test mode

By default, your Userfront account is in test mode.

Test mode allows you to experiment and develop locally without affecting your live data.

To enable live mode:

  1. Your page must use https://
  2. Activate your account, and add your domain as a live domain.

# Why is my form in test mode?

If your page is not secured with https, or if the domain you are using is not on your list of live domains, your forms will be in test mode.

Example test domains include:

  • http:// example.com
  • localhost:3000

To work with live data, follow the steps to activate live mode.

Reason Explanation
Test mode: http Your page is served over http, which is insecure. This is OK for local development but not for production.
Test mode: domain The domain or subdomain has not been added to your account's live domains. Add the domain to activate live mode.

# Working in test mode

Your account is first created with 4 test users, each with an initial password set to testmodepassword.

You can log in with these users to test your application or you can sign up new users. Your initial users behave the same as any other user who signs up.

When in test mode, Userfront does not send welcome or confirmation emails.

Anywhere an email would have been sent to a user, that information is displayed directly in the browser instead.

Your initial test users:

Username Email Password
admin admin@example.com testmodepassword
member member@example.com testmodepassword
viewer viewer@example.com testmodepassword
unconfirmed unconfirmed@example.com testmodepassword

Example: you could use admin for the username and testmodepassword for the password, and your login form will log you in as the Admin User above.

# Allowed test mode passwords

Several basic passwords are allowed in test mode to make testing easier.

These passwords will not work in live mode.

Reserved passwords that will work in test mode

# Activate live mode

To activate live mode, click the link that says Activate your account in your Userfront dashboard.

Add your domain to the "Live domains" section.

Once you have done this, any Toolkit forms or requests from this domain will be in live mode.

Live domain Pages that will be in live mode
example.com example.com and all subdomains
sub.example.com sub.example.com, another.sub.example.com (but not example.com)

Domains are matched at the top level, unless a subdomain is specified.

# Mimick live mode for API requests

To make live mode API requests without the browser (e.g. using Postman), include your live domain as the origin of the request.

  headers: {
    origin: "https://example.com"
Last Updated: 12/26/2021, 9:34:33 PM