[Canonical HTML](https://grabcaramel.com/docs)

# Caramel documentation

Everything about the free, open\-source Caramel coupon extension in one place: how to install it, how it finds and tests codes, what it does with your data, how to reach a human, and the machine\-readable resources for AI agents\.

## What Caramel is

Caramel is a free, open\-source, privacy\-first browser extension that finds and applies coupon codes automatically at checkout\. It does not sell browsing data and does not overwrite creators’ affiliate commissions\.

It is free to use, with no paid tier and no account required to install\. It is open source under the AGPL\-3\.0 license, built and maintained by Devino Solutions together with community contributors\.

- [Source code on GitHub](https://github.com/DevinoSolutions/caramel)
- [Pricing](https://grabcaramel.com/pricing): the plan structure: Caramel is free
- [FAQ](https://grabcaramel.com/faq): the questions shoppers actually ask, answered

## Install

Caramel is available for Chrome, Firefox, Microsoft Edge and Safari\. Pick the store listing for your browser; no account is needed to install\.

The Safari version ships through the App Store for Mac and for iPhone and iPad, and it is free there like every other version\.

- [Chrome](https://chromewebstore.google.com/detail/caramel-trusted-honey-alt/gaimofgglbackoimfjopicmbmnlccfoe): Chrome Web Store
- [Firefox](https://addons.mozilla.org/en-US/firefox/addon/grabcaramel/): Firefox Add\-ons
- [Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/caramel/leodahchedhnenmiengkfpmmcdendnof): Microsoft Edge Add\-ons
- [Safari](https://apps.apple.com/ke/app/caramel/id6741873881): App Store
- [All download options](https://grabcaramel.com/apps): the official store badges and what the installed extension does on each browser

## How codes are found and tested

Caramel works in four steps while you shop:

1. You shop normally; Caramel detects a supported store’s checkout page\.
2. It looks up known coupon codes for that store from its own catalog\.
3. It tries the codes at checkout and keeps the one with the best discount\.
4. It reports whether a code worked so the catalog’s rankings stay accurate\.

- [Sources](https://grabcaramel.com/sources): where Caramel’s coupon codes come from, and where to request a new source
- [Coupons](https://grabcaramel.com/coupons): browse the full coupon catalog

## Supported stores

Caramel’s catalog holds over 100,000 coupon codes across more than 4,000 online stores, and it is refreshed continuously as new codes are found and dead ones are retired\.

You can search the supported stores, browse them A to Z, or open a store’s own page \(for example /coupons/amazon\.com\) to see its codes\.

- [Supported stores](https://grabcaramel.com/supported-stores): search the stores and see the ones added most recently
- [Store directory A–Z](https://grabcaramel.com/coupons/stores): every store with live codes, by first letter

## Using Caramel with an AI agent

Paste one sentence into Claude Code, Codex, Cursor, OpenCode or GitHub Copilot and it installs the Caramel coupon skill and verifies the public coupon API\. No API key and no account are needed\.

The coupon API is public, unauthenticated, read\-only JSON: query it with ?site=<domain> or ?search=<text>, and resolve store domains with /api/coupons/stores?q=<prefix>\. There is no Caramel MCP server or SDK; the browser extension itself is for you to install\.

- [Agent setup](https://grabcaramel.com/agent-setup): the sentence to paste, and a guide for each supported agent
- [Agent setup instructions \(Markdown\)](https://grabcaramel.com/agent-setup/prompt.md): the machine\-readable instructions an agent follows
- [Coupon API](https://grabcaramel.com/api/coupons): public, read\-only JSON

## Privacy and data

Caramel never sells personal information and shares it only with the service providers named in its privacy policy, and ships no ads and no third\-party trackers\.

The extension talks only to Caramel’s own servers: at checkout on a supported store it fetches coupon codes for that store’s domain, sends page and cart context \(page title and item names, never payment details\) so the right category of codes is chosen, and reports whether a code worked\. Settings and the optional sign\-in are kept in the browser’s extension storage\.

Sharing a code you typed at checkout is off by default and happens only if you agree\.

- [Privacy policy](https://grabcaramel.com/privacy): what data Caramel does and does not collect

## Support

Report a problem, request a feature, or ask a question on the support page\. Tick “I’d like a reply” and a human replies within 1 business day\.

Security reports use the same support page; /\.well\-known/security\.txt points there\.

- [Contact support](https://grabcaramel.com/support)
- [Discord community](https://discord.gg/2vVVrQ5CEB): ask other shoppers and follow updates; for anything about your account, use the support form

## Machine\-readable resources

Public pages with a Markdown alternate have a \.md twin \(this page: /docs\.md; the home page: /index\.md\)\. Request a page with Accept: text/markdown to read the same content as Markdown\.

- [llms\.txt](https://grabcaramel.com/llms.txt): the short index of what Caramel is and where to look
- [llms\-full\.txt](https://grabcaramel.com/llms-full.txt): the same facts plus the FAQ questions and answers and a privacy summary, in one document
- [Markdown twin of this page](https://grabcaramel.com/docs.md)
- [security\.txt](https://grabcaramel.com/.well-known/security.txt): how to report a security problem
- [sitemap\.xml](https://grabcaramel.com/sitemap.xml)