# Creating bookmarks
Source: https://docs.bookmarkjar.com/bookmarks/add

Learn multiple ways to add bookmarks to Bookmarkjar ®

## Manual

Add bookmarks by copying any link and pasting it with <kbd>⌘</kbd> + <kbd>V</kbd> or <kbd>Ctrl</kbd> + <kbd>V</kbd>.
Alternatively, you can use keyboard shortcuts to add bookmarks: <kbd>⌘</kbd> + <kbd>I</kbd> or <kbd>Ctrl</kbd> + <kbd>I</kbd>.

<Note>
  **Permissions** On mobile or desktop you may need to grant "Allow paste" permissions.
</Note>

<Frame>
  <img alt="Manual Add Bookmark" />
</Frame>

## Via Extension

You can also add bookmarks via the browser extension. See the <a href="/bookmarks/extension">Browser Extension guide</a>.

* Click the "+" icon to add the current page as a bookmark.
* Click the "Sync" icon to sync your current browser bookmarks (and X/Twitter bookmarks) to Bookmarkjar ®.

<Frame>
  <img alt="Extension Usage Alt" />
</Frame>

## Via Integrations

Integrations don’t need any manual action — they sync automatically on a schedule.

Configure your integrations in the <a href="/bookmarks/integrations">Integrations guide</a> or directly in the app at <a href="https://bookmarkjar.com/dashboard/user/integrations">Dashboard → Integrations</a>.

<Frame>
  <img alt="Integrations" />
</Frame>


# API
Source: https://docs.bookmarkjar.com/bookmarks/api

Use our API to interact with Bookmarkjar ® from your own applications

## Overview

The Bookmarkjar ® API allows you to interact with Bookmarkjar ® from your own applications.

<Warning>
  The API is still in BETA and may change frequently without notice.
</Warning>

## Documentation

You can find the API documentation <a href="https://bookmarkjar.com/api/docs">here</a>.

## API Keys

To use the API you need to create an API key. Create one in <a href="https://bookmarkjar.com/dashboard/user/profile">Dashboard → API Keys</a>.
Please keep in mind that API keys do not yet have scoped permissions, so they will have access to all your bookmarks.
Rate limiting is not yet implemented; please be mindful of your usage.

<Note>
  Using tools from your IDE? See the <a href="/bookmarks/mcp">MCP guide</a> for JSON‑RPC over HTTP.
</Note>

<Frame>
  <video />
</Frame>


# AI Chat
Source: https://docs.bookmarkjar.com/bookmarks/chat

Learn how to use the AI chat to find, insert, or follow up on bookmarks

## How it works

The AI chat is a powerful tool that allows you to find, insert, or follow up on bookmarks using natural language.

You can use the AI chat to:

* Find bookmarks by topic, keyword, or URL.
* Insert new bookmarks by URL.
* Follow up on bookmarks by topic, keyword, or URL.

## How to use

You can use the AI chat by clicking the **Chat** button on your dashboard.

<Frame>
  <video />
</Frame>

## Example of good queries

* "Find me the best deals on Levi's jeans I have bookmarked"
* "I have a wedding tomorrow, what should I wear?"
* "Need some articles to read tomorrow about AI — what do you recommend?"
* "Please insert the following URL: [https://www.google.com](https://www.google.com)"

## Edge Cases & What to avoid

* You may ask AI to also query specific tags (tags, tagsMain, tagsSupporting, tagsContext) or notes.
* Follow-ups are welcome but try to keep the conversation natural and engaging about your bookmarks.
* Chat is oriented for Tool Calling, so try to keep the conversation focused on your bookmarks.

## Finished!

That’s it! You can now query your bookmarks using natural language.

<Note>
  Prefer tool calling in your IDE? See the <a href="/bookmarks/mcp">MCP guide</a>.
</Note>


# Cleanup & Duplicates
Source: https://docs.bookmarkjar.com/bookmarks/cleanup

Learn how to find and remove duplicate bookmarks using AI-powered cleanup

## Overview

The Cleanup feature helps you maintain a tidy bookmark collection by identifying and removing duplicate or similar bookmarks. It uses multiple detection strategies—from simple URL matching to AI-powered semantic analysis—to find duplicates you might have missed.

<Frame>
  <img alt="Cleanup Review Interface" />
</Frame>

<Note>
  Nothing is deleted until you explicitly approve. All cleanups go through a review process where you can see exactly what will be removed.
</Note>

## How It Works

1. **Create a Review** — Configure detection methods and filters
2. **Analysis** — The system scans your bookmarks and groups duplicates
3. **Review** — Browse grouped duplicates and choose which to keep
4. **Approve** — Confirm the cleanup to soft-delete duplicates
5. **Restore** (24h) — Accidentally deleted? Restore within 24 hours

## Creating a Cleanup Review

Navigate to **Dashboard → Cleanup** and click **New Review**.

### Detection Methods

<AccordionGroup>
  <Accordion title="Exact Duplicates (Free)">
    Finds bookmarks with identical or nearly identical URLs. This catches:

    * Same URL with different formatting (`http://` vs `https://`)
    * URLs with/without `www.` prefix
    * URLs with trailing slashes removed
    * URLs with fragments (`#section`) removed
  </Accordion>

  <Accordion title="Domain Duplicates (Free)">
    Finds bookmarks from the same domain with similar content. Useful for catching:

    * Same page bookmarked with different tracking parameters (`?utm_source=...`)
    * Mobile vs desktop URLs (`m.twitter.com` vs `twitter.com`)
    * Domain aliases (`x.com` vs `twitter.com`)
  </Accordion>

  <Accordion title="AI Semantic Analysis (Premium)">
    Uses AI embeddings to find bookmarks about the same topic, even if URLs are completely different. Perfect for:

    * Same article syndicated across multiple sites
    * Similar content with different titles
    * Bookmarks covering the same topic from different sources
  </Accordion>
</AccordionGroup>

### Filters

Fine-tune which bookmarks are analyzed:

| Filter                   | Description                                                  |
| ------------------------ | ------------------------------------------------------------ |
| **Exclude Pinned**       | Skip bookmarks you've pinned (default: on)                   |
| **Exclude Protected**    | Skip bookmarks marked as protected (default: on)             |
| **Older Than X Days**    | Only include bookmarks older than a specified number of days |
| **Not Viewed in X Days** | Only include bookmarks you haven't viewed recently           |
| **Domains**              | Include or exclude specific domains                          |

