Provision a new staff user account¶
As a Super User, I want to create a login for a new staff member with the right Security Role and Fund, so that they can access exactly the parts of PRIZM their job requires — no more, no less — from their first day.
Screen: Sidebar > MAINTENANCE > Administration > Users > Add User
Steps¶
- Open MAINTENANCE > Administration > Users. This grid lists every PRIZM login (74 in the UAT environment) with User Name, User Type, Email Address, Mobile Device #, Creation date, Last Login, and Locked status, plus per-row Reset Password/Retrieve Password actions.
-
Click Add User.

-
Fill in the form. It has no first/last name fields at all — just:
- Username
- Email Address
- Password / Password Confirmation
- Contractor (checkbox — leave unset unless this login represents a contractor)
- Locked Out User (checkbox — leave unchecked for a new account; this is the same checkbox you'll come back to uncheck if the account ever trips PRIZM's lockout policy)
- a "Choose a Member" link, if this login should be tied to an existing Member record
- Security Role (dropdown — what the person can do, see below)
- Fund (dropdown — what data the person can see, see below)
- Business Agent (leave unset unless this login specifically represents one)
- Pick Security Role from its exact dropdown values:
Accounting,BusinessAgent,Contract,ETFStaff,HWStaff,Management,MembershipStaff,SuperUser. This should match the job the person is actually doing — it's the role the signed Roles & Security Matrix grants Add/Update/View Only permissions to, module by module. - Pick Fund from its dropdown values:
All,ETF,H&W,Union. This is a separate axis from Security Role (BLR Common 1.16 "Fund Based Security") — it gates which fund's data (dependents, beneficiaries, Member+ values, notes, invoices/remittances) the account can see at all, before Security Role further limits what they can do with it. A role that genuinely spans every fund (Management, Accounting, Contract) getsAll; a fund-specific staff role (H&W Staff →H&W, ETF Staff →ETF) gets that one fund; most line-of-business roles (Business Agent, Membership Staff) getUnion. - Submit the form.
Things to watch out for¶
Password policy: 7–50 characters, one digit, one special character
PRIZM rejects an otherwise-strong password if it's all-alphanumeric — the form's own error message on a rejected submit is: "Password must be between 7 to 50 characters which contain at least one numeric digit and a special character e.g. @ or #." There's no other warning before you submit, so build this into the password you choose rather than discovering it on a failed Add User attempt.
Fund = All is an account-level value only
All only ever appears in the Add User form's Fund dropdown — the session header's own
"Fund:" selector (which an All-fund account uses to switch between Union/H&W/ETF while
logged in) never offers All as a choice itself. If you're trying to find an All option
somewhere inside a live session and can't, that's expected — it's a setup-time value, not a
session-time one.
A locked-out account needs this same screen to unlock, not a password reset alone
If a staff member's account trips PRIZM's own lockout policy (repeated failed logins), fix it here by unchecking Locked Out User and submitting — a password reset alone doesn't clear the lockout flag.
Leave optional fields unset for a narrowly-scoped account
Business Agent / Contractor / Member-link only need values if this specific login represents that thing. A general-purpose staff account doesn't need any of them filled in just to exercise its Security Role/Fund combination correctly.
See also Manage a member's security roles for the related but distinct Members > Roles tab (a member-held role, not a system login).