Auto Updates
Your contacts always have your latest information.
How It Works
When you update your contact card, everyone who has your card automatically sees the change. No need to send them the new info — it just appears.
┌─────┐ ┌───────┐ ┌───────────┐ ┌───────────┐
│ You │ │ Relay │ │ Contact 1 │ │ Contact 2 │
└──┬──┘ └───┬───┘ └─────┬─────┘ └─────┬─────┘
│ │ │ │
├───┐ │ │ │
│ │ Change phone number │ │ │
◀───┘ │ │ │
│ │ │ │
│ Send encrypted update │ │ │
│──────────────────────────▶ │ │
│ │ │ │
│ ├───┐ │ │
│ │ │ Store for offline contacts │
│ ◀───┘ │ │
│ │ │ │
│ │ Deliver when online │ │
│ │────────────────────────▶ │
│ │ │ │
│ │ ├───┐ │
│ │ │ │ Decrypt, update your card
│ │ ◀───┘ │
│ │ │ │
│ │ │ ┌─────────┐
│ │ │ │ Offline │
│ │ │ └─────────┘
│ │ │ │
│ │ Come online │
│ ◀────────────────────────────────────────│
│ │ │ │
│ │ Deliver pending update │
│ │────────────────────────────────────────▶
│ │ │ │
│ │ │ ├───┐
│ │ │ │ │ Decrypt, update your card
│ │ │ ◀───┘
│ │ │ │
│ │ ┌──────────────────────────┐
│ │ │ Both see your new number │
│ │ └──────────────────────────┘
│ │ │ │
┌──┴──┐ ┌───┴───┐ ┌─────┴─────┐ ┌─────┴─────┐
│ You │ │ Relay │ │ Contact 1 │ │ Contact 2 │
└─────┘ └───────┘ └───────────┘ └───────────┘
What Updates
When you change your contact card:
| Action | What Happens |
|---|---|
| Add a field | Visible contacts get notified |
| Edit a field | Contacts see the new value |
| Remove a field | Contacts see it disappear |
| Change visibility | Appears/disappears per contact |
Update Timing
When Online
- Updates deliver within seconds
- Contacts see changes when they open the app
- Real-time sync when both are active
When Offline
- Updates queue on the relay server
- Delivered when the contact comes online
- Messages kept for up to 120 days
Manual Refresh
Contacts can always:
- Pull to refresh their contact list
- Go to Settings > Sync Now
Privacy of Updates
Updates are end-to-end encrypted:
- The relay server cannot read update content
- Each contact receives updates encrypted with their unique key
- Different contacts may see different fields (per visibility settings)
What the Relay Sees
| Sees | Doesn't See |
|---|---|
| Encrypted blob | Field names |
| Recipient ID | Field values |
| Timestamp | Who you are |
| Message size (padded) | What changed |
Visibility and Updates
Updates respect your visibility settings:
- If you hide a field from someone, they don't receive updates for it
- If you show a field to someone, they start receiving updates
- Changes are per-contact, not global
Example
You change your phone number:
| Contact | Visibility | What They See |
|---|---|---|
| Family | Phone visible | New number |
| Work | Phone hidden | Nothing |
| Friend | Phone visible | New number |
Forward Secrecy
Each update uses a unique encryption key:
- Keys are derived via Double Ratchet
- Even if one key is compromised, other updates stay secure
- Past messages can't be decrypted with current keys
Troubleshooting
Contact Doesn't See My Update
- Check visibility — Is the field visible to them?
- Check your connection — Are you online?
- Wait a moment — Updates may take a few seconds
- Ask them to refresh — Pull to refresh or manual sync
Updates Seem Slow
- Check both connections — You and the contact need internet
- Check relay status — Rare server issues may delay delivery
- Try manual sync — Settings > Sync Now
Update Stuck
If an update seems stuck:
- Close and reopen the app
- Check internet connectivity
- Try editing and saving the field again
Related
- Privacy Controls — Control who sees what
- Multi-Device Sync — Updates across your devices
- Encryption — How updates are protected