Skip to content

Whisper Links

The Design Problem

In a centralized application, there is always a server that brokers and transfers information between two users.

In a peer-to-peer application, two devices are able to connect their computers and share content directly. However, stabilizing that initial connection can be challenging.

The Design Solution

One user creates a code that can be shared with the other easily using another communication channel. The code should be short and human-pronounceable, using a phonetically-distinct wordlist.

Consider using a URI protocol handler link (e.g., myapp://) so that when clicked on, your application will automatically open.


  • Magic Wormhole: “The notion of a “magic wormhole” comes from the image of two distant wizards speaking the same enchanted phrase at the same time, and causing a mystical connection to pop into existence between them. The wizards then throw books into the wormhole and they fall out the other side. Transferring files securely should be that easy.” - Read more about Magic Wormhole’s whisper links
  • Jitsi: “Then there’s the matter of choosing the name. If you start a meeting with the name “Test”, “Yoga” or “FamilyMeeting” for example, chances of having some random uninvited people joining are very, very high. How does one pick a good room name then? Our random meeting name generator is a great start. It offers names that are easy to remember and read out loud on a phone call, and come from a set of over a trillion possible combinations. Picking out one of the auto-generated names is therefore quite safe.” Read more about Jitsi’s whisper links
  • Cabal

Why Choose Whisper Links?

When you want to establish a connection between two users for common use cases where there is a human-mediated communication channel (such as text, chat, or phone call) already in progress.

If using a wordlist, localize it. In other words, use a wordlist language that is the same as the user’s chosen language.

Allow users to create their own whisper links.

Consider only allowing a certain number of failed attempts to protect against spammers and brute-force attacks. See password-authenticated key agreement for more implementation details.

This could be used in conjunction with QR code verification if two users are able to share an image or are in the same physical location.

Use longer lengths for higher security use cases and shorter lengths for links intended to be publicly accessible. The longer the code, the less likely it is that an attacker could randomly guess the whisper link and connect to an unauthorized computer. However, longer links may be more difficult to copy and remember.

When users are able to choose their own whisper links, it’s possible they will choose names that are easy to guess. Consider implementing a “bad meeting name detector” which tells users when their link could be hijacked by an suspicious third-party attacker.

The Take-Away

Whisper Links make it easy to share information quickly between two trusted users.

References & Where to Learn More

What Three Words maps every 3x3m location on earth to three words! This is how powerful three words alone can be.