## Reviewing Duplicates

After analysis completes, you'll see your duplicates organized into **groups**. Each group contains bookmarks that the system considers duplicates of each other.

<Frame>
  <img alt="Cleanup Review Interface" />
</Frame>

### Understanding Groups

Each group shows:

* **Keeper** (marked with a crown) — The bookmark that will be preserved
* **Duplicates** — Other bookmarks in the group that will be deleted

### Changing the Keeper

Don't agree with the suggested keeper? Click any bookmark in the group to set it as the new keeper. The system intelligently picks keepers based on:

* Cleanest URL (no tracking parameters)
* Most complete metadata
* Most recent save date

### Skipping Bookmarks

If you don't want to delete a specific duplicate, you can mark it as "Keep" to exclude it from deletion while keeping the rest of the group's actions intact.

## Approving a Cleanup

Once you've reviewed all groups:

1. Click **Approve Cleanup** at the bottom of the review
2. Confirm the action in the dialog
3. Duplicates are soft-deleted (moved to trash)

<Warning>
  Soft-deleted bookmarks are permanently removed after 24 hours. Use the **Deleted** section to restore any mistakes.
</Warning>

## Using Chat for Cleanup

You can also trigger cleanup through the AI chat. Just describe what you want to clean up:

* "Find duplicate bookmarks"
* "Clean up my Twitter bookmarks"
* "Remove bookmarks I haven't viewed in 30 days"
* "Find similar articles about React"

The chat will create a cleanup review based on your request.

## Tips for Best Results

<CardGroup>
  <Card title="Start with Exact Duplicates" icon="bullseye">
    Run exact duplicate detection first—it's fast, accurate, and catches the most obvious duplicates.
  </Card>

  <Card title="Use Domain Duplicates for Social Media" icon="share">
    Social media URLs often have tracking params. Domain duplicate detection cleans these up nicely.
  </Card>

  <Card title="AI Analysis for Deep Cleaning" icon="sparkles">
    Premium users: Enable semantic analysis to find topically similar bookmarks across different sources.
  </Card>

  <Card title="Exclude Important Bookmarks" icon="shield">
    Pin or protect bookmarks you never want to delete before running cleanup.
  </Card>
</CardGroup>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Can I undo a cleanup?">
    Yes! Deleted bookmarks go to a soft-delete state for 24 hours. Visit **Dashboard → Cleanup → Deleted** to restore them.
  </Accordion>

  <Accordion title="What happens to old reviews?">
    Cleanup reviews expire after 7 days if not acted upon. Creating a new review also marks previous pending reviews as expired.
  </Accordion>

  <Accordion title="Is semantic analysis available on the free plan?">
    No, AI semantic analysis requires a Premium subscription. Free users can still use URL-based and domain-based detection.
  </Accordion>

  <Accordion title="How accurate is the duplicate detection?">
    * **Exact duplicates**: 100% accurate (same URL hash)
    * **Domain duplicates**: \~95% accurate (URL normalization + content similarity)
    * **AI semantic**: \~85-95% accurate (depends on content similarity threshold)
  </Accordion>
</AccordionGroup>


# Digests
Source: https://docs.bookmarkjar.com/bookmarks/digest

Receive AI-powered summaries of your bookmarks on a schedule

## Overview

Digests deliver curated summaries of your recently saved bookmarks directly to your inbox. Instead of manually browsing through everything you've saved, get a concise recap highlighting what matters most.

<Frame>
  <img alt="Digest Settings" />
</Frame>

<Note>
  Digests are a **Pro feature**. Upgrade to receive scheduled bookmark summaries.
</Note>

## How It Works

1. **Open Digest Settings** — Click **Settings** in the Digests page header (or **Enable Digests** in the empty state)
2. **Enable Digests** — Toggle **Email digests** on in the settings dialog
3. **Choose Frequency** — Weekly, monthly, bimonthly, or quarterly
4. **Set Delivery Time** — Pick when you want to receive your digest
5. **Save Settings** — AI analyzes your recent bookmarks and sends a curated email on schedule

## Setting Up Digests

Navigate to **Dashboard → Digests** and open **Settings** in the page header to configure your preferences. The settings open in a dialog, so you can adjust them from anywhere on the Digests page.

### Frequency Options

| Frequency     | Best For                                     |
| ------------- | -------------------------------------------- |
| **Weekly**    | Heavy users who save 20+ bookmarks per week  |
| **Monthly**   | Regular users who want a monthly recap       |
| **Bimonthly** | Casual users with moderate bookmark activity |
| **Quarterly** | Light users who prefer occasional summaries  |

### Delivery Preferences

* **Preferred Time** — Choose your ideal delivery hour (e.g., 9:00 AM)
* **Timezone** — Detected from your browser and saved with your settings

Changes apply once you click **Save Settings**.

<Tip>
  Schedule digests for Monday mornings to start your week with a recap of what you saved.
</Tip>

## What's Included in a Digest

Each digest contains:

* **Bookmark Count** — Total bookmarks saved since last digest
* **Top Categories** — Most common topics from your saves
* **Highlighted Items** — AI-picked notable bookmarks with summaries
* **Quick Links** — Direct links to view full bookmarks in your dashboard

## Digest History

View all your past digests from the **History** section. Each entry shows:

| Status         | Meaning                                |
| -------------- | -------------------------------------- |
| **Sent**       | Successfully delivered to your email   |
| **Pending**    | Scheduled and waiting to be processed  |
| **Processing** | Currently being generated              |
| **Failed**     | Delivery failed (check email settings) |

## Tips for Better Digests

<CardGroup>
  <Card title="Keep Saving Regularly" icon="bookmark">
    The more bookmarks you save, the richer your digest summaries become.
  </Card>

  <Card title="Use Tags" icon="tags">
    Tagged bookmarks help the AI categorize content more accurately in your digest.
  </Card>
