Chrome extension
The TrueRoyalties Connector reads your KDP reports from your own browser. What it installs, what it can see, and what it cannot.
What it is
TrueRoyalties Connector is the small browser extension that fetches your KDP reports. It is required: KDP has no public API, so there is no other way to read your royalties.
Install it from the Chrome Web Store. It works on Chrome, Edge, Brave and Arc. Other browsers are not supported yet.
On Edge, the Chrome Web Store first asks you to allow extensions from other stores — accept, then add the extension.
What it does
- Reads your KDP royalty, order and KENP reports, using the KDP session already open in your browser.
- Sends them to your TrueRoyalties account.
- Copies your book covers so the app can display them.
- Reads your Amazon customer reviews (see Reviews).
- Shows a browser notification on a new sale, if you turn that on.
- Checks a page you named for your verification token, when our servers cannot read it (see Your verified page).
What it cannot do
- It never sees your Amazon password. It uses a session you opened yourself.
- It never writes anything to Amazon — no price change, no campaign edit.
By default it runs only on kdpreports.amazon.com, Amazon storefronts and
TrueRoyalties. Its permission list is deliberately short: storage, alarms,
notifications, and the request headers it needs to talk to KDP.
One optional extra. Verifying a link on a site built with JavaScript (Wix, Squarespace, X, Instagram, TikTok) means opening that page in your browser, which needs a broader "read pages you visit" permission. It is asked once, only when you add such a link, and you press Allow yourself. Decline it and everything else works exactly the same. See Privacy.
Checking it is connected
Click the extension icon. The popup shows whether it is connected to your account and when it last synced.
Inside the app, Platforms shows the same status, plus a Sync now button.
Keeping it working
| Symptom | Fix |
|---|---|
| "Extension not detected" on a page that was already open | Reload the tab — Chrome does not inject the extension into tabs opened before install |
| Import stops after a while | Sign back in to KDP; the session expired |
| Nothing syncs at all | Check the extension is enabled in chrome://extensions |
More in Troubleshooting.
Updates
Chrome updates the extension on its own. You never need to reinstall it.