Stacker

Search Documentation

Search for pages and topics in the documentation

4 min read

User login flow

These options apply to portal users— people who sign in to your published customer portal, not to the internal builder or admin app. Control how they authenticate: passwordless login via magic links or one-time passcodes, optional self-service registration, and enterprise single sign-on.

Where to find the login link

The customer portal address appears in two places: on the Users tab (at the top as Login URL with copy), and in Publish Share Your App as External Portal — next to the team Admin Login link, custom domain, and Live/Test status.

Share Your App modal: Admin Login team URL, External Portal customer URL, custom domain, and publish status
PublishShare Your App — portal login (External Portal) and internal team URL (Admin Login) in one dialog.

Default portal domain: Customer portals are moving to stacker.ai as the default host. Until that cutover is complete, published portals still use an outportal.ai subdomain. This page and the product will reflect the switch when it happens.

On Stacker's default hosting, the portal URL looks like a subdomain of that domain, for example:

https://your-portal-name.outportal.ai

Replace your-portal-name with your portal's public slug. The exact value matches Login URL on the Users tab and External Portal in Share Your App.

If you connect a verified custom domain, the Login URL shows that domain instead. Custom domains, logos, colors, and related setup are covered in Branding & Themes.

Before you begin

Magic Links, OTP, and Open Sign Up all require a users table to be configured. This is the table in your app that contains your portal users — for example, a "Customers" or "Clients" table. Set this up in Portal Settings > Permissions > Users Table.

Login Methods

Magic Links

Default

Users enter their email address and receive a secure login link — no password needed. One click and they're in.

How it works

User enters their email on the login page
Stacker sends an email with a unique login link
User clicks the link and is logged in automatically
Links expire after 15 minutes and can only be used once

One-Time Passcode (OTP)

Users receive a 4-digit code by email instead of a clickable link. Useful when users open their email on a different device from where they're logging in.

How it works

User enters their email on the login page
Stacker sends a 4-digit code to their email
User enters the code on the login page to sign in
Codes expire after 10 minutes. Max 5 requests per email per 15 minutes.

How to enable: Ask the AI agent to switch to OTP login—for example, "change login to use a code" or "switch to OTP login". The agent will update your portal's login page automatically.

Email templates

Change the emails users receive—including OTP and magic link messages—in Setup → Email Templates. A separate agent there can help you refine the copy, or you can edit the templates manually.

Open Sign Up

Troubleshooting

If someone can't register, check that they're using Create an account from the portal login screen (under the email sign-in)—not entering their email to sign in—they'll do that the next time they access the app.

Portal login screen: Welcome back with email field and Create an account link at the bottom
Create an account on the sign-in page when visitors land on the main portal URL first.

Self-Service Registration

By default, only users who already have a record in your users table can sign in. Enabling open sign up lets new visitors register themselves.

Registration uses the same host as your live portal, with /register on the path. On Stacker's default hosting that looks like this — replace your-portal-name with your portal subdomain from Login URL (Users tab) or External Portal (Share Your App):

https://your-portal-name.outportal.ai/register

Portal domain: Customer portals are moving to stacker.ai as the default host. Until that change is live for everyone, default hosting still uses outportal.ai — for open sign-up, use the same host as your published portal, for example https://your-portal-name.outportal.ai/register. The subdomain matches Login URL and External Portal in the product.

With a custom domain, use your domain the same way—for example https://portal.yourcompany.com/register.

How it works

A visitor opens /register on your portal URL and fills out the form
They enter their email and any required fields (e.g. name)
A new record is created in your users table
A magic link or OTP is sent so they can complete their first login

How to enable

  • Portal Settings: Open Permissions and toggle Open registration on.
  • AI agent: Ask "enable sign up" or "allow registration".

Custom registration pages

Shape the /register experience with the AI agent

Describe what you want—layout, steps, and which fields to collect—and the agent can build it for you. Everything maps to your users table, so new sign-ups land in the right place.

  • Simple: email + name (or minimal fields)
  • Rich intake: company, phone, address, or other onboarding fields
  • Guided: multi-step flow with progress if you need more structure
Example open registration page: Client Intake Portal with name, email, phone, company, and address fields
Example open sign-up flow—a client intake-style form; change fields and layout anytime with the AI agent.

Single Sign-On (SSO)

Enterprise SSO

Business Plan

Let portal users authenticate through their organization's identity provider — such as Microsoft Entra ID, Google Workspace, or Okta — instead of entering an email and receiving a code or link.

Supports major identity providers: Microsoft Entra ID, Google Workspace, Okta, and other SAML/OIDC-compatible providers
Users sign in with their existing corporate credentials
Contact support to configure SSO for your portal
SSO is not self-serve — setup is handled by the Stacker team

Preview the login screen

In portal preview, open the Preview as menu and choose No logged in user. That shows exactly what people see before they sign in. You can ask the AI agent to adjust copy, layout, branding, or other details on that screen.

Portal builder preview toolbar with Preview as set to No logged in user, showing the portal login page below
Use Preview as → No logged in user to review your login experience.