Chrome extension
The TrueRoyalties Connector links your platforms by capturing the one session our servers then read from — only Draft2Digital is still read from your browser.
What it is
TrueRoyalties Connector is the small browser extension that connects your platforms. None of them — KDP, Kobo Writing Life, Draft2Digital or the retailers joining them — have a public API, so it is the only way in. For every one of them the goal is the same: capture a one-time session that our own servers then read from, on their own schedule, with no browser needed afterward. KDP and Kobo already work that way, and every newly connectable retailer captures its session up front for the same reason. Draft2Digital is the one exception today — its reading has not moved server-side yet, so the extension keeps reading its reports from your browser, once a day.
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
- Connects Amazon KDP and Kobo Writing Life with a one-time sign-in — after that, TrueRoyalties reads them directly from its own servers, on their own schedule, whether or not your browser is open. See Sync and data freshness.
- Captures the same kind of one-time session for any other connectable retailer you connect early — Barnes & Noble Press, ACX and the rest — so each one is ready to be read server-side the day we start reading it. See Platforms you can connect early.
- Reads your Draft2Digital reports once a day, as long as Chrome is running and you stay signed in to draft2digital.com — the one platform still waiting to move server-side.
- Sends everything to your TrueRoyalties account and 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 or refund, if you turn that on — detected on our servers, shown by your browser.
- 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 password. Connecting KDP or Kobo opens Amazon's or Kobo's own sign-in page — you type your password there, not into the extension, and neither the extension nor TrueRoyalties ever sees it.
- It never writes anything to any platform — no price change, no campaign edit.
By default it runs on Amazon (KDP and storefronts), Kobo Writing Life, Draft2Digital and TrueRoyalties. Its permission list is deliberately short: storage, alarms, notifications, and the request headers it needs.
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, with quick links to the app and to Platforms, plus the switches for new-sale and new-review notifications.
Inside the app, Platforms shows the sync status of every platform, 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 |
| A platform shows "Reconnect needed" | The captured session ended — open Platforms and connect it again |
| Draft2Digital stops updating | Sign back in to draft2digital.com in your browser; the daily pass needs a live session there |
| 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.