· 11 min read

How do I assign permissions in Orgo?

Every permission in Orgo is a pair: a domain, meaning which area of the platform, and a scope, meaning whose data. HR_LOCAL is member management, limited to one chapter. FINANCIAL_TENANT is money, across the whole organisation. There are six domains and three scopes, so eighteen checkboxes in total.

The part that is worth reading before you grant anything is that a permission can reach a member from two independent directions, and one of them is invisible on the screen where you would look for it.

Member profile Permissions tab showing status, chapter, an Orgo administrator switch turned off, and an Organization heading with Admin, HR, HR Assistant, Financial, Communication Manager and Event Manager checkboxes, where HR and Communication Manager each carry a second locked checkbox already ticked with an orange Secretary tag beside it, and a Chapter heading below with Admin ticked and locked under a Chapter Leader tag

Look at the HR row in that screenshot. The plain checkbox is empty, and beside it a second, locked checkbox is ticked, carrying an orange tag reading Secretary. That is the permission arriving from a role. The same person holds chapter Admin the same way, from a Chapter Leader role. Nobody ticked either of those boxes on this profile, and unticking them here is not possible.

The two sources

WHERE A PERMISSION COMES FROMWHAT EVERY CHECK READSAttached to a roleTicked on the role, then the role assigned to them.Ends the moment the role ends.Ticked on the profileA checkbox on their Permissions tab. Survives a roleending, and survives a change of chapter.Extra chapter accessOne named chapter with its own level, from theRoles tab. Needs multi chapter access switched on.Their effective permissionsThe union of all three, recalculated whenever a roleor a checkbox changes.This is what every screen, list and action in Orgoactually reads.It is also why the roles list on its own never tellsyou who your administrators are, and why oneprofile’s checkboxes never tell you either.Put a permission on a role for an ongoing responsibility. Tick it directly only for the exception that matches no role.

Two consequences follow, and both come up constantly.

Only a role with no end date contributes. Ending a role removes the permissions it carried. Be aware that setting an end date takes effect straight away rather than on the date you typed, so a future end date is a way of ending a role now, not a way of scheduling it.

A directly ticked permission survives everything. It survives the role ending, and it survives the member moving to another chapter. That is the grant that quietly outlives the reason it was given, which is why the audit at the end of this guide matters.

The six domains and the three scopes

DomainShown asWhat it unlocks
ADMINAdminThe other five domains at the same scope, plus chapter settings, the waitlist, badges, roles, statuses, event types, invoices, API tokens and the email log
HRHRMember profiles and their Permissions and Roles tabs, adhesions, resignations, transfers, exports and bulk actions, merging duplicates, e-documents, the form builder
HR_ASSISTANTHR AssistantAwarding badges, logging badge hours, admin-only custom fields, reviewing identity documents
FINANCIALFinancialProducts and payments, subscribers, fee records and statistics, chapter fee and payment settings, your own Orgo billing page
EVENTEvent ManagerCreating events beyond the level set in your event settings, plus the organiser-only options on the event form
COMMUNICATIONCommunication ManagerEmail campaigns and templates, lists and segments, newsletter widgets, the discussion moderation queue

Each of those six can be granted at three scopes. Two of the three are chapter scopes, and they exist because multi-chapter management gives every branch a boundary of its own.

ORGANIZATIONPARENT CHAPTERCHAPTERAdminHRHR AssistantFinancialEvent ManagerCommunication ManagerADMIN_TENANTHR_TENANTHR_ASSISTANT_TENANTFINANCIAL_TENANTEVENT_TENANTCOMMUNICATION_TENANTADMIN_PARENT_LOCALHR_PARENT_LOCALHR_ASSISTANT_PARENT_LOCALFINANCIAL_PARENT_LOCALEVENT_PARENT_LOCALCOMMUNICATION_PARENT_LOCALADMIN_LOCALHR_LOCALHR_ASSISTANT_LOCALFINANCIAL_LOCALEVENT_LOCALCOMMUNICATION_LOCALAlways shownOnly with parent centers onOnly with local centers onAn organisation-scope permission satisfies any check for the same domain lower down. The reverse is never true.

Chapter and parent chapter scopes only exist when the Local Centers module is on, and the parent chapter column also needs parent centers enabled. Without them the only checkboxes drawn are the organisation ones. Financial needs the Fees module and Event Manager needs the Events module, so a missing checkbox is often a missing module rather than a permission problem.

What a parent chapter grant actually reaches is worked through in setting up chapters, and it is not what most people assume: the reach is anchored to the holder’s own chapter and you cannot point it elsewhere.

Holding one permission can imply another

