Skip to content

Per-Wallet Preferences

Override global notification settings for specific wallets.

When to Use Per-Wallet Preferences

Use custom preferences when a wallet has different needs:

Wallet Type Custom Settings
Cold Storage All notifications, all channels, no threshold
Daily Spending Larger transactions only, reduce noise
Business Wallet Webhook for accounting, email for team
Test Wallet Minimal or no notifications

Accessing Per-Wallet Preferences

  1. Go to Wallets → [Wallet Name]
  2. Click the Notifications tab
  3. Toggle Use custom preferences

Configuration

Enabling Custom Preferences

  1. Toggle Use custom preferences on
  2. All global settings are copied as starting point
  3. Modify settings as needed
  4. Save

Disabling Custom Preferences

  1. Toggle Use custom preferences off
  2. Wallet reverts to global preferences
  3. Custom settings are preserved (can re-enable later)

Example Configurations

Cold Storage Wallet

Maximum alerting for high-value holdings:

custom_preferences: true

transaction.deposit:
  enabled: true
  channels: [email, nostr, webhook]
  threshold: 0
  confirmations: [0, 1, 3, 6]

transaction.withdrawal:
  enabled: true
  channels: [email, nostr, webhook]
  threshold: 0
  confirmations: [0, 1, 3, 6]

theft_shield.*:
  enabled: true
  channels: [email, nostr, webhook]

# Every event, every channel, full confirmation tracking

Daily Spending Wallet

Reduce noise for frequent transactions:

custom_preferences: true

transaction.deposit:
  enabled: true
  channels: [email]
  threshold: 0.01 BTC  # Only larger deposits
  confirmations: [3]    # Only when confirmed

transaction.withdrawal:
  enabled: false  # You initiated it, no need to notify

theft_shield.*:
  enabled: true
  channels: [email, nostr]

# Quieter, only significant events

Business Wallet

Integration-focused:

custom_preferences: true

transaction.deposit:
  enabled: true
  channels: [webhook]  # For accounting system
  threshold: 0
  confirmations: [0, 6]

transaction.withdrawal:
  enabled: true
  channels: [email, webhook]
  threshold: 0
  confirmations: [0, 6]

# Webhook for automation, email for team awareness

Test Wallet

Minimal notifications:

custom_preferences: true

transaction.deposit:
  enabled: false

transaction.withdrawal:
  enabled: false

theft_shield.*:
  enabled: true
  channels: [email]

# Only Theft Shield testing alerts

Priority Rules

When custom preferences are enabled:

  1. Custom settings take priority over global
  2. Unset custom settings fall back to global
  3. Channel availability - only channels you've configured are usable

Bulk Operations

Copy Settings Between Wallets

  1. Configure one wallet
  2. Go to Wallets
  3. Select multiple wallets
  4. Click Apply Preferences From...
  5. Select source wallet

Reset to Global

  1. Go to wallet notifications
  2. Click Reset to Global
  3. Confirm
  4. Custom preferences cleared

Viewing Effective Preferences

To see what preferences are actually applied:

  1. Go to wallet notifications
  2. View Effective Preferences section
  3. Shows merged result of global + custom
Effective Preferences for "My Cold Storage":

transaction.deposit:
  enabled: true (custom)
  channels: [email, nostr, webhook] (custom)
  threshold: 0 (custom)

transaction.withdrawal:
  enabled: true (global)
  channels: [email, nostr] (global)
  threshold: 0.001 BTC (global)

Back to: Notification Preferences →