#Live and 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.
You can enable live mode by adding a live domain.
- Activate your account
- Add your domain as a live domain
- Your page must use
#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
To work with live data, follow the steps to activate live mode.
|Test mode: http||Your page is served over |
|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
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:
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|
#Working in live mode
Once you have added your live domain, all requests from your live domain will be in live mode.
Userfront uses the
origin header to determine live mode.
This header is automatically set by the browser with each request and cannot be overridden.
If the "Include subdomains" toggle is selected for a live domain, Userfront treats all subdomains as live mode too.
This table gives example scenarios for various subdomain settings.
|Live domain||Include subdomains||Live mode||Test mode|
#API requests in live mode
To make non-browser client-to-server API requests in live mode, include your live domain as the
origin of the request.
For server-to-server API requests made with an API key, you do not need to include the