Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.praxis-ai.com/llms.txt

Use this file to discover all available pages before exploring further.

Every Digital Twin in Pria sits behind an enrollment policy that decides who can sign up, how they get in, and whether they stay locked to that single instance. This page covers the available joining modes, the Admin-approval gate, guest access, and the self-service signup flow.

​
Joining policy modes

The primary control is the Allow Joining mode on the Digital Twin. It has three values, each tuned for a different kind of audience.

Disabled

No self-service joining at all. Users only get in if an Admin explicitly adds them. Use this for private, invite-only Digital Twins.

Account-Only

Anyone whose email matches the Account’s authorized domains can join. Ideal for a school, company, or organization with a known email domain.

Public

Anyone with the public link can join. Use this for community Digital Twins, public-facing assistants, and open courses.
Pick the mode in Admin → Configuration under Joining.
Account-Only matches the new user’s email domain against the list configured on the parent Account. If the Account has no domain list, “Account-Only” effectively behaves like Disabled — only Admin-added users get in.

​
Admin-only joining toggle

Independent of the joining mode above, you can flip on Joining Admin Only to require Admin approval on every signup — even on a Public link.
1

User clicks Join

The candidate completes the standard signup form. Their record is created with status pending.
2

Admin gets an email

The instance contact email receives a “Membership Request” notice with a one-click approval link.
3

Admin approves

The user’s status flips to active. They receive a “Joining Approved” email with a link to start using the Digital Twin.
Combine Allow Joining: Public with Joining Admin Only: ON to publish a join URL anywhere (newsletter, website, syllabus) while keeping a human in the loop before anyone gets in.

​
Guest mode

For public-facing demos and marketing pages, you can enable Guest UI so visitors can interact with the Digital Twin without signing up at all.

No account required

Visitors land on a simplified UI and can converse immediately. Their session is not tied to a persistent user record.

Capped session

Guest sessions are intentionally limited so that anonymous traffic cannot drain the instance’s credit pool. Encourage visitors to sign up for a full experience.
Guest mode is enabled in Admin → Configuration under Guest UI. Leave it off unless your Digital Twin is intended for unauthenticated visitors.

​
Preventing instance switching

By default, a user who belongs to multiple Digital Twins can switch between them from a menu in the UI. For some deployments — branded apps, focused classroom experiences, embedded assistants — you want the user pinned to a single Digital Twin.

Lock users to one instance

Enable Prevent Switching Instance in Admin → Configuration. The instance switcher disappears from the UI for users of this Digital Twin. They will only see this one Digital Twin no matter how many memberships they have.
This is a per-instance setting. If a user belongs to two Digital Twins and only one has the lock enabled, the lock applies only when they are inside that Digital Twin.

​
Self-service signup flow

When a user joins via a public or account-domain link, Pria runs them through a short flow before dropping them into the Digital Twin.
1

Email verification

A one-time activation link is emailed. The user must click it to confirm the address. The account is not active until they do.
2

Onboarding Questions

If the Digital Twin has Onboarding Questions configured, the user answers them here. Their responses are stored and available to assistants for personalization.
3

Personalization gate

The first time a user enters the Digital Twin, they are asked the Personalization prompts that build their initial user profile.
4

In the Digital Twin

The user lands in the main UI with their profile, preferences, and any awarded credits already in place.

​
Email verification and activation

All self-service signups require a verified email. The activation email is sent immediately on signup and contains a single-use link.
If the activation email is missing, check the user’s spam folder, then verify in Admin → Users that the email address on file is correct. Admins can re-send the activation link from the user’s record.
A user whose email is never activated remains in the pending state. They cannot sign in until the link is clicked or until an Admin manually activates them.

​
Contact email auto-promotes to Admin

The Digital Twin record carries a Contact Email. When the user whose email matches that contact email signs in for the first time, Pria automatically promotes them to the Admin role on the Digital Twin.

Why this exists

It lets the platform bootstrap a brand-new Digital Twin: set the contact email to whoever should own it, hand them the link, and the first time they sign in they get the Admin permissions they need.

What it means in practice

Treat the Contact Email as the keys to the Digital Twin. Anyone who can sign in with that address becomes an Admin on first sign-in.
Update the Contact Email carefully. Setting it to an unverified or shared address effectively grants Admin to whoever controls that mailbox.

​
LMS launches bypass joining policy

Users who arrive via an LMS launch — Canvas, D2L Brightspace, or any other LMS-supported tool — bypass the joining policy entirely.

Why

The LMS has already authenticated the user and asserted their identity. Re-asking them to sign up would break the launch flow and confuse students.

Implication

Even with Allow Joining: Disabled, an LMS launch from a configured course will still create a membership and grant access. Restrict the LMS configuration if you need to limit which courses can launch.
LMS-launched users land directly in the Digital Twin with the role configured on the LMS integration. They can still go through Onboarding Questions and the Personalization gate, but they skip the email-verification step.