Holding thisAlso grants
ADMIN_TENANTEvery permission check in the product
HR_TENANT or FINANCIAL_TENANTHR_ASSISTANT_TENANT
HR_PARENT_LOCALHR_LOCAL and HR_ASSISTANT_LOCAL
HR_LOCAL or FINANCIAL_LOCALHR_ASSISTANT_LOCAL
FINANCIAL_PARENT_LOCALFINANCIAL_LOCAL, HR_ASSISTANT_LOCAL, HR_ASSISTANT_PARENT_LOCAL
EVENT_PARENT_LOCALEVENT_LOCAL
COMMUNICATION_PARENT_LOCALCOMMUNICATION_LOCAL
ADMIN_LOCALEvery other domain within the same chapter

That is the complete list. Nothing else is implied, and in particular HR_TENANT is not a special case of ADMIN_TENANT.

Orgo administrator is not a permission

There is one account flag that sits outside the whole model, and it is the single most common support question in this area.

The Orgo administrator switch at the top of the Permissions tab is what every Settings screen checks. ADMIN_TENANT passes every permission check in the product and still leaves Settings shut. Granting one is not granting the other, and the switch is only drawn for somebody who already holds it, so appointing a new administrator always lands back with an existing one.

Member profile showing an Active status with Staff and Member tags, age, member since date, parent chapter and chapter, and a left-hand column whose first entry reads Permissions, HR, above the member's Orgo ID, tags and interests

What you are allowed to hand out

You see checkboxes at or below your own level, and only inside your own scope. Two separate rules are at work, and they are applied in that order.

Scope is checked first. A chapter-scoped person can grant nothing outside their own chapter, whatever their rank. A chapter president holding ADMIN_LOCAL can grant every chapter permission up to and including chapter Admin, and nothing at parent chapter or organisation scope at all.

Rank is then compared by permission family, not by reach. This is the counter-intuitive one.

FAMILY RANK, HIGHEST FIRSTWHAT THAT MEANS IN PRACTICE1 Admin2 HR3 Financial4 HR Assistant5 Events and CommunicationInside a family, organisation beats parentchapter beats chapter. Across families itdoes not: every Admin outranks every HR.The secretary general, holding HR across the organisationCannot tick chapter Admin on anyone. The box is not drawn for them.The treasurer, holding Financial across the organisationCannot tick chapter HR either. Financial sits below HR.The communications lead, organisation-wideRanks at the bottom. Can hand out Events and Communication only.The Orgo administrator flag skips the comparison entirelyWhich is why appointing chapter admins usually lands back with one.

Being organisation-wide does not put you above every chapter permission. That is the rule, not a fault, and the checkbox is simply not rendered rather than refused with a message. If someone needs to be able to appoint chapter administrators, either give them the Orgo administrator flag deliberately or make the appointment yourself.

Three more rules apply on top, and these are enforced when you save, not just hidden in the interface.

RuleWhat it means
Nobody edits their own permissionsYour own checkboxes are disabled on your own profile, and a save attempted another way is rejected outright with a message telling you another administrator has to do it
Organisation-scope changes need ADMIN_TENANTAdding or removing any organisation-scope permission is refused for anyone else
Chapter admins can be locked out entirelyTurning off Allow Local Admins to Modify User Permissions restricts permission changes, status changes and chapter role changes to organisation HR and admins. Chapter admins can still manage roles on the units below chapter level. It is on by default

Attaching permissions to a role instead

Roles carry permissions, and for an ongoing responsibility that is the better home for them: a handover becomes one role ended and another started, rather than two profiles edited and one forgotten.

Roles settings screen with Level and Permissions filters above a table of roles, each row showing the role name, its plural, a Level badge reading Organisation, Parent chapter or Chapter, and a Permissions column of tags, so President carries Admin, Secretary carries HR and Communication Manager, Regional Chair carries Admin at parent chapter level and Chapter Leader carries Admin at chapter level

There is a catch, and it is the most important sentence in this guide for anyone tightening up their security.

TICK IT ON ONE PROFILEPUT IT ON A ROLEReaches one personOnly somebody who outranks the permission cantick it, and the checkbox is not even drawn foranybody else.It also survives the reason it was given.Reaches everybody who ever holds the roleand everyone appointed laterAssigning a role is not rank-checked. Anyone withHR over that member’s chapter can hand out anyrole, including one carrying chapter Admin.The permission does end when the role ends.Review the Permissions column on your roles list and decide deliberately which permissions are allowed to travel by role.

Attaching a permission to a role and letting chapter secretaries hand that role out delegates it far more widely than ticking the same box ever would. That is a legitimate way to devolve appointments, but it should be a decision rather than a side effect.

Bars your organisation sets

Some behaviour is not a permission somebody holds but a minimum level your organisation sets, one per module, on the security and permissions settings screen. Most default to plain member.

Permissions setup settings screen with an Enforce MFA for administrators switch that prompts admins every 48 hours, and per-module minimum access level dropdowns including who can see user fee status, who can create public posts in the drive, who can create groups, who can see user type and who can see members in a local center

