Inviting team members and managing roles
If more than one person at your company will be using MarbleMap, each of them needs a separate account under the same
company. You manage this from the Settings › Team Management screen.
What you see on the Team Management screen
At the top you see your company's seat usage: {used} / {total} seats used. The seat count includes not only active
members but also invitations that have not been accepted yet.
Below that, the screen shows, in order:
- the list of team members (name, email and role),
- the Pending invitations card, if there are any,
- the Invite a member card.
Roles
There are three roles: Owner, Manager and Member.
The Invite a member card, the Change role selector next to each member and the Remove member button are visible only to
the person with the Owner role. Other members can see the team list and the roles, but cannot invite members, change
roles or remove members.
The Cancel invite button, on the other hand, is visible to everyone on the team. Only an Owner or a Manager can actually
cancel a pending invitation; a Member who tries will get an authorization error.
When inviting someone, the only roles you can choose are Manager and Member. The Owner role cannot be granted through an
invitation, and the existing Owner's role cannot be changed, nor can that person be removed from the team.
Inviting a new member
1. Open the Settings › Team Management screen.
2. In the Invite a member card, enter the email address of the person you want to invite.
3. Choose the role from the list next to it: Manager or Member.
4. Press the Invite button.
Once the invitation is created, an email containing the invitation link is sent to that person and the invitation
appears in the Pending invitations list.
If an invitation is already pending for the same email address, a second one cannot be sent. If you do not enter a valid
email address, you will see the warning "Enter a valid email address."
Managing pending invitations and members
The Pending invitations card lists each invitation's email address, role and Pending status. If you are an Owner or a
Manager, you can withdraw an invitation with the Cancel invite button next to it; the link of a cancelled invitation
stops working and the seat it was holding is freed up.
To change an existing member's role, simply pick the new role from the role list in that member's row; the change is
saved immediately. To remove a member from the company, use the Remove member button at the end of the row.
When all seats are taken
When the number of seats in use reaches the total number of seats, the Invite button becomes inactive and the warning
"All seats are taken." appears. To invite someone new, you first need to cancel a pending invitation or remove a member
from the team.
Accepting an invitation
An invitation is tied to the email address it was sent to. That is why the invited person must have a MarbleMap account
registered with the email address the invitation went to.
If they do not have an account, they first need to register with the same email address via Create account and verify
that address with the code sent to it. Only then can they accept the invitation.
The invitation link is used as follows:
1. First, sign in to MarbleMap via Sign in using the account the invitation was sent to.
2. Then click the invitation link in the email again.
This order matters: if you click the link while not signed in, you are redirected to the sign-in screen, but you are not
returned to the invitation page automatically after signing in. In that case you need to click the link in the email one
more time.
When the link is opened correctly, the Join Team screen accepts the invitation and shows the message "You joined the
team!" along with the role you have been given. The Go to Marketplace button takes you straight to the Marketplace
screen.
Invitation limits
- An invitation is valid for 7 days. For an expired invitation you will see the message "This invitation has expired.
Ask your team admin for a new one."; in that case the person with the Owner role needs to send a new invitation.
- Each invitation can be used only once. If a link that has already been accepted or cancelled is opened again, you
will see either "This invitation has already been accepted." or "This invitation was not found. It may have been
cancelled."
- An invitation cannot be opened with another account. If you sign in with an account belonging to a different email
address and open the link, you will get the warning "This invitation was sent to a different email address." You
need to sign in with the correct account and open the link again.