</CardGroup>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Can I get digests on the free plan?">
    No, digests require a Pro subscription. Free users can still browse and search all their bookmarks manually.
  </Accordion>

  <Accordion title="What if I have no new bookmarks?">
    If you haven't saved anything since your last digest, you'll receive a brief "no new bookmarks" notification instead of an empty digest.
  </Accordion>

  <Accordion title="Can I change the frequency after setting it?">
    Yes! Open **Settings** on the Digests page, pick a new frequency, and click **Save Settings**. The change takes effect from your next scheduled digest.
  </Accordion>

  <Accordion title="Why didn't I receive my digest?">
    Check your spam folder first. If it's not there, verify your email in account settings and ensure digests are enabled. Failed deliveries appear in your digest history.
  </Accordion>
</AccordionGroup>


# Export Bookmarks
Source: https://docs.bookmarkjar.com/bookmarks/export

Download all your bookmarks in JSON, HTML, or CSV format

## Overview

Export all your bookmarks to take your data anywhere. Perfect for backups, migrations, or analyzing your bookmarks in spreadsheets.

<Note>
  **Supported formats**: JSON (complete data), HTML (browser-compatible), and CSV (spreadsheet-friendly)
</Note>

## Export Formats

## How to Export

1. Navigate to **Dashboard → Bookmarks**
2. Click the **Export** button in the toolbar
3. Select your preferred format (JSON, HTML, or CSV)
4. Click **Export**

<Frame>
  <img alt="Export Action" />
</Frame>

### JSON Format

Complete export with all bookmark data including AI analysis, tags, notes, and metadata.

**Includes**:

* URL, title, description
* Tags and notes
* AI summaries and analysis
* Images and metadata
* Creation dates

**Best for**: Complete backups, data portability, programmatic access

### HTML Format

Netscape Bookmark File Format — compatible with all major browsers.

**Includes**:

* URL, title, creation date
* Tags (in description)
* AI summaries (in description)

**Best for**: Importing into Chrome, Firefox, Safari, Edge, or other bookmark managers

**Browser import**:

* **Chrome**: Bookmarks → Bookmark Manager → ⋮ → Import bookmarks
* **Firefox**: Bookmarks → Show All Bookmarks → Import and Backup → Import Bookmarks from HTML
* **Safari**: File → Import From → Bookmarks HTML File
* **Edge**: Favorites → ⋮ → Import favorites

### CSV Format

Spreadsheet-compatible format for analysis in Excel, Google Sheets, or databases.

**Columns**:

* `title` — Bookmark title
* `url` — Bookmark URL
* `description` — Bookmark description
* `tags` — Semicolon-separated tags
* `notes` — Your personal notes
* `created_at` — ISO 8601 timestamp
* `aiResult` — JSON string with AI analysis

**Best for**: Data analysis, filtering, custom processing

You'll receive an email with a download link when your export is ready (usually within a few minutes).

## Export Process

<Steps>
  <Step title="Request Export">
    Choose your format and click Export. The process starts immediately in the background.
  </Step>

  <Step title="Processing">
    Your bookmarks are gathered, formatted, and compressed into a ZIP file. This may take a few minutes for large collections.
  </Step>

  <Step title="Email Notification">
    You'll receive an email with a secure download link when the export is complete.
  </Step>

  <Step title="Download">
    Click the link in your email to download your bookmarks. The link expires after 3 days.
  </Step>
</Steps>

## Export Limits

<Info>
  **Rate limit**: One export at a time per organization
</Info>

* ✅ No limit on number of bookmarks
* ✅ No file size restrictions
* ✅ Download link valid for 3 days
* ⚠️ Only one export can be in progress at a time

If you request a new export while one is processing, you'll see an error. Wait for the current export to complete first.

## File Format Details

### JSON Structure

```json theme={null}
{
  "bookmarks": [
    {
      "title": "GitHub",
      "url": "https://github.com",
      "description": "Where the world builds software",
      "tags": ["development", "code"],
      "notes": "My favorite platform",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "aiResult": {
        "summary": "GitHub is a platform for...",
        "keywords": ["git", "collaboration"]
      }
    }
  ],
  "exportedAt": "2024-11-24T12:00:00.000Z",
  "totalBookmarks": 1
}
```

### HTML Structure

Standard Netscape Bookmark File Format:

```html theme={null}
<!DOCTYPE NETSCAPE-Bookmark-file-1>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8">
<TITLE>Bookmarks</TITLE>
<H1>Bookmarks</H1>
<DL><p>
    <DT><A HREF="https://github.com" ADD_DATE="1705315800">GitHub</A>
    <DD>Tags: development, code
    <DD>AI Summary: GitHub is a platform for...
</DL><p>
```

### CSV Structure

```csv theme={null}
title,url,description,tags,notes,created_at,aiResult
GitHub,https://github.com,Where the world builds software,development;code,My favorite platform,2024-01-15T10:30:00.000Z,"{""summary"":""GitHub is a platform for...""}"
```

## Security & Privacy

All exports are secure:

* ✅ Encrypted storage (S3)
* ✅ Signed URLs with 3-day expiration
* ✅ Only accessible by authenticated users
* ✅ Automatic cleanup of expired exports
* ✅ Files are compressed (ZIP format)

## Best Practices

<Tip>
  **Regular backups**: Export your bookmarks monthly to keep an offline backup of your data.
</Tip>

### For Backups

* Use **JSON format** for complete data preservation
* Store exports in a secure location (encrypted drive, cloud storage)
* Keep multiple versions (monthly snapshots)

### For Migration

* Use **HTML format** to import into other bookmark managers
* Use **CSV format** for custom database imports
* Test with a small subset first

### For Analysis

* Use **CSV format** for spreadsheet analysis
* Import into Excel, Google Sheets, or databases
* Filter by tags, dates, or domains

## Troubleshooting

