DocsCompatibilityImport/Export Options
Import/Export Options
Move data into or out of bervice safely. Imports re-encrypt locally before sync; exports can be encrypted archives (recommended) or plain formats for migration. Handle plaintext with extreme care.
Supported Imports
- Encrypted archive (
.bva) - CSV / JSON (UTF-8)
- Other managers: 1Password/Bitwarden/LastPass/CSV
Supported Exports
- Encrypted archive (
.bva) with password/key file - CSV / JSON (use briefly; then securely delete)
- Per-space or full vault selection
Security Defaults
- All imports are re-encrypted client-side
- Exports require local unlock
- No plaintext is sent via REST
Import Guide
Step-by-Step
- Open File → Import (or Settings → Import).
- Select source: Encrypted archive, CSV, JSON, Other manager.
- Map fields (see template below) and choose destination space.
- Review duplicates → Skip / Merge / Keep both.
- Start import and keep the app open until completion.
Large files: import in batches of 1–5k rows; avoid sleep mode.
CSV Field Mapping
| CSV Column | Maps To | Notes |
|---|---|---|
| title | Item title | Required |
| username | Username | Optional |
| password | Password | Optional |
| url | Website(s) | Comma-separate multiple |
| notes | Secure note | Multiline supported |
| totp | TOTP secret | otpauth:// or base32 |
Encoding must be UTF-8 (no BOM). Quote fields that contain commas.
Export Guide
Encrypted Archive (.bva)
- File → Export → Encrypted Archive
- Set export password or require your key file
- Choose scope: current space / selection / full vault
- Archive includes metadata needed for re-import
Recommended for backups and transfers between devices.
CSV / JSON (Plain)
- Use only for migrations to other tools
- Store locally on an encrypted disk; delete when done
- Never email or upload plaintext exports
Migrating from Other Managers
General
- Export from source as CSV/JSON or native format
- Review fields; remove duplicates or test on a subset
- Import to a staging space, then organize
Attachments & Files
- Some tools omit file blobs in CSV exports
- Re-attach critical files manually after import
TOTP / 2FA
- Prefer exporting
otpauth://URIs if supported - Otherwise rescan QR codes to re-bind secrets
Large Datasets & Performance
- Batch imports (1–5k items) and keep app in foreground
- Disable background indexing during import (Settings → Performance)
- SSD recommended; ensure 2–5 GB free space
- After import, run Tools → Find Duplicates
Troubleshooting
- “Invalid CSV”: Ensure UTF-8, proper quoting, and headers.
- Duplicates: Use Find Duplicates then Merge.
- TOTP not recognized: Provide base32 or full
otpauth://URI.
- Stuck import: Split file; relaunch and retry.
- Encoding issues: Remove BOM; normalize line endings (LF).
- File attachments missing: Export them separately; attach after import.
Still blocked? Submit a ticket with a redacted sample (no secrets).