Two choices decide who can approve for your Guardian Team, the group of devices that together approve each proposal: how the shares are spread across the devices, and the threshold. This page explains both, with examples, so you can pick them before you form your Guardian Team.
How devices hold shares
The Guardian Team’s key is split into shares. Each device holds one or more of them. When members approve a proposal, their shares count toward the threshold.
The wizards offer three modes. The creation wizard and the invite and roll-forward wizards name them differently.
| Mode | When you form a team | When you invite or roll forward | Review shows |
|---|---|---|---|
| Every device holds one share | One per device | Simple | Simple (1 vote each) |
| Each device holds a number of shares you set | Multiple per device | Weighted | Weighted |
| You name the shares and place them | Custom | Bespoke | Bespoke (named shares) |
One per device
Each device holds one share, so every member has the same weight. The threshold then counts devices. This is the right choice for most teams.
Multiple per device
You enter a Shares number for each device. A device with more shares weighs more toward the threshold. Use it when some members should count for more than others.
Custom
You type Share Names for each device, separated by commas, for example alice, bob, charlie. The same name can sit on more than one device. The usual case is a backup: a second device with the mobile app that holds a copy of your share.
A share name counts once, however many devices hold it. Two devices with the share alice approve as one share, not two.
How the threshold works
The threshold is the number of shares that must approve before a proposal passes. A proposal passes when the shares of the approving devices reach the threshold.
What the field counts
On One per device, the field reads Devices required to approve an action, because each device holds one share. On the other tabs, it reads Shares required to approve an action. The field shows the total next to it, and the threshold cannot exceed that total.
Defaults and safeguards
- On One per device, with two devices or more, the threshold starts at 2.
- On One per device, Use a majority sets the threshold to a majority of the devices for you.
- A threshold of 1 shows A single device can act on its own. You must check Yes, allow any single device to approve on its own. to continue.
- When one device holds enough shares to reach the threshold alone, the wizard shows At least one device holds enough shares to approve actions on its own.
Changing it later
The threshold is set when the team forms. An invitation or a revocation never changes it. Only a Roll Forward sets a new threshold. See Revoke a membership.
Examples
Two of three
Three devices, One per device, threshold 2. Any two members approve. One device can be lost or away without blocking the team.
Four of five
Five devices, One per device, threshold 4. The team needs strong agreement, and still tolerates one missing member.
A member with a veto
Three devices on Multiple per device: the CEO holds 3 shares, the CFO and the CTO hold 1 share each. The total is 5, and the threshold is 4.
- The CEO alone has 3 shares: not enough.
- The CFO and the CTO together have 2 shares: not enough.
- The CEO and either of the others reach 4: the proposal passes.
Nothing passes without the CEO, and the CEO cannot act alone.
A backup device
Three members on Custom, with the share names alice, bob and charlie, threshold 2. A fourth device in a safe holds a copy of alice. If Alice’s device is lost, the backup device stands in for the alice share. The backup device and Alice’s device together still count as one share.
Common pitfalls
| Pitfall | Effect | How to avoid it |
|---|---|---|
| Threshold equal to the total | A lost device blocks every proposal, unless another device holds a copy of its share | Leave at least one device of margin |
| Threshold of 1 | Any single device approves everything | Use it only for a team of one device, and confirm it deliberately |
| One device too heavy | That device can approve alone | Watch for the warning on Approvals and spread the shares |
| Expecting a copy to count twice | A share name on two devices counts once, so the team needs more devices than you expect | Count distinct share names when you pick the threshold |
| Planning on a later change | Only Roll Forward changes the threshold, and every member re-enrolls | Choose the threshold with the team’s future size in mind |