Search the documentation
Search the documentation...
SplitSecure documentation

On this page

Concept · 4 min read

Choose shares and the threshold

How a Guardian Team splits its shares across devices, and how to pick a threshold that is safe and still reachable.

Updated

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 . 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 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