Inviting Members¶
This guide covers how to invite team members to your courier organization, assign them a role, and manage pending invitations. Only organization owners can send invitations.
Prerequisites¶
- You are logged in as the organization owner
- You have navigated to Config Hub > Organization > Team
Steps¶
Step 1: Open the Team screen¶
From the Config Hub, select the Organization tab and tap Team. The Team screen displays two sections:
- Members — all current team members with their name, email, role badge, and permission summary
- Invitations — pending invitations showing the invited email, assigned role, and a revoke action
Info
The Invitations section is only visible to owners. Managers and viewers see the Members list but cannot invite, remove, or edit permissions.
Step 2: Tap the Invite button¶
Tap the Invite floating action button (FAB) in the bottom-right corner. This navigates to the invitation form at Config Hub > Team > Invite.
Step 3: Enter the invitee's email¶
Type the email address of the person you want to invite. This must be an email associated with an existing Shiphustle account or one the invitee will register with.
Step 4: Select a role¶
Choose one of the three available roles:
| Role | Access Level |
|---|---|
| Owner | Full access to all sections — can invite, remove, and edit permissions for other members |
| Manager | Configurable read/write permissions per section — access is controlled by the owner |
| Viewer | Read-only access to permitted sections only |
Tip
For a detailed breakdown of what each role can access, see Roles & Permissions.
Step 5: Submit the invitation¶
Tap Submit to send the invitation. The invitee receives a notification and the invitation appears in your Invitations list as Pending.
Invitation Lifecycle¶
Once sent, an invitation follows one of these paths:
Pending → Accepted (invitee joins the team)
Pending → Declined (invitee rejects the invitation)
Pending → Revoked (owner cancels the invitation)
- Accepted — The invitee taps Accept on the invitation screen. They become a full team member with the assigned role and permissions. The invitation is removed from the pending list.
- Declined — The invitee taps Decline. The invitation is removed and no team membership is created.
- Revoked — The owner taps Revoke on a pending invitation from the Team screen. The invitation is cancelled before the invitee acts on it.
Owner-Only Actions¶
The following actions are restricted to organization owners:
| Action | Description |
|---|---|
| Invite member | Send a new invitation via the Invite FAB |
| Revoke invitation | Cancel a pending invitation before it is accepted |
| Remove member | Remove an existing team member, revoking all their access |
| Edit permissions | Change a member's read/write access per section |
Warning
Removing a member is immediate and cannot be undone. The member loses all access to the courier organization and must be re-invited to regain it.
Pending Invitations List¶
The Invitations section on the Team screen shows all pending invitations with:
- Email — The invited person's email address
- Role — The role assigned to the invitation (displayed as a badge)
- Revoke — A button to cancel the invitation
Invitations that have been accepted, declined, or revoked are automatically removed from this list.
Result¶
After inviting a member:
- A pending invitation appears in your Invitations list
- The invitee receives a notification with the invitation details (organization name, assigned role, and permissions summary)
- When accepted, the new member appears in the Members list with their role badge
- The member can immediately access features based on their role and configured permissions
Troubleshooting¶
| Issue | Cause | Solution |
|---|---|---|
| Invite FAB is not visible | You are not the organization owner | Only owners can invite members. Ask the owner to send the invitation. |
| Invitee says they didn't receive the invitation | They may not have checked notifications, or the email doesn't match their account | Confirm the email matches their registered Shiphustle account. Ask them to check their in-app notifications. |
| Invitation stuck as Pending | The invitee has not yet accepted or declined | Contact the invitee directly. You can revoke and re-send if needed. |
| Cannot revoke an invitation | The invitation was already accepted or declined | Once processed, invitations cannot be revoked. To remove an accepted member, use the Remove action from the Members list. |
| Removed member still sees content | Cached session data | The member should log out and log back in. Access is revoked server-side immediately. |