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

# Chrome Extension

> Capture and process PDFs directly from your browser

## Overview

See a PDF in your browser? Capture it with one click. The OkraPDF Chrome Extension sends documents directly to your library for instant processing.

<Frame>
  <video autoPlay muted loop playsInline controls className="w-full aspect-video" src="https://mintcdn.com/bogeybotllc/AeDZBa_LSwJ7otnI/images/clipping.mp4?fit=max&auto=format&n=AeDZBa_LSwJ7otnI&q=85&s=1b0408cde121fa8725dd1acdf9afcff1" data-path="images/clipping.mp4" />
</Frame>

<Info>
  **Current Version: 2.0.3** — Now with OkraPDF branding and improved capture reliability.
</Info>

## Installation

<Steps>
  <Step title="Visit Chrome Web Store">
    Go to the [OkraPDF Extension](https://chrome.google.com/webstore/detail/okrapdf) in the Chrome Web Store
  </Step>

  <Step title="Add to Chrome">
    Click "Add to Chrome" and confirm the permissions
  </Step>

  <Step title="Pin the Extension">
    Click the puzzle piece icon in Chrome's toolbar and pin OkraPDF for easy access
  </Step>

  <Step title="Sign In">
    Click the extension icon and sign in with your OkraPDF account
  </Step>
</Steps>

## How to Use

### Capture a PDF

When viewing a PDF in Chrome:

1. Click the OkraPDF extension icon
2. Click **"Capture PDF"**
3. The document is sent to your OkraPDF library

```mermaid theme={null}
flowchart LR
    A[PDF in Browser] --> B[Click Extension]
    B --> C[Capture PDF]
    C --> D[OkraPDF Library]
    D --> E[Processing Starts]

    style A fill:#1e293b,color:#f8fafc,stroke:#475569
    style B fill:#FFE01B,color:#1e293b,stroke:#E6C800
    style C fill:#0ea5e9,color:#fff,stroke:#0284c7
    style D fill:#16a34a,color:#fff,stroke:#15803d
    style E fill:#16a34a,color:#fff,stroke:#15803d
```

### From Any Webpage

See a PDF link on a page? Right-click and select **"Send to OkraPDF"** from the context menu.

## Features

<CardGroup cols={2}>
  <Card title="One-Click Capture" icon="mouse-pointer">
    Send PDFs to your library without downloading first
  </Card>

  <Card title="Automatic Processing" icon="wand-magic-sparkles">
    OCR and extraction start automatically after capture
  </Card>

  <Card title="Context Menu" icon="bars">
    Right-click any PDF link to capture
  </Card>

  <Card title="Batch Capture" icon="layer-group">
    Select multiple PDF links and send them all at once
  </Card>
</CardGroup>

## Supported Sources

The extension works with PDFs from:

| Source                    | Support        |
| ------------------------- | -------------- |
| Direct PDF URLs           | Full support   |
| Google Drive previews     | Supported      |
| Dropbox shared links      | Supported      |
| Email attachments (Gmail) | Via preview    |
| Embedded viewers          | Most supported |

<Note>
  Some sites block extension access. If capture fails, download the PDF manually and upload to OkraPDF.
</Note>

## Permissions Explained

The extension requests these permissions:

| Permission                | Why We Need It                   |
| ------------------------- | -------------------------------- |
| **Read browsing history** | Detect when you're viewing a PDF |
| **Access current tab**    | Capture the PDF content          |
| **Storage**               | Remember your login state        |

<Tip>
  We only access tabs when you click the extension. We never read your browsing history.
</Tip>

## After Capture

Once captured, you can:

1. **View processing status** — Click the extension to see capture history
2. **Open in OkraPDF** — Click any captured document to open in the web app
3. **Continue browsing** — Processing happens in the background

## Extension Settings

Click the extension icon and select the gear icon to access settings:

| Setting                     | Description                                         |
| --------------------------- | --------------------------------------------------- |
| **Auto-open after capture** | Immediately open OkraPDF after capture              |
| **Notifications**           | Show desktop notification when processing completes |
| **Default folder**          | Choose which library folder receives captures       |

## Troubleshooting

<AccordionGroup>
  <Accordion title="Extension not capturing">
    1. Ensure you're signed in (click extension icon to check)
    2. Try refreshing the page
    3. Check if the site blocks extensions (some enterprise sites do)
  </Accordion>

  <Accordion title="'Not a PDF' error">
    The page may be rendering a PDF in a custom viewer. Try:

    1. Right-click the PDF and "Open in new tab"
    2. Download and upload manually
  </Accordion>

  <Accordion title="Capture stuck">
    Large PDFs (50+ MB) may take longer. Check your OkraPDF library—the document may still be processing.
  </Accordion>

  <Accordion title="Extension disappeared">
    Click the puzzle piece icon in Chrome's toolbar and re-pin OkraPDF.
  </Accordion>
</AccordionGroup>

## Version History

| Version   | Changes                                |
| --------- | -------------------------------------- |
| **2.0.3** | Bug fixes, improved error messages     |
| **2.0.2** | Updated icons to OkraPDF branding      |
| **2.0.1** | Brand color updates                    |
| **2.0.0** | Complete rebrand from previous version |

## Privacy

* **No tracking** — We don't track your browsing
* **Minimal permissions** — Only what's needed for capture
* **Secure transfer** — All uploads encrypted

## Next Steps

<Card title="Email Import" icon="envelope" href="/integrations/email-import">
  Forward documents to OkraPDF via email
</Card>