Features

Import & Export

Migrate bookmarks from Pocket, Raindrop.io, Chrome, Firefox, or any service with HTML/JSON export — and export your Arivu data anytime.

Arivu supports importing bookmarks from popular services and exporting your complete collection. Navigate to the Imports page from the sidebar to get started.

Importing Bookmarks

Supported Sources

Source Format Data Imported
Pocket HTML or JSON URLs, titles, tags, timestamps, read status
Raindrop.io HTML or CSV URLs, titles, tags, collections, timestamps
Chrome HTML URLs, titles, folders (mapped to tags)
Firefox JSON or HTML URLs, titles, folders, timestamps
Generic HTML Netscape Bookmark Format URLs, titles, basic metadata
Generic JSON Custom schema Configurable field mapping

How to Import

  1. Export from your current service — Each service has its own export process:

    • Pocket: Settings → Export → Download HTML
    • Raindrop.io: Settings → Backups → Export as HTML/CSV
    • Chrome: Bookmarks Manager (Ctrl+Shift+O) → ⋮ → Export bookmarks
    • Firefox: Bookmarks → Manage → Import/Export → Export to HTML
  2. Upload to Arivu — On the Imports page:

    • Select the source type (Pocket, Raindrop, Chrome, etc.)
    • Upload your export file
    • Review the import preview
    • Click Import
  3. Background processing — Arivu processes bookmarks in the background:

    • Deduplicates against existing bookmarks (URL matching)
    • Fetches content and generates AI summaries
    • Auto-tags new bookmarks
    • Preserves original timestamps when available

Import Jobs

Each import creates a trackable job. You can monitor:

  • Status — Pending, processing, completed, or failed
  • Progress — Number of bookmarks processed vs. total
  • Duplicates skipped — How many already existed
  • Errors — Any bookmarks that failed to import

Exporting Bookmarks

JSON Export

Complete data export with all metadata:

{
  "format": "arivu_json_v1",
  "export_date": "2026-01-12T10:00:00Z",
  "total_bookmarks": 156,
  "bookmarks": [
    {
      "url": "https://example.com/article",
      "title": "Example Article",
      "tags": ["technology", "ai"],
      "summary": "AI-generated summary...",
      "created_at": "2026-01-10T08:30:00Z"
    }
  ]
}

HTML Export

Standard Netscape Bookmark File Format compatible with all browsers and bookmark managers.

How to Export

  1. Navigate to Settings or use the Imports page
  2. Choose export format (JSON or HTML)
  3. Click Export — the file downloads immediately

Backup Strategy

For self-hosted deployments, regular exports serve as application-level backups alongside MongoDB snapshots. Recommended approach:

  • Weekly JSON export — Application-level backup of all bookmark data
  • MongoDB volume snapshots — Full database backup before upgrades
  • Store both — Keep exports and snapshots in separate locations

API Endpoints

Method Endpoint Description
POST /api/bookmarks/import Upload and import bookmarks
GET /api/bookmarks/export Export all bookmarks
GET /api/import-jobs List import job history
GET /api/import-jobs/{id} Get import job status
← Analytics & Insights Resurfacing & Rediscovery →