Team & roles
Distribu is multi-user out of the box. Anyone you add to your company can sign in and use the dashboard, with permissions determined by their role.
There are three staff roles: OWNER, ADMIN, and MEMBER.
This page is about your team — the people at your company. For customer contacts (multiple sub-users inside one customer account), see Multi-user customer accounts.
Role matrix
| Action | OWNER | ADMIN | MEMBER |
|---|---|---|---|
| Sign into the dashboard | ✓ | ✓ | ✓ |
| View inventory, customers, orders | ✓ | ✓ | ✓ |
| Create / edit products | ✓ | ✓ | ✓ |
| Place and manage orders | ✓ | ✓ | ✓ |
| Invite new members | ✓ | ✓ | — |
| Remove members | ✓ | ✓ (except other admins) | — |
| Change a member's role | ✓ | — | — |
| Create / revoke API keys | ✓ | ✓ | — |
| Configure webhooks | ✓ | ✓ | — |
| Manage billing & subscription | ✓ | — | — |
| Delete the company | ✓ | — | — |
A few rules enforced by the app:
- There's exactly one OWNER per company. You cannot promote anyone else to OWNER.
- Admins cannot remove other admins. Only the Owner can.
- You cannot remove yourself or the Owner.
- When you sign up, you become the Owner of the company you created.
Inviting a new member
Go to Team in the dashboard sidebar. If you're an OWNER or ADMIN, you'll see an invite form at the top.
- Enter the person's email address.
- Pick a role —
ADMINorMEMBER. - Click Send invite.
Distribu emails them a unique invitation link that expires in 7 days. If the email can't be delivered, the dashboard shows the invite URL directly so you can copy-paste it into Slack, SMS, or whatever works.
What happens when they accept
The invitee clicks the link (/invite/{token}) and hits one of three paths:
- New to Distribu. They see a signup form pre-filled with the invited email. After entering their name and password, they're added to your company with the role you chose.
- Already have an account with the same email. One-click Accept invitation button — they join your company immediately.
- Signed in as a different email. They see a "Wrong account" warning and must sign out first.
Once accepted, they show up in your Team list and can sign in normally.
Invite limits
Your plan caps the total number of team members. Pending invites count toward that limit — if you hit it, you'll need to either cancel an unused invite or upgrade your plan before inviting more.
Changing a role
Only the Owner can change a team member's role.
From the Team list, click the role dropdown next to a member and pick ADMIN or
MEMBER. The change takes effect immediately.
Things the Owner cannot do:
- Change their own role (the Owner role is permanent while you own the company)
- Promote anyone else to OWNER
If you need to transfer ownership to another person, contact support — it's a one-time operation we do manually to keep your account safe.
Removing a member
- Go to Team.
- Click Remove next to the member.
- Confirm.
They immediately lose access to the dashboard. Any API keys or webhooks they personally created remain active (they're tied to the company, not the user) — revoke them from Settings → API keys if needed.
Signing out
Every dashboard screen has a Sign out button in the top-right, under your avatar. It ends your session and returns you to the login page.
Audit trail
Every significant action — invites sent, members added, roles changed, members removed — is recorded in the audit log with the actor, timestamp, and IP address. Useful for compliance reviews and debugging "who changed that?".
That's everything for Getting Started. Next, explore the Core Concepts pages for a deeper look at how Distribu models your business, or jump to the REST API if you want to start integrating.
