Installation
Pinpourri is a Chrome Extension available on the Chrome Web Store. Click Add to Chrome, confirm the permissions, and the extension icon will appear in your toolbar.
Pin it to your toolbar for quick access: click the puzzle icon in Chrome's toolbar, find Pinpourri, and click the pin icon next to it.
activeTab, storage, contextMenus, and sidePanel. It does not read page content or send your browsing history anywhere.
Your first project
Before you can pin notes, you need a project. A project groups notes by site or scope.
- Click the Pinpourri icon in your toolbar to open the side panel.
- Click New Project.
- Choose For a specific site — Pinpourri will pre-fill the domain from your current tab — or choose Anywhere to pin on any page.
- Give the project a name and click Create.
The project appears in your list with its overlay automatically enabled on matching pages.
Adding your first pin
Navigate to a page that matches your project's domain. You'll see a small hint at the bottom of the side panel:
Hold Ctrl (or ⌘ Cmd on Mac) and click anywhere on the page. A popover appears — type your note and click Save. A numbered pin marks the spot.
Creating projects
Each project has a name and a domain. The domain controls which pages the project's pins are visible on.
When you create a project while on a page, the domain is pre-filled from the current URL. You can edit it to be more specific or broader.
Domain formats
| Domain | Matches |
|---|---|
example.com | example.com and www.example.com (all paths) |
example.com/blog | example.com/blog and all sub-paths |
*.example.com | All subdomains (app.example.com, docs.example.com) — not the root |
localhost:3000 | Local dev server on port 3000 |
* | Any page on any domain |
https:// in the domain field — just the hostname (and optional path).
Domain matching
Pinpourri shows the overlay for the first matching project that has its overlay enabled. If you have multiple projects that could match a page (e.g. example.com and *), the one higher in your list takes priority.
Reorder projects by dragging the ⠿ handle on the left side of each project card. The order is saved and applied immediately — no page refresh needed.
Wildcard projects
A project with domain * matches every page. In the notes list, note groups show the full URL (hostname + path) instead of just the path, so you can tell which site each note belongs to.
Managing projects
Overlay toggle
Each project card has a toggle to enable or disable its overlay. Disabling the overlay hides all pins on matching pages without deleting any notes.
Deleting a project
Open a project and click Delete Project. You'll be asked to confirm. Deletion removes the project and all its notes permanently.
Collaborator projects
If you've been invited to a project by someone else, it appears in your list with a Guest badge. You can leave a shared project via the project detail view.
Adding a note
With a project's overlay enabled on the current page:
- Hold Ctrl (or your configured modifier) and click any element on the page.
- Type your note in the popover that appears.
- Click Save.
The pin is anchored to the element you clicked and positioned relative to it. If the element moves (e.g. after a layout change), the pin follows.
Right-click to pin
You can also right-click any element and choose Add Pinpourri note here from the context menu.
Editing a note
Click a pin on the page to reopen its popover, then edit the text and save.
Resolving notes
Once feedback is addressed, mark a note as resolved. In the side panel, click the checkmark icon next to a note. Resolved notes are shown faded with strikethrough text.
To filter them out, toggle Hide Resolved at the top of the notes list. Resolved notes remain saved and can be unresolved at any time by clicking the checkmark again.
Auto-hide resolved
In Settings → Behavior, enable Auto-hide resolved to have new projects start with resolved notes hidden by default.
Deleting a note
In the side panel, click the × icon next to a note. Click it a second time to confirm deletion. Deleted notes cannot be recovered.
Appearance
Open the settings panel by clicking the gear icon in the bottom-right corner of the side panel.
Accent color
Choose from 7 preset colors for your pins and UI accents. The selected color applies to all projects.
Pin size
Three sizes: Small, Medium (default), and Large. Larger pins are easier to click on dense pages.
Pin labels
Toggle numbered labels on pins on or off. With labels on, each pin shows its number (1, 2, 3…) so you can cross-reference with the notes list.
Animated pins
Adds a subtle radiant glow animation to pins, making them easier to spot on busy pages.
Contrast mode
Adds a dark layer directly under each pin. Useful on light backgrounds where pins might blend in.
Behavior
Add note shortcut
Choose the modifier key used to add a note by clicking:
- Ctrl / ⌘ Cmd (default) — Hold Ctrl on Windows/Linux, or ⌘ Cmd on Mac, then click.
- Alt — Hold Alt then click. Useful if Ctrl+Click is already taken by another tool.
Auto-hide resolved
When enabled, any new project you create will have resolved notes hidden by default. Existing projects are not affected.
Cloud sync
Pro users' notes and projects are stored in the cloud and synced across all your devices. Sign in on any machine and your projects are there instantly.
The side panel refreshes automatically every 30 seconds and on window focus, so you'll see updates from other devices or the web dashboard without reloading.
Upgrading from Free
When you upgrade, your existing local notes are automatically migrated to the cloud. You'll see a "Syncing to cloud…" message while this happens. Your local data is preserved throughout.
Collaboration
As a Pro project owner, you can invite collaborators by email. They don't need a Pro account — only the project owner does.
Inviting someone
- Open the project in the side panel.
- Click Invite to expand the members panel.
- Enter their email address and press Enter or click Invite.
If they already have a Pinpourri account, they'll see the project immediately. If not, the invitation is pending — it activates automatically when they register with that email.
Removing a collaborator
Click the × button next to their name in the members list. They'll lose access to the project immediately.
Permissions
| Action | Owner | Collaborator |
|---|---|---|
| Add notes | ✓ | ✓ |
| Edit own notes | ✓ | ✓ |
| Delete own notes | ✓ | ✓ |
| Resolve / reopen any note | ✓ | ✓ |
| Edit others' notes | ✓ | – |
| Delete others' notes | ✓ | – |
| Invite collaborators | ✓ | – |
| Remove collaborators | ✓ | – |
| Delete project | ✓ | – |