Questions, answered.
Setup guides, troubleshooting, and everything in between. If you can't find what you need, email clipactionsupport@protonmail.com.
Getting started
What is ClipAction?
ClipAction is a Chrome extension that turns any selected text on the web into an AI-powered action. Select text, press Ctrl+Shift+Space, pick an action (rewrite, summarize, translate, explain, fix grammar, etc.), and paste the result back — all keyboard-driven.
How do I use it?
- Select any text on a web page.
- Press Ctrl+Shift+Space (or ⌘+Shift+Space on Mac).
- Arrow-key or type to filter actions, press Enter to run.
- Review the result. Press Enter again to copy-and-replace, or Esc to dismiss.
No mouse required. See the setup guide for a walkthrough.
Which browsers are supported?
Any Chromium-based browser: Chrome, Brave, Edge, Arc, Opera, Vivaldi.
On-device Gemini Nano requires Chrome 127+ (or a recent Chromium build that ships Nano). Cloud providers work in every supported browser without extra setup.
Is ClipAction free?
Yes. The core actions (rewrite, summarize, translate, explain, fix grammar, shorten, expand) are free and run on-device via Gemini Nano. Pro ($5/month) adds custom actions, site profiles, and cloud provider support. See the pricing section.
Gemini Nano setup
Nano is Chrome's built-in on-device AI model. No API key, no cloud, no cost. It takes a one-time setup to activate — here's how.
What is Gemini Nano?
Gemini Nano is a small language model that ships inside Chrome itself. It runs entirely on your machine — CPU, GPU, or NPU depending on hardware — and never sends your text anywhere. ClipAction uses the Chrome Prompt API, Rewriter API, and Summarizer API to talk to it.
System requirements
- OS: Windows 10/11, macOS 13+, Linux, or ChromeOS
- Browser: Chrome 127 or newer (check via
chrome://version) - Storage: ~22 GB free for the model download
- GPU: 4+ GB VRAM recommended (integrated GPUs work, but slower)
- Memory: 8 GB RAM minimum
- Network: Unmetered connection for the initial model download (~1.5–2 GB)
No Google account required — the model is downloaded and run locally.
How do I enable Nano in Chrome?
Chrome ships Nano behind two flags. Enable them, restart, and the model downloads in the background.
- Open a new tab and navigate to
chrome://flags. - Search for "Prompt API for Gemini Nano" and set it to Enabled.
- Search for "Enables optimization guide on device" and set it to Enabled BypassPerfRequirement.
- Click Relaunch at the bottom of the page.
- After restart, open
chrome://components. - Find Optimization Guide On Device Model and click Check for update. The version should change from
0.0.0.0to something like2024.x.x.x. - Wait for the download to complete (can take 5–20 minutes depending on connection).
Once the component version is non-zero, open ClipAction's popup — the provider badge should show ● On-device.
Nano isn't downloading / version stays at 0.0.0.0
Common causes:
- Not enough free disk space. Chrome needs ~22 GB free on the drive Chrome is installed to. Clear space and click Check for update again.
- Metered connection. Chrome refuses to download large models over metered Wi-Fi. Disable metered mode in system settings or switch networks.
- Enterprise-managed Chrome. If Chrome is managed by your org, the admin may have disabled Nano. Check
chrome://policy. - Flag didn't stick. Re-open
chrome://flagsand confirm both flags still show Enabled. Relaunch once more if they reset. - Wait longer. The first download can take 15+ minutes. Leave Chrome open.
How do I know Nano is working?
Two quick checks:
- Open
chrome://on-device-internals(Chrome 128+) — it shows model status, download progress, and memory usage. - Open DevTools on any page, run
await ai.languageModel.availability(). If it returns"available", you're good.
Inside ClipAction, the popup shows a green On-device badge when Nano is ready. The extension also runs a quick capability probe on first use.
Nano keeps saying "unavailable" after setup
Try in order:
- Fully quit Chrome (not just the window — check the tray / menu bar) and reopen.
- Visit
chrome://components→ click Check for update on Optimization Guide On Device Model. - If the version is still
0.0.0.0, your machine may not meet the hardware bar. Fall back to a cloud provider (Pro) — Groq and Gemini 2.0 Flash are fast and cheap. - Open
chrome://on-device-internalsfor a detailed error. Share that with support if you're stuck.
Does Nano work offline?
Yes, after the initial model download. Once Nano is installed, you can run ClipAction actions with Wi-Fi off.
Cloud providers & API keys
Which cloud providers does ClipAction support?
Nine: OpenAI, Anthropic, Google Gemini, Groq, Mistral, xAI, Together, OpenRouter, and Ollama (local-network). Cloud providers require Pro and your own API key.
Where do I get an API key?
- OpenAI: platform.openai.com/api-keys
- Anthropic: console.anthropic.com/settings/keys
- Google Gemini: aistudio.google.com/apikey (free tier available)
- Groq: console.groq.com/keys (free tier available)
- Mistral: console.mistral.ai/api-keys
- xAI: console.x.ai
- Together: api.together.xyz/settings/api-keys
- OpenRouter: openrouter.ai/keys
- Ollama: No key — runs locally on
localhost:11434.
Where do I paste my API keys?
Open the ClipAction popup → click Settings in the footer → AI Providers tab. Expand the provider you want, paste the key, and hit Test. Pick your default via the Model Routing tab. See the Intelligence Center.
Are my keys ever sent to ClipAction's servers?
No. Keys are stored in Chrome's local encrypted storage (chrome.storage.local) on your device. They're used only to authenticate requests that go directly from your browser to the provider's API.
We don't run any servers that see your keys or your text.
Which provider should I use?
Rough guide:
- Free & fast: Gemini Nano (on-device) for anything short — rewrites, grammar fixes, summaries under ~500 words.
- Speed matters: Groq (Llama 3.3 70B) — often 300+ tokens/sec.
- Long context / nuance: Claude 3.5 Sonnet or GPT-4o.
- Cheap cloud: Gemini 2.0 Flash ($0.10/M in) or Mistral Small.
- Fully local with a bigger model: Ollama on your own machine.
How do I set up Ollama?
- Install Ollama.
- Pull a model, e.g.
ollama pull llama3.2
- Make sure Ollama is running on
localhost:11434. - In ClipAction → Settings → AI Providers, expand Ollama and pick the model you pulled.
- ClipAction will request host permission for
http://localhost:11434/*the first time — approve it.
Privacy & data
What data does ClipAction collect?
None. No analytics, no telemetry, no account, no user ID. See the full privacy policy.
Is my text used to train AI models?
By us: no — we never see your text.
By providers: depends on the provider. On-device Nano runs locally and trains nothing. Cloud APIs (OpenAI, Anthropic, etc.) have their own data policies — most don't train on API traffic by default, but verify with your provider's enterprise settings if you're handling sensitive content.
What's the difference between the green and red badges?
● On-device means the action ran via Gemini Nano or Ollama — your text stayed on your machine.
● Cloud means the action was sent to a remote provider's API. You'll see this any time you pick a cloud model.
Every result shows one of these two badges so you always know where your text went.
Can ClipAction read text on every page?
Only when you invoke it. The extension uses the activeTab permission — it has no access to a tab until you press the shortcut or click its icon on that tab. It does not observe your browsing, keystrokes, or clipboard.
Does ClipAction work on banking, healthcare, or corporate sites?
Technically yes, but treat it like any other AI tool: if your company has a policy against pasting data into third-party AI, stick to on-device Nano or Ollama — neither leaves your machine. Cloud providers see whatever text you send them.
Free vs Pro
What do I get on the free plan?
The core actions — rewrite, summarize, translate, explain, fix grammar, shorten, expand — all running on-device via Gemini Nano. No API keys, no cost, no account. The free tier is enough to decide whether ClipAction fits how you work.
What does Pro add?
- Cloud providers — bring your own API keys for OpenAI, Anthropic, Google, Groq, Mistral, xAI, Together, OpenRouter
- Ollama — connect a local Ollama server for bigger on-device models
- Custom Prompts — author your own actions with
{{selection}},{{language}},{{tone}},{{length}}variables - Site Profiles — per-domain action palettes (GitHub, Gmail, Slack, Linear, custom)
- Chains — run actions in sequence, feeding one result into the next
- Custom shortcuts — bind keyboard combos to individual actions
$5/month.
How do I upgrade?
From the ClipAction popup, click the Upgrade button at the top. If you've already paid on another machine, use Already Pro? Restore purchase just below it.
Is there a free trial for Pro?
No trial. The free plan already gives you the core actions running on-device — that's the best way to decide if ClipAction fits how you work before upgrading.
How do I cancel?
Cancellation is handled through the billing portal you used at checkout. Cancel there any time — your subscription stays active until the end of the current billing period, then the extension falls back to free-tier behaviour. If you can't find the link, email support and we'll sort it.
Shortcuts
What is the default shortcut?
Ctrl+Shift+Space on Windows/Linux, ⌘+Shift+Space on Mac.
How do I change the shortcut?
- Open
chrome://extensions/shortcuts. - Find ClipAction.
- Click the pencil icon next to Open ClipAction command palette.
- Press your preferred key combination, then click OK.
Chrome reserves some combinations (anything system-wide like Ctrl+T). If your chosen keys are taken, Chrome will show a conflict warning.
The shortcut doesn't do anything
Checks in order:
- Visit
chrome://extensions/shortcutsand confirm the shortcut is actually assigned. - Make sure you've selected some text on the page first — no selection, no palette.
- Reload the tab. The content script doesn't inject into tabs that were open before the extension was installed.
- Check
chrome://extensions→ ClipAction is Enabled and Allowed in incognito if you're in a private window. - Some sites (chrome.google.com, new-tab pages) block extension content scripts by design. Try a regular webpage.
Can I have different shortcuts for different actions?
Yes, with Pro. Under Settings → Shortcuts, each custom prompt can be bound to its own key combo — skip the palette entirely for your most-used transformations.
Troubleshooting
The palette opens but no actions run
Usually a provider problem. Open the popup — does the badge say On-device, Cloud, or No provider?
- On-device, still fails: Nano isn't ready. See the Nano setup section.
- Cloud, fails: Open Intelligence, click Test on your provider. You'll get a specific error (bad key, rate limit, network).
- No provider: Enable Nano or add an API key.
Result doesn't paste back into the page
Some surfaces are read-only — PDFs, some iframes, and sites with strict DOM sandboxing. In those cases the result is copied to your clipboard and shown in a panel; paste it manually with Ctrl+V.
On PDFs specifically, Chrome will ask for clipboard permission the first time — click Allow.
It works on some sites but not others
Known edge cases:
- Google Docs: uses a canvas editor — selection works, but replacement happens via clipboard paste.
- LinkedIn / Quill editors: the editor resets selection on focus; replacement may need a manual paste.
- Gmail subject line: works with replacement.
- Stack Overflow / textareas: full support.
- chrome://, Chrome Web Store pages: blocked by Chrome, can't inject.
If a site you care about misbehaves, email support with the URL.
Cloud action fails with "401 Unauthorized"
The API key is wrong, revoked, or missing credits. Open Settings → AI Providers, re-paste the key (check for trailing whitespace), and click Test.
Cloud action fails with "429" or "rate limit"
You're hitting the provider's rate limit. Wait a minute and retry, or switch to a different provider for heavy bursts.
Nothing happens when I click the extension icon
Try reloading the tab you want to use it on. The content script injects at document-idle — tabs opened before install won't have it until reload. If the popup won't open at all, disable and re-enable ClipAction at chrome://extensions.
How do I check my version and report a bug?
Open chrome://extensions → ClipAction → the version number is under the name. Email clipactionsupport@protonmail.com with the version, Chrome version (chrome://version), and steps to reproduce. Attach the browser console output (F12 → Console) if you can.
Custom actions & profiles
How do custom prompts work?
A custom prompt is a named instruction with an optional keyboard shortcut. Open Settings → Custom Prompts, write an instruction like "Rewrite this in my voice — dry, confident, short sentences: {{selection}}", pick a model, save. It shows up in the palette and runs on any selection. See the Action Builder.
What are site profiles?
A site profile scopes which actions appear in the palette based on the domain you're on. GitHub gets your PR-review and issue-summarize prompts; Gmail gets tone-softener and reply-drafter; neither sees the other's clutter. Match by exact domain, subdomain, or regex (e.g. ^https://(app|www)\.slack\.com). See the Site Profiles.
What are Chains?
Chains run two or more actions in sequence, feeding the output of one into the input of the next. Useful for things like "translate to English → summarize in 3 bullets" or "extract key points → draft reply". Configure them under Settings → Chains.
What template variables can I use in prompts?
Four built-in placeholders:
{{selection}}— the highlighted text (required in every prompt){{language}}— target language, when the action asks for one{{tone}}— tone directive (professional, casual, technical…){{length}}— length hint (short, medium, long)
Anything else in the prompt is just plain text.
Can I export / share my prompts?
Not yet — on the roadmap. For now they're stored per-browser. If you need to move them between machines, email support and we'll help.
Managing your data
Where is my data stored?
Locally, in Chrome's chrome.storage.local. That includes your API keys, custom actions, site profiles, and preferences. Nothing is synced to our servers.
How do I reset ClipAction?
To wipe all settings, keys, and prompts, right-click the ClipAction icon in the toolbar and Inspect popup. In the DevTools console that opens, run:
chrome.storage.local.clear().then(() => location.reload())
To re-trigger only the first-run onboarding (keep your keys), run:
chrome.storage.local.remove(['onboardingComplete','onboardingSkipped']).then(()=>location.reload())
How do I uninstall?
Right-click the ClipAction icon in the toolbar → Remove from Chrome. All local data is deleted with the extension.
I still have a question.
Email clipactionsupport@protonmail.com. Include your Chrome version, extension version, and what you were trying to do.