Who can browse the member directory, who can see another member’s fee status, who can start a discussion for the whole community, who can publish an event organisation-wide: all of these are bars rather than grants, and raising one of them is often the answer when a member sees something you would rather they did not. The same screen carries Enforce MFA for administrators, which asks anyone with organisation-level rights for an emailed code every 48 hours.

Which modules are on decides which permission checkboxes exist at all, and that is set separately.

Users and Profiles configuration settings with a User Types and Roles card carrying Enable User Types, Enable Roles and Enable Volunteer Roles switches alongside who can see and filter user types and the default user type after registration, above a Registration and Membership card of switches for the registration form, manual approval, welcome messages and account reactivation

Testing what somebody actually sees

Impersonation lets an administrator browse Orgo with a reduced permission set, which is the fastest way to answer “can the chapter treasurer see this”.

Permission Impersonation dialog warning that admin access will be temporarily restricted, listing Regular user as a single choice and then Admin with only Regional and Local options, and HR, HR Assistant, Financial, Events and Communication each offering Organization, Regional and Local, above an optional user type selector and a Start Impersonation button

Notice what the Admin row offers: Regional and Local only. Organisation-wide Admin cannot be impersonated, and your Orgo administrator status is switched off for the whole session. That is the point of the feature rather than a limitation of it, but it means you genuinely lose your own access while a session is running, so plan to exit before doing admin work.

A session lasts an hour, starting a new one ends the previous one, and every start and end is recorded with the simulated permissions, your real ones, your address and your browser.

One trap. Because starting a session reloads the page you are on, and every Settings screen needs the Orgo administrator flag you have just given up, starting impersonation from anywhere under Settings drops you straight onto the login page. You are not signed out. Navigate to an ordinary page such as the dashboard and the banner with its Exit button is there again.

Auditing who holds what

Open the member list and use the Permissions filter. It lists Orgo administrator first, then every permission grouped by scope, and ticking several shows everybody holding any of them.

Member directory of 348 members with a filter row offering location, county, state, name or keyword, industry, professional interests, status, fee status, user type and a More filters button, above rows showing each member's age, town, chapter and fee date

The filter reads effective permissions, so it catches the role-derived grants that no single profile screen shows you clearly. It requires organisation Admin rights, and anyone else asking is refused.

Run it whenever somebody leaves. Ending a role removes the permissions it carried, but a directly ticked checkbox survives both a role ending and a change of chapter, and that is the grant nobody remembers giving.

For the other direction, which roles carry which powers, the roles settings screen has a Permissions filter and a Permissions column showing each role’s grants as tags.

Troubleshooting

They have organisation Admin but Settings is missing

Settings screens check the Orgo administrator flag, which is the switch above the permission checkboxes and not a permission at all. Turn it on.

A checkbox is not in the list

Either the module it belongs to is off, or the scope is unavailable, or the permission is above your own level. Financial needs Fees, Event Manager needs Events, chapter permissions need Local Centers, and parent chapter permissions need parent centers on top of that.

WHAT A REFUSAL LOOKS LIKEThey open a link to adestination in Orgo.Orgo compares what thatdestination needs.Refused: they land on the login screen.No message. Session intact. Destination remembered.A few screens show a red message instead, such as opening a profile or a group you cannot reach. Most do not.Do not start with their session. Compare the permission the destination requires against what they actually hold,using the Permissions filter on the member list rather than the checkboxes on one profile.

When a destination refuses you, Orgo sends you to the login screen rather than showing an access denied message. The session is intact and the page is remembered, which is exactly what an expired session looks like too.

Orgo sign-in screen headed Sign in to your account with an email field, a note reading authentication by code verification with a link to use a password instead, a Continue button, and Continue with Google, Microsoft and Apple options over a branded background

The permission I granted has not taken effect

Changes apply on the member’s next page load. Ask them to reload. If it still has not, check whether the permission came from a role that has since been given an end date, because an end date takes effect immediately rather than on the date shown.

Frequently asked questions

Why can I not tick a permission I clearly outrank?

Rank is decided by permission family first, and only then by scope within that family, rather than by how far a permission reaches. Admin sits above HR, which sits above Financial, which sits above HR Assistant, with Events and Communication at the bottom. So an organisation-wide HR manager ranks below a chapter administrator and the Chapter Admin checkbox is never drawn for them. Scope is a separate gate applied before rank: a chapter-scoped person can grant nothing outside their own chapter whatever their rank.

Someone has ADMIN_TENANT but cannot open Settings. Why?

Settings screens check a separate account flag called Orgo administrator, not a permission. ADMIN_TENANT passes every permission check in the product and still leaves Settings closed. Turn on the Orgo administrator switch at the top of their Permissions tab, which only someone who already holds it can see.

A colleague says they get logged out at a particular link. Is their session broken?

Almost certainly not. When a destination refuses you, Orgo sends you to the login screen instead of showing a permission message, so a refusal and an expired session look identical. Compare the permission that destination needs against what they actually hold, using the Permissions filter on the member list to read their effective permissions rather than trusting one profile.

SHARE