Quick Start Guide

Get authentication running on your website in under 5 minutes.

🚀 Quick Start Guide

Get authentication running on your website in under 5 minutes.

Start In Test Mode

Set your website to test mode and use your development domain (e.g., localhost, 192.168.1.1, or dev.example.com).

Set Website Domain Name

Set your website's domain for session cookies to work.

How to set your domain:

Go to Websites
Click your website name
Enter your domain in the Domain Name field
Click Save

Add Widget to Your Website

1. Add to your <head> section

<script async src="https://justsignin.com/api/v1/widget/[app_id].js"></script>
<link rel="stylesheet" href="https://justsignin.com/api/v1/widget/[app_id].css">
<script>
  // Create JustSignIn event callbacks
  signedOut = function() {
    alert('User signed out.');
  };
  signedIn = function() {
    alert(`User ${jsi.getSession().session.user.email} signed in.`);
  }
  signedUp = function() {
    alert(`User ${jsi.getSession().session.user.email} signed up.`);
  }

  // Initialize the JustSignIn widget
  window.onload = function() {
    jsi.init();
  };
</script>

2. Add where you want sign-in buttons

Quickest way to start! See Docs for custom UI options.

<div id="jsi_menu_slot"></div>

Finding your [app_id]:

Go to Websites
Click your website name
Copy the App ID at the top
Replace [app_id] above

Test Your Installation

🎉 You're done! Sign-in buttons should now appear on your page.

Test it by signing up, signing out, and signing in. Watch the alert popups trigger from the callback functions in step 1.

💡 Tip: Use the jsi.getSession() JavaScript call in the browser to get the signed in user's details.

⚠️ Important Security Note

Always verify sessions server-side. Browser data can be faked—validate with our API before trusting it.

See our Validate User Sessions guide for details. Thanks for using JustSignIn! 🚀