> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bkmark.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Importing and Exporting Your Bookmark Library

> Bring your bookmarks in from Pocket, Raindrop.io, your browser, or a previous Bkmark export — and download a full JSON backup at any time.

Bkmark makes it easy to move your bookmarks in and out. You can import from Pocket, Raindrop.io, any major browser, or a previous Bkmark JSON export, and you can download a complete backup of your library whenever you need one. All import and export options are found under **Settings → Data**.

<Note>
  Imports are rate-limited to **5 per hour**. If you need to import multiple files (for example, you exported several collections from Raindrop), spread them out or combine them into a single file before importing.
</Note>

## Importing bookmarks

<Tabs>
  <Tab title="Pocket">
    Pocket lets you export your saved articles as a JSON file from its account settings.

    <Steps>
      <Step title="Export your Pocket data">
        Sign in to [getpocket.com](https://getpocket.com), go to **Settings → Export**, and click **Export HTML file** or request a full data export. For Bkmark's importer, download the **JSON export** from [getpocket.com/export](https://getpocket.com/export).
      </Step>

      <Step title="Open the import screen in Bkmark">
        In Bkmark, go to **Settings → Data → Import** and select **Pocket** as the source.
      </Step>

      <Step title="Upload the file">
        Click **Choose file**, select the JSON file you downloaded from Pocket, then click **Start import**.
      </Step>

      <Step title="Wait for the import to complete">
        Bkmark processes your file and adds each saved item as a bookmark. A summary shows how many bookmarks were imported and how many were skipped.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Raindrop.io">
    Raindrop.io can export your entire collection as a JSON file from its settings.

    <Steps>
      <Step title="Export your Raindrop data">
        Sign in to [app.raindrop.io](https://app.raindrop.io), open **Settings → Backup**, and click **Backup to file (JSON)**. Raindrop will prepare a download and send you an email with the link, or you can download it directly.
      </Step>

      <Step title="Open the import screen in Bkmark">
        In Bkmark, go to **Settings → Data → Import** and select **Raindrop.io** as the source.
      </Step>

      <Step title="Upload the file">
        Click **Choose file**, select the JSON export from Raindrop, then click **Start import**.
      </Step>

      <Step title="Review the import summary">
        Once processing is complete, Bkmark shows you a count of imported items. Your Raindrop collections are converted to Bkmark groups, and tags are preserved.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Browser bookmarks">
    Chrome, Firefox, Edge, and Safari can all export your bookmarks as an HTML file. This is the standard Netscape Bookmark Format supported by all major browsers.

    <Steps>
      <Step title="Export bookmarks from your browser">
        * **Chrome / Edge:** Open the bookmarks manager (`Ctrl+Shift+O` / `⌘+Option+B`), click the three-dot menu, and choose **Export bookmarks**.
        * **Firefox:** Open the Library (`Ctrl+Shift+B` / `⌘+Shift+B`), click **Import and Backup → Export Bookmarks to HTML**.
        * **Safari:** Go to **File → Export Bookmarks**. Safari saves an HTML file to your Desktop by default.
      </Step>

      <Step title="Open the import screen in Bkmark">
        In Bkmark, go to **Settings → Data → Import** and select **Browser bookmarks (HTML)** as the source.
      </Step>

      <Step title="Upload the HTML file">
        Click **Choose file**, select the `.html` file exported from your browser, then click **Start import**.
      </Step>

      <Step title="Review the results">
        Bkmark converts your bookmark folders into groups and preserves titles and URLs. Favicons and descriptions are fetched automatically in the background.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Bkmark JSON">
    If you've previously exported your library from Bkmark, you can re-import that JSON file to restore or migrate your bookmarks.

    <Steps>
      <Step title="Locate your Bkmark export file">
        Find the `.json` file you downloaded from a previous Bkmark export. If you don't have one yet, see the [Exporting your library](#exporting-your-library) section below.
      </Step>

      <Step title="Open the import screen in Bkmark">
        Go to **Settings → Data → Import** and select **Bkmark JSON** as the source.
      </Step>

      <Step title="Choose your duplicate handling preference">
        Toggle **Skip duplicates** if you want Bkmark to ignore any URLs that are already in your library. Leave it off if you want to import everything regardless.
      </Step>

      <Step title="Upload the file and import">
        Click **Choose file**, select your Bkmark JSON file, then click **Start import**. Tags and groups from the export are recreated if they don't already exist.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Exporting your library

You can download a complete backup of your Bkmark library at any time. The export includes all bookmarks, their tags, and their group memberships in a single JSON file.

<Steps>
  <Step title="Open the Data settings">
    Go to **Settings → Data → Export**.
  </Step>

  <Step title="Start the export">
    Click **Export bookmarks**. Bkmark generates the file and your browser downloads it automatically. For large libraries this may take a few seconds.
  </Step>

  <Step title="Save the file">
    The downloaded file is named `bkmark-export-YYYY-MM-DD.json`. Keep it somewhere safe — you can use it to restore your library or migrate to a new account.
  </Step>
</Steps>

The export uses Bkmark's own JSON format. Every bookmark object includes its URL, title, description, tags, groups, favorite status, archive status, and timestamps. You can also retrieve the same data programmatically via the API:

```bash theme={null}
curl https://api.bkmark.it/api/v1/bookmarks/export \
  -H "Authorization: Bearer bk_your_key_here" \
  -o my-bookmarks.json
```