<AccordionGroup>
  <Accordion title="Export is taking a long time">
    Large collections (10,000+ bookmarks) may take 5-10 minutes to process. You'll receive an email when it's ready.

    The export runs in the background, so you can continue using the app.
  </Accordion>

  <Accordion title="Didn't receive export email">
    * Check your spam/junk folder
    * Verify your email address in account settings
    * Wait at least 10 minutes before requesting a new export
    * Contact support if still not received
  </Accordion>

  <Accordion title="Download link expired">
    Links expire after 3 days for security. Request a new export to get a fresh download link.
  </Accordion>

  <Accordion title="Can't request new export">
    Only one export can be in progress at a time. Wait for your current export to complete (check your email) or contact support to cancel it.
  </Accordion>

  <Accordion title="File won't open">
    * Ensure you've fully downloaded the ZIP file
    * Extract the ZIP file first (don't open directly)
    * For CSV: Open with Excel, Google Sheets, or a text editor
    * For HTML: Open with any web browser or import into browser bookmarks
    * For JSON: Open with a text editor or JSON viewer
  </Accordion>
</AccordionGroup>

## After Exporting

Once you've downloaded your export:

1. **Verify** — Open the file to ensure all bookmarks are included
2. **Backup** — Store in a secure location
3. **Import** — Use HTML format to import into other browsers/tools
4. **Analyze** — Use CSV format for custom analysis

## Need Help?

Having trouble with exports? Check out:

* <a href="/misc/troubleshooting">Troubleshooting Guide</a>
* <a href="mailto:hi@bookmarkjar.com">Contact Support</a>
* <a href="https://discord.gg/PW8zg3xUEN">Join our Discord</a>


# Browser Extension
Source: https://docs.bookmarkjar.com/bookmarks/extension

Learn how to use the browser extension to add bookmarks to Bookmarkjar ®

## Chrome Web Store

The Chrome extension is now available on the Chrome Web Store! Install it with one click:

<a href="https://chromewebstore.google.com/detail/bookmarks-extension/necdpmeihklgolkpfppapjodnbhhjpfa">
  <button>Install Chrome Extension</button>
</a>

## Firefox (Manual Installation)

Firefox store version is coming soon. For now, follow the manual installation:

**Chrome:** <a href="https://chromewebstore.google.com/detail/bookmarks-extension/necdpmeihklgolkpfppapjodnbhhjpfa">Install from Chrome Web Store</a> - one click install!

**Firefox:** <a href="https://bookmarkjar.com/downloads/bookmarks-extension-firefox.zip">Download the Firefox extension</a> and follow the manual installation:

* Go to `about:debugging#/runtime/this-firefox`, click "Load temporary add-on...", and select the unzipped folder.

Quick guide:

<Frame>
  <img alt="Extension Installation" />
</Frame>

Once you are done you can pin it to your toolbar or access it from the extensions menu.

<Frame>
  <img alt="Extension Sticky" />
</Frame>

## Alternative Downloads

If you prefer to download the extension directly instead of using the store:

* **Chrome/Chromium**: <a href="https://bookmarkjar.com/downloads/bookmarks-extension-chrome.zip">Download Chrome Extension (.zip)</a>
* **Firefox**: <a href="https://bookmarkjar.com/downloads/bookmarks-extension-firefox.zip">Download Firefox Extension (.zip)</a>

<Accordion title="Manual Installation Instructions">
  **Chrome/Chromium browsers:**

  1. Download and unzip the extension
  2. Go to `chrome://extensions`
  3. Enable "Developer mode" (toggle in top right)
  4. Click "Load unpacked" and select the unzipped folder

  **Firefox:**

  1. Download and unzip the extension
  2. Go to `about:debugging#/runtime/this-firefox`
  3. Click "Load Temporary Add-on..."
  4. Select any file from the unzipped folder
</Accordion>

## Browser Extension Features

The browser extension allows you to:

* Sync the latest 500 bookmarks from your current browser bookmarks.
* Sync the latest 200+ X (Twitter) bookmarks.
* Add the current page as a bookmark.
* Add Selected text as a bookmark.

### Native Bookmark Integration

The extension seamlessly integrates with your favorite platforms:

**Twitter/X**: Click the native bookmark button on any tweet and it will automatically be saved to Bookmarkjar. No extra steps needed - just use Twitter as you normally would.

**Instagram**: Click the save button on any post and it will be added to your Bookmarkjar collection. Works with all Instagram languages.

<Note>
  Native bookmark integration works in the background. You'll see tweets and posts appear in your Bookmarkjar dashboard automatically after clicking the platform's save/bookmark button.
</Note>

<Note>
  See <a href="/bookmarks/add">Creating bookmarks</a> for keyboard shortcuts and other quick‑add options.
</Note>


# Import Bookmarks
Source: https://docs.bookmarkjar.com/bookmarks/import

Bulk import your bookmarks from CSV or HTML files

## Overview

Import hundreds or thousands of bookmarks at once from CSV or HTML files. Perfect for migrating from other bookmark managers or importing browser bookmarks.

<Note>
  **Supported formats**: CSV (`.csv`) and HTML (`.html`, `.htm`) files exported from Chrome, Firefox, Safari, or other bookmark managers.
</Note>

## How to Import

1. Navigate to **Dashboard → Bookmarks**
2. Click the **Import** button in the toolbar
3. Select your file format (CSV or HTML)
4. Choose your file
5. Click **Import**

<Frame>
  <img alt="Import from CSV" />
</Frame>

<Info>
  **Imports run in the background** — You can continue using the app while your bookmarks are being imported. You'll receive a notification when the import completes.
</Info>

## Supported Formats

### HTML Files

Import bookmarks exported from browsers like Chrome, Firefox, Safari, Edge, or other bookmark managers.

* **Chrome**: Bookmarks → Bookmark Manager → ⋮ → Export bookmarks
* **Firefox**: Bookmarks → Show All Bookmarks → Import and Backup → Export Bookmarks to HTML
* **Safari**: File → Export Bookmarks
* **Edge**: Favorites → ⋮ → Export favorites

### CSV Files

Import from spreadsheets or custom exports. Your CSV must include a column for URLs.

**Required columns** (case-insensitive):

* `url`, `link`, or `href` — The bookmark URL (required)
* `title` or `name` — The bookmark title (optional)

**Example CSV format**:

```csv theme={null}
url,title
https://github.com,GitHub
https://stackoverflow.com,Stack Overflow
https://developer.mozilla.org,MDN Web Docs
```

## Import Limits

<Warning>
  **Maximum bookmarks per import**: 10,000 bookmarks per file
</Warning>

For HTML files, parsing stops after 50,000 links to prevent performance issues. If you have larger files, split them into smaller batches.

<Note>
  **Plan limits apply** — If your file contains more bookmarks than your available slots, only the first bookmarks up to your limit will be imported. For example, if you have 100 slots available and import a file with 5,000 bookmarks, only the first 100 will be added.
</Note>

## What Gets Imported

✅ **Imported**:

* URL (validated and sanitized)
* Title (if available)
* Automatic metadata extraction (description, images, etc.)

❌ **Not imported**:

* Folders/organization (bookmarks are imported flat)
* Tags (add them after import)
* Favicons (fetched automatically)
* Custom notes (add them after import)

## Security & Validation

All imports are validated for security:

* ✅ Only `http://` and `https://` URLs accepted
* ✅ URLs sanitized to prevent injection attacks
* ✅ Maximum URL length: 2,048 characters
* ✅ Duplicate URLs are automatically skipped
* ✅ Invalid URLs are filtered out

## Best Practices

<Tip>
  **Clean your data first**: Remove broken links and duplicates before importing for faster processing.
</Tip>

### For CSV Files

* Use UTF-8 encoding to support international characters
* Include headers in the first row
* Quote fields that contain commas
* Keep file size under 10MB for best performance

### For HTML Files

* Export directly from your browser for best compatibility
* Avoid manually editing HTML files (can cause parsing errors)
* Remove unnecessary metadata before exporting

## Troubleshooting

<AccordionGroup>
  <Accordion title="Import shows 0 bookmarks found">
    **For CSV**: Ensure your file has a column named `url`, `link`, or `href` (case-insensitive).

    **For HTML**: Verify the file is a valid HTML bookmark export, not a regular webpage.
  </Accordion>

  <Accordion title="Some bookmarks were skipped">
    Bookmarks are skipped if:

    * The URL is invalid or malformed
    * The URL exceeds 2,048 characters
    * The URL uses an unsupported protocol (not http/https)
    * The bookmark already exists in your account
  </Accordion>

  <Accordion title="Import is taking a long time">
    Large imports (1,000+ bookmarks) may take several minutes. The process runs in the background, so you can continue using the app.

    For very large imports, consider splitting into smaller batches of 1,000-2,000 bookmarks.
  </Accordion>

  <Accordion title="File upload fails">
    * Check file size is under 10MB
    * Verify file format is `.csv`, `.html`, or `.htm`
    * Try exporting the file again from your source
    * Contact support if the issue persists
  </Accordion>
</AccordionGroup>

## After Importing

Once your bookmarks are imported:

1. **Review** — Check the import summary for any skipped items
2. **Organize** — Add tags to categorize your bookmarks
3. **Search** — Use AI-powered search to find what you need
4. **Clean up** — Remove any unwanted bookmarks

<Note>
  Imported bookmarks are automatically indexed for search and will appear in your AI chat context.
</Note>

## Need Help?

Having trouble with imports? Check out:

* <a href="/misc/troubleshooting">Troubleshooting Guide</a>
* <a href="mailto:hi@bookmarkjar.com">Contact Support</a>
* <a href="https://discord.gg/PW8zg3xUEN">Join our Discord</a>


# Integrations
Source: https://docs.bookmarkjar.com/bookmarks/integrations

Find how to connect your bookmarks to other services like Reddit, GitHub, Twitter, Instagram, YouTube and more

## How it works

Adding bookmarks manually is okay, but it’s not ideal. Connect your favorite services to Bookmarkjar ® so new saves are automatically synced.

We’ll expand more services over time. For now you can connect X (Twitter), Reddit, and GitHub.

## How to use

From your Dashboard, click **Integrations** to connect services, then press **Connect**.
That’s it! Your bookmarks from connected services will auto‑sync into Bookmarkjar ®.

<Frame>
  <img alt="Integrations" />
</Frame>

## Rate limits & Sync Frequency

Each integration may sync at a different frequency because providers have different rate limits. We adapt to each provider’s rules.
X (Twitter), for example, can be pricey per API call, so we use their APIs judiciously to keep things fair for everyone.

<Note>
  Prefer a one‑click add from the browser? See the <a href="/bookmarks/extension">Browser Extension</a>.
</Note>


# Managing Bookmarks
Source: https://docs.bookmarkjar.com/bookmarks/manage

Learn how to organize, view, and manage your bookmarks in Bookmarkjar

## Viewing Bookmarks

Your bookmarks are displayed in a grid view showing thumbnail previews, titles, and metadata.

<Frame>
  <img alt="Bookmark Grid View" />
</Frame>

### Video Bookmarks

Bookmarks from video content (Twitter videos, Instagram Reels, YouTube, etc.) display a play button overlay on their thumbnail. Click the play button to watch the video directly within Bookmarkjar without leaving the app.

<Frame>
  <img alt="Bookmark Video View" />
</Frame>

### Page Size

Customize how many bookmarks appear per page using the settings cog icon next to the pagination controls. Available options: 10, 20, 30, 40, 50, 60, 100, or 200 bookmarks per page.

Your preference is saved automatically and persists across sessions.

<Frame>
  <img alt="Bookmark Page Size" />
</Frame>

## Bulk Operations

Select multiple bookmarks to perform batch actions.

### Selecting Bookmarks

<Frame>
  <img alt="Bookmark Selecting" />
</Frame>

* **Single click**: Toggle selection on a bookmark
* **Shift + click**: Select a range of bookmarks between your last selected bookmark and the clicked one
* **Selection indicator**: A blue checkbox appears on selected bookmarks

### Bulk Actions

<Frame>
  <img alt="Bookmark Bulk Actions" />
</Frame>

Once you have bookmarks selected, the following actions become available:

* **Delete**: Remove all selected bookmarks permanently
* **Refresh**: Re-crawl metadata for all selected bookmarks (useful if titles/images are outdated)

<Warning>
  Bulk delete is permanent and cannot be undone. Make sure you've selected the correct bookmarks before confirming deletion.
</Warning>

## Organization Management

### Wipe Organization Data

<Frame>
  <img alt="Bookmark Wipe Organization Data" />
</Frame>

If you need to start fresh, you can wipe all data from your organization in **Settings → Organization → Danger Zone**.

This removes:

* All bookmarks
* All tags
* All collections
* Integration sync history

<Warning>
  This action is irreversible. Export your bookmarks first if you want to keep a backup.
</Warning>


# MCP (Model Context Protocol)
Source: https://docs.bookmarkjar.com/bookmarks/mcp

Connect Bookmarkjar to Claude Code, ChatGPT, Cursor, or Codex, then search, save, and clean up bookmarks directly from chat.

Bookmarkjar MCP connects your bookmark library to an AI assistant. After a one-time browser sign-in, you can ask the assistant to find saved links, add new bookmarks, or prepare a cleanup review.

<Note>
  MCP access requires an active paid plan. You do not need to create or paste an API key.
</Note>

## Choose your AI app

The Bookmarkjar server URL is:

```text theme={null}
https://bookmarkjar.com/api/mcp
```

### Claude Code

Run this command in a terminal:

```bash theme={null}
claude mcp add --transport http bookmarkjar https://bookmarkjar.com/api/mcp
```

Start a new Claude Code session, then ask:

```text theme={null}
Search my Bookmarkjar bookmarks for design systems.
```

In Claude Code, type `/mcp`, select `bookmarkjar`, and choose **Authenticate**. Claude opens Bookmarkjar in your browser. Sign in, review the permissions, click **Allow**, and return to Claude Code.

### Claude on the web or Claude Desktop

1. Open [Claude → Settings → Connectors](https://claude.ai/settings/customize-connectors).
2. Click **Add custom connector**.
3. Name it `Bookmarkjar` and paste `https://bookmarkjar.com/api/mcp`.
4. Under **Authentication**, keep **Always required**.
5. Under **OAuth client**, choose **No client ID — register one automatically**. Bookmarkjar supports Dynamic Client Registration (DCR); do not choose Anthropic-hosted client metadata.
6. Save the connector, click **Connect**, and complete the Bookmarkjar browser authorization.
7. Enable Bookmarkjar in a conversation from the **+** menu under **Connectors**.

Team and Enterprise workspaces require an owner to add the custom connector before members can connect it.

### ChatGPT

1. In ChatGPT, open **Settings → Security and login** and enable **Developer mode**.
2. Open [ChatGPT Plugins](https://chatgpt.com/plugins) and click the **+** button.
3. Enter a name and description, then choose a public MCP connection.
4. Use `https://bookmarkjar.com/api/mcp` as the server URL.
5. Keep authentication required. If ChatGPT asks how to register the OAuth client, choose automatic registration or DCR; do not enter an API key or client secret.
6. Create the connection and review the discovered tools.
7. Add Bookmarkjar from the tools menu in a new conversation, then complete the Bookmarkjar browser authorization.

Developer mode and custom MCP connections depend on your ChatGPT plan and workspace policy.

### Cursor

Create `.cursor/mcp.json` in your project, or `~/.cursor/mcp.json` to use Bookmarkjar in every project:

```json theme={null}
{
  "mcpServers": {
    "bookmarkjar": {
      "url": "https://bookmarkjar.com/api/mcp"
    }
  }
}
```

Reload Cursor, open **Customize → MCP**, enable `bookmarkjar`, and choose **Authenticate**. Cursor discovers Bookmarkjar OAuth automatically through DCR; no static client ID or API key is required.

### Codex CLI and ChatGPT desktop

Add this to `~/.codex/config.toml` on macOS or Linux, or `%USERPROFILE%\.codex\config.toml` on Windows. ChatGPT desktop, Codex CLI, and the Codex IDE extension share this configuration:

```toml theme={null}
[mcp_servers.bookmarkjar]
url = "https://bookmarkjar.com/api/mcp"
auth = "oauth"
```

Run these commands:

```bash theme={null}
codex mcp login bookmarkjar
codex mcp list
```

Complete the Bookmarkjar browser authorization, then restart Codex or ChatGPT desktop.

## Let your AI set it up

Paste the prompt below into Claude, ChatGPT, Cursor, Codex, or another capable assistant. It will detect the client, guide you through the correct setup, and stop for the browser authorization step.

```text theme={null}
Help me connect this AI client to Bookmarkjar MCP.

Bookmarkjar MCP server:
https://bookmarkjar.com/api/mcp

Rules:
- Detect whether I am using Claude Code, Claude on the web/Desktop, ChatGPT, Cursor, Codex CLI, or another MCP client.
- Tell me what you detected before changing anything.
- Do not ask me for a Bookmarkjar API key. This connection uses browser-based OAuth.
- Ask before editing a configuration file.

Use the matching setup:

Claude Code:
Run:
claude mcp add --transport http bookmarkjar https://bookmarkjar.com/api/mcp
Then tell me to type /mcp, select bookmarkjar, choose Authenticate, and complete browser authorization.

Claude on the web or Claude Desktop:
Guide me to Settings → Connectors → Add custom connector. Use the server URL above. Keep Authentication set to Always required. Under OAuth client, choose No client ID — register one automatically (DCR), not Anthropic-hosted client metadata. Tell me that Team or Enterprise workspaces require an owner to add the connector first.

ChatGPT web:
Guide me to Settings → Security and login → Developer mode. Then open ChatGPT Plugins, click +, enter a name and description, choose a public MCP connection, and use the server URL above. Keep authentication required. If asked for OAuth client registration, choose automatic registration or DCR. Mention that availability depends on my plan and workspace policy.

Cursor:
Ask before creating or updating .cursor/mcp.json for the project, or ~/.cursor/mcp.json globally. Add:
{
  "mcpServers": {
    "bookmarkjar": {
      "url": "https://bookmarkjar.com/api/mcp"
    }
  }
}
Then tell me to reload Cursor, open Customize → MCP, enable bookmarkjar, and choose Authenticate.

Codex CLI or ChatGPT desktop:
Ask before updating my Codex config. Add this to ~/.codex/config.toml on macOS/Linux or %USERPROFILE%\.codex\config.toml on Windows:
[mcp_servers.bookmarkjar]
url = "https://bookmarkjar.com/api/mcp"
auth = "oauth"
Then run codex mcp login bookmarkjar followed by codex mcp list.

After registration:
1. Tell me to start a fresh chat or session.
2. Ask the client to search my Bookmarkjar bookmarks for "design systems".
3. Wait while I sign in to Bookmarkjar and click Allow in the browser.
4. Verify that the bookmarks.search tool returns a result or an empty result without an authorization error.
5. Report what was configured and ask what I want to search or save next.
```

## Things to try

Once connected, speak normally:

```text theme={null}
Search my Bookmarkjar bookmarks for PostgreSQL performance.
```

```text theme={null}
Save https://example.com to my Bookmarkjar bookmarks.
```

```text theme={null}
Create a cleanup review for duplicate design bookmarks.
```

A cleanup request only creates a review. Bookmarkjar does not delete candidates until you approve them in the Cleanup screen.

## What access you approve

The browser consent screen asks for one or both permissions:

* **Read:** search your bookmarks.
* **Write:** save bookmarks and create cleanup reviews.

Access is tied to your signed-in Bookmarkjar account. You can deny the request or disconnect the integration from your AI client.

## Available tools

* `bookmarks.search` — search and filter your bookmarks.
* `bookmarks.insert` — save one or more URLs.
* `cleanup.create` — prepare a cleanup review without automatically deleting anything.

The server uses Streamable HTTP and browser-based OAuth at `https://bookmarkjar.com/api/mcp`. Do not add an API key header to this endpoint.

## Troubleshooting

* **No browser window opens:** start a fresh chat or client session, confirm `bookmarkjar` is enabled, then call a Bookmarkjar tool again.
* **401 Unauthorized:** reconnect Bookmarkjar and finish the browser authorization.
* **403 insufficient\_scope:** reconnect and approve the requested read or write permission.
* **Subscription required:** connect with a Bookmarkjar account that has an active paid plan.
* **ChatGPT cannot add the server:** confirm Developer mode is available for your plan and allowed by your workspace.
* **Claude Team or Enterprise cannot add the connector:** ask a workspace owner to add it under organization connector settings.
* **Redirect or signature error:** remove the connection, add it again, and complete a fresh authorization request.


# Search Bookmarks
Source: https://docs.bookmarkjar.com/bookmarks/search

Learn how to search and filter your bookmarks quickly

## How it works

The whole idea of this project is to keep everything simple and search‑oriented.
Bookmarkjar ® uses advanced search techniques to find the best results for you using Semantic Search and Fuzzy Search with the help of a powerful engine called Meilisearch.
If you need deeper results, try the <a href="/bookmarks/chat">AI Chat</a> or the <a href="/bookmarks/mcp">MCP tools</a>.

You may search anything you want by using the search bar or pressing <kbd>⌘</kbd> + <kbd>K</kbd> on your keyboard.

<Frame>
  <img alt="Search Bookmarks" />
</Frame>

## Filtering

You can also apply filters via the sidebar: **colors**, **tags**, **domains**.

<Frame>
  <img alt="Search Bookmarks Filters" />
</Frame>


# Introduction
Source: https://docs.bookmarkjar.com/index

Welcome to Bookmarkjar ® Documentation

## Getting started

Bookmarkjar ® is an AI-first bookmark manager, so you can save anything, find everything, and organize your bookmarks without the hassle of folders.
Setup is straightforward — you can get started in seconds.

<Card title="Quickstart" icon="rocket" href="/quickstart">
  Follow our quickstart guide to get started with Bookmarkjar ®.
</Card>

## Make it yours

<Columns>
  <Card title="Adding bookmarks" icon="bookmark" href="/bookmarks/add">
    Learn multiple ways to add bookmarks to Bookmarkjar ®.
  </Card>

  <Card title="Searching for bookmarks" icon="search" href="/bookmarks/search">
    Need to find something? Learn how to get better results with our search engine.
  </Card>

  <Card title="Browser Extension" icon="browser" href="/bookmarks/extension">
    Use the browser extension to add from your browser in a single click.
  </Card>

  <Card title="AI Chat" icon="brain" href="/bookmarks/chat">
    Need help finding something or following up on a saved bookmark? Let our AI chatbot help you.
  </Card>
</Columns>


# Changelog
Source: https://docs.bookmarkjar.com/misc/changelog

Here you can find the changelog for the Bookmarkjar ®

## 1.0.5

### Browser Extension

* Better batching for sync
* Selective sync for Twitter/X and Instagram & Browser
* Pooled sync for Twitter/X and Instagram & Browser

### Bookmarks

* Digest Feature - receive AI-powered summaries of your bookmarks on a schedule
* Cleanup Feature - find and remove duplicate bookmarks using AI-powered cleanup

## 1.0.4

### Browser Extension

* Native bookmark click integration for Twitter/X - automatically saves bookmarks when you click the native bookmark button
* Native save button integration for Instagram - saves posts when you click the save button (supports 20+ languages)

### Web App

* Video playback support - play button overlay on video bookmarks with in-app video player
* Page size selector - customize how many bookmarks display per page (10-200)
* Alternative extension download links in the integrations page

## 1.0.3

### Bulk Operations

* Bulk bookmark selection with shift-click support
* Bulk bookmark deletion
* Bulk bookmark refresh to re-crawl metadata
* Organization data wipe option in settings

## 1.0.2

* Added export function to CSV and HTML files
* Queued Import for Large Files
* Migrated Infra for zero-downtime deployment

## 1.0.1

* Added Import from HTML and CSV files
* Fixed issues with Email Verification

## 1.0.0

* Initial release


# Mobile App
Source: https://docs.bookmarkjar.com/misc/mobile-app

Add Bookmarkjar to your home screen for a native app experience

<Info>
  **Native apps are coming soon!** In the meantime, add Bookmarkjar to your home screen for instant access.
</Info>

## Add to Home Screen (iOS)

Get instant access to your bookmarks with a beautiful app icon on your iPhone or iPad.

<Steps>
  <Step title="Open Safari">
    Navigate to [bookmarkjar.com](https://bookmarkjar.com) in Safari
  </Step>

  <Step title="Tap the Share button">
    Tap the share icon (square with an arrow pointing up) at the bottom of the screen
  </Step>

  <Step title="Add to Home Screen">
    Scroll down and tap **"Add to Home Screen"**
  </Step>

  <Step title="Confirm">
    Tap **"Add"** in the top right corner
  </Step>
</Steps>

### What You Get

<CardGroup>
  <Card title="Full-screen Experience" icon="expand">
    No browser UI, just your bookmarks
  </Card>

  <Card title="Quick Launch" icon="rocket">
    One tap from your home screen
  </Card>

  <Card title="Native Feel" icon="mobile">
    Smooth animations and transitions
  </Card>

  <Card title="Offline Access" icon="wifi-slash">
    View recently accessed bookmarks (coming soon)
  </Card>
</CardGroup>

***

## Add to Home Screen (Android)

Android users can also install Bookmarkjar as a Progressive Web App (PWA).

<Steps>
  <Step title="Open Chrome">
    Navigate to [bookmarkjar.com](https://bookmarkjar.com) in Chrome
  </Step>

  <Step title="Open menu">
    Tap the menu (three dots in the top right)
  </Step>

  <Step title="Install">
    Tap **"Add to Home screen"** or **"Install app"**
  </Step>

  <Step title="Confirm">
    Tap **"Add"** to confirm
  </Step>
</Steps>

<Tip>
  Most Android browsers support PWA installation. Look for an "Install" or "Add to Home Screen" option in the browser menu.
</Tip>

***

## Native Apps (Coming Soon)

We're working on dedicated native apps for iOS and Android with additional features:

* **Push notifications** — Get notified about shared collections and updates
* **Offline sync** — Full offline access to all your bookmarks
* **Share extension** — Save bookmarks directly from any app
* **Widgets** — Quick access to recent bookmarks from your home screen

<Card title="Stay Updated" icon="bell" href="https://x.com/bookmarkjar">
  Follow us on X/Twitter to be notified when native apps launch
</Card>


# Roadmap
Source: https://docs.bookmarkjar.com/misc/roadmap

Here you can find our roadmap for the next features and improvements

## Short term

* [ ] RSS Feeds with smart filtering using AI
* [x] First party Twitter X integration
* [x] Instagram integration
* [ ] Better LinkedIn integration
* [ ] Video Transcription for Better Context
* [ ] Webhooks for external services
* [x] Import from HTML, CSV, JSON
* [x] Export to HTML, CSV, JSON

## Long term

* [x] Unified RAG integration across all sources
* [x] Document and extract external sources
* [x] SERP integration for valuable information (SEO)


# Troubleshooting
Source: https://docs.bookmarkjar.com/misc/troubleshooting

Found a bug? Here you can find some common issues and how to fix them

## Bookmark crawling didn’t work

Please make sure that the URL is public and accessible. We can't crawl private or not accessible URLs, probably a nice feature to add in the future. :p
If you believe it was a mistake, you may click the three dots at the bottom right corner of the bookmark and click *"Refresh"* to try again.

We try to crawl and summarize bookmarks at least three times with a backoff strategy before giving up.

## Bookmark preview image is missing

This can happen for multiple reasons. We try `og:image` first; if unavailable, a headless browser screenshots the page.
If all attempts fail, a placeholder image is used. As above, you can refresh the bookmark to try again.

## Stuck at crawling or summarizing

This should be rare. If you see a job stuck at crawling or summarizing, contact support so we can investigate.


# Quickstart
Source: https://docs.bookmarkjar.com/quickstart

Get started with Bookmarkjar ® in 60 seconds

## Get started in three steps

Create your Bookmarkjar ® account at <a href="https://bookmarkjar.com/auth/sign-up">Sign Up</a>.
We recommend using **Google** or **Discord** for a fast, smooth sign‑up experience.

### Step 1: Add your first bookmark

Once you’re logged in, visit the <a href="https://bookmarkjar.com/dashboard">Dashboard</a>.
Copy any link and paste it with <kbd>⌘</kbd> + <kbd>V</kbd> or <kbd>Ctrl</kbd> + <kbd>V</kbd> to add it to Bookmarkjar ®.
You can also use keyboard shortcuts to add bookmarks: <kbd>⌘</kbd> + <kbd>I</kbd> or <kbd>Ctrl</kbd> + <kbd>I</kbd>.
That’s it! You've added your first bookmark.

### Step 2: Install Browser Extension

The browser extension lets you sync your current browser bookmarks, select text to save, quickly add bookmarks to Bookmarkjar ®, and sync your X (Twitter) bookmarks.

<AccordionGroup>
  <Accordion icon="chrome" title="Chrome Web Store (Recommended)">
    Install the extension directly from the Chrome Web Store with one click:

    <a href="https://chromewebstore.google.com/detail/bookmarks-extension/necdpmeihklgolkpfppapjodnbhhjpfa">Install Chrome Extension</a>
  </Accordion>

  <Accordion icon="browser" title="Firefox (Manual Installation)">
    **Chrome:** <a href="https://chromewebstore.google.com/detail/bookmarks-extension/necdpmeihklgolkpfppapjodnbhhjpfa">Install from Chrome Web Store</a> - one click install!

    **Firefox:** <a href="https://bookmarkjar.com/downloads/bookmarks-extension-firefox.zip">Download the Firefox extension</a> and follow the manual installation:

    * Go to `about:debugging#/runtime/this-firefox`, click "Load temporary add-on...", and select the unzipped folder.

    Quick guide:

    <Frame>
      <img alt="Extension Installation" />
    </Frame>

    Once you are done you can pin it to your toolbar or access it from the extensions menu.

    <Frame>
      <img alt="Extension Sticky" />
    </Frame>
  </Accordion>
</AccordionGroup>

### Step 3: Yay! You’re ready to get started!

Your browser extension is now ready to use! You can select text or bookmark a page with a single click.

<Accordion icon="rocket" title="See how it works">
  Once you are done, you can now select any text or bookmark a page with a single click.

  <Frame>
    <img alt="Extension Usage" />
  </Frame>

  You may also click the extension icon to sync or add a new bookmark.

  <Frame>
    <img alt="Extension Usage Alt" />
  </Frame>
</Accordion>

## Next steps

Now that you’ve completed the first steps, learn more about how to use Bookmarkjar ®. Let’s explore the following topics:

<CardGroup>
  <Card title="Using AI Chat" icon="brain" href="/bookmarks/chat">
    Learn how to use our AI chat to find bookmarks or follow-up on a saved bookmark.
  </Card>

  <Card title="Searching for bookmarks" icon="search" href="/bookmarks/search">
    Need to find something? Learn how to get better results with our search engine.
  </Card>

  <Card title="Connecting Integrations" icon="link" href="/bookmarks/integrations">
    Connect X, Reddit, GitHub, Instagram, YouTube and more to your Bookmarkjar ®.
  </Card>

  <Card title="API" icon="book-open-cover" href="/bookmarks/api">
    API Documentation and how to use it in your own applications.
  </Card>
</CardGroup>

<Note>
  **Need help?** Contact us at [hi@bookmarkjar.com](mailto:hi@bookmarkjar.com) or join our [Discord](https://discord.gg/PW8zg3xUEN).
</Note>