Browser extension overview

Install Pointerly Connect, authorize a team and Amazon tag, and create links from product pages.

draft

Pointerly Connect is the browser extension that creates affiliate and tracked short links on Amazon, eBay, and Walmart product pages, imports Shop lists and earnings reports, syncs Creator Connections campaigns, and can generate AI copy using your team credits.

Manage install and connection status under Dashboard → Settings → Extension (feature-gated as Browser Extension).

What you'll do

Install for Chrome or Safari
Connect with a team that has extension:connect permission and an Amazon tag
Use product-page actions and keep the extension updated

Before you start

Correct Pointerly account signed in
Plan includes the browser extension feature
At least one Amazon affiliate tag on a team you can connect
Owner/admin (or a member granted Browser Extension & CLI) on that team

Image placeholder — add `images/cover.png` under this category

Browser Extension settings with status and install CTA

Install

Chrome

Open Dashboard → Settings → Extension.
If status is not installed, click Install Extension (Chrome Web Store).
Pin the extension and allow it on Pointerly hub origins if prompted.

Safari (Mac)

Install from the Mac App Store when the listing is available.
Enable the extension in Safari → Settings → Extensions.
Allow it for your Pointerly site (Safari uses a page bridge instead of Chrome’s externally_connectable ID).

Image placeholder — add `images/step-01.png` under this category

Extension not detected alert with Install Extension button

Connect

After install, the status card shows Extension installed and the version.
If you have no Amazon tag, add one under team / affiliate tags first—the Connect button stays blocked.
Click Connect Extension. You are redirected to /extension-auth with a one-time nonce.
On Authorize Extension:
- Confirm the permissions (create affiliate links, tracked short links, sync Creator Connections, generate AI content).
- Select Team and Affiliate tag (own Amazon tags only).
- Click authorize; Pointerly issues a scoped API key to the extension (not your session password).
Return to Settings → Extension; status should read Connected.

Disconnect anytime with Disconnect (sends logout to the extension).

Image placeholder — add `images/step-02.png` under this category

Authorize Extension page with team and affiliate tag selectors

What you can do when connected

Capability	Notes
Create affiliate links	Amazon, eBay, Walmart product pages with your configured tags
Create tracked short links	Analytics-backed Pointerly short URLs
Amazon Shop list import	On `amazon.com/shop/.../list/...`, import products into a link group; ASIN duplicates skipped
Link groups	Assign imports/creates to existing or new groups
Import earnings reports	On Associates reporting pages, import XLSX into Pointerly
Sync Creator Connections	Pull campaigns into Creator Connections (plan feature)
Generate AI content	Uses team AI credits (plan feature)

Image placeholder — add `images/step-03.png` under this category

Connected status and Features checklist

Tips

Re-authorize if you switch the default Amazon tag or team.
If an outdated-version alert appears, update via chrome://extensions → Update, or the App Store on Safari.
Creator Connections sync needs an Associates login in the same browser profile.
Keep Pointerly open on an allowed origin so the hub can ping the extension (Chrome ID / Safari bridge).

Troubleshooting

Symptom	Likely cause	What to try
Not detected	Not installed, disabled, or site not allowed	Reinstall; enable for this site; hard-refresh Settings
Connect blocked for missing tag	No Amazon tag on the team	Create an Amazon affiliate tag
“no team where you can connect”	Missing `extension:connect`	Ask an owner/admin for Browser Extension & CLI permission
Auth page: extension not detected	Popup blocked / wrong profile	Open auth from the extension; retry; check Safari allow-list
Version warning	Below minimum supported version	Update the extension from the store
Misconfiguration error (Chrome)	Missing extension ID env on self-hosted	Set `NEXT_PUBLIC_POINTERLY_EXTENSION_ID` (Safari builds do not need it)