Installation and setup
How do I install PagePin?
In your WordPress admin go to Plugins, Add New, search for PagePin, then select Install Now and Activate. Or download the ZIP from WordPress.org and upload it under Plugins, Add New, Upload Plugin.
What are the system requirements?
WordPress 6.4 or later and PHP 8.1 or later. PagePin is tested up to WordPress 7.1 and runs in current browsers, also on tablets and phones.
What happens after activation?
PagePin opens its settings page with a short Next steps checklist: who receives Pinshot e-mails, which roles may give feedback, and a first try on your site. The defaults work as they are. Each user can hide the checklist; while it is not done, the dashboard links to it in the quick links.
Do I need an API key or an external account?
No. PagePin runs entirely in your WordPress installation. Only an optional CAPTCHA needs a key from its provider.
Pinshots
What is a Pinshot?
A screenshot of the page with numbered markers and notes. Press Ctrl+Alt+F (Cmd+Option+F on a Mac), place markers, add notes and send. PagePin saves the Pinshot in WordPress, and Send in the Pinshot list e-mails it to up to five recipients. Public feedback from visitors goes out right away.
Which marker types are there?
Three: Bug in red for problems, OK in green for approvals and Note in orange for comments. Keys 1, 2 and 3 switch between them; markers are numbered in the order you place them.
Can I move markers after placing them?
Yes. Drag a marker to move it. Ctrl+Z undoes and Ctrl+Y redoes a placement, on a Mac Cmd+Z and Cmd+Shift+Z; on touch devices you tap and drag.
How does e-mail delivery work?
You configure up to five recipients. The first receives the e-mail directly, the others in BCC. Each e-mail carries the screenshot as an attachment with page URL, browser with operating system, viewport size with pixel density and time.
Can I brand the screenshots?
Yes. Set your own watermark text on the settings page and choose a compression level between 10 and 100 percent.
Pinpoints and collaboration
What is a Pinpoint?
A comment thread attached to an element of the page, like a comment in a shared document. A thread finds its element again by CSS selector, XPath and text preview. If the element is gone, the thread is marked instead of being attached to the wrong place.
How do Pinpoints differ from Pinshots?
A Pinshot is a one-time screenshot for a quick bug report. A Pinpoint is a thread that stays on the page for an ongoing review. Both work side by side.
Can clients comment without a WordPress account?
Yes. Switch on guest access in the settings, then invite them by Magic Link e-mail or a shareable URL. Links do not expire by default, or after 7, 30 or 90 days, and a guest you invited once can be given access to more Pinpoints. Guests reply in their threads but cannot start new ones. Share links for a single thread are optional and off by default.
Can I mention people?
Yes. Type @ and a name to mention a team member or a guest. Mentioning a guest grants access if needed, and every participant of a thread is notified of new comments.
Can I organize Pinpoints?
Yes, with colored tags such as Bug, Design, Content or Urgent, or your own. A sidebar lists every Pinpoint with unread badges.
In the WordPress admin
What does the dashboard show?
Four key numbers: new Pinshots, open Pinpoints, Pinpoints resolved in the last 7 days and feedback items in total. Below them the latest Pinshots and Pinpoints, and quick links to the checklist while it is open, the lists and the settings.
How do I manage feedback?
Under PagePin, Pinshots and PagePin, Pinpoints. Filter by status, open the screenshot, change the status and use bulk actions. Each post and page shows its Pinpoints in a metabox, and the admin bar shows a counter.
Where are screenshots stored?
In /wp-content/uploads/pagepin/ on your server, not in the media library. Deleting a report deletes its screenshot.
What is the status workflow?
New when submitted, Sent when the e-mail went out and Resolved when the issue is done. You change the status by hand or for many entries at once.
Does PagePin have webhooks?
Yes. Under PagePin, Settings, Webhooks you add up to 10 HTTPS endpoints, each with its own events, signing secret and a choice between JSON and Slack compatible text, plus a test button, retries and a log of the last 50 deliveries. To check a request, build v1, plus the Base64 HMAC-SHA256 of webhook-id, webhook-timestamp and the body, joined by dots and keyed with the decoded secret, and compare it with the webhook-signature header using hash_equals(). Reject timestamps older than five minutes.
Roles and permissions
Who can use PagePin?
By default only administrators send Pinshots. For Pinpoints, administrators and editors may create and resolve threads, and authors may view them. Change the roles on the settings page.
Who can create, view and resolve Pinpoints?
Each of the three rights is assigned to WordPress roles separately.
Spam protection
Can visitors send feedback without logging in?
Yes, when you enable public feedback. By default PagePin asks for an e-mail address for follow-up questions; you can make it optional. Several protections keep spam out.
Which spam protection is included?
A honeypot field, a timing check against instant submissions and a limit of submissions per hour and IP address, 10 by default. Optional CAPTCHA: Google reCAPTCHA v2 or v3, hCaptcha or Cloudflare Turnstile.
Privacy
Does PagePin send data to other services?
Only what you set up yourself. With a CAPTCHA the visitor interaction goes to the provider you chose. Webhooks go only to the HTTPS addresses you enter, with e-mail addresses only if you allow it per endpoint. Without either PagePin makes no external connection, and avatars are local initials, not Gravatar.
Which data does PagePin store?
For feedback: the screenshot with markers and messages, page URL, browser with operating system, viewport size, pixel density and time, plus the user ID of logged-in users or, for public feedback, the e-mail address if given and a session token. For guests: name, e-mail address if given, access token, the threads they may see and the last access.
Does PagePin store IP addresses?
No, not with the feedback. For the rate limit of public feedback PagePin keeps a keyed hash of the IP address in a transient for at most one hour.
What happens when I uninstall PagePin?
Deleting the plugin removes its database tables, its options including webhook endpoints and the delivery log, its transients and the screenshot folder /wp-content/uploads/pagepin/. Deactivating keeps your data.
Keyboard and compatibility
Which keyboard shortcuts are there?
Ctrl+Alt+F opens the toolbar, on a Mac Cmd+Option+F or Ctrl+Option+F. Keys 1, 2 and 3 pick the marker, Ctrl+Z and Ctrl+Y undo and redo, on a Mac Cmd+Z and Cmd+Shift+Z. A floating feedback button is available as well.
Can I use PagePin with the keyboard alone?
Yes. Dialogs open and close with the keyboard, Esc closes them, the focus stays inside and returns to the button that opened them. Markers react to Enter and Space, and contrast and focus rings follow WCAG 2.2 AA.
Does PagePin work with page builders?
Yes. The tools work on the rendered page, whichever builder made it, for example Elementor, Divi, Beaver Builder or WPBakery. Embedded videos, maps and iframes appear as placeholders in screenshots.
Does PagePin work on phones and tablets?
Yes. Tap to place a marker and drag to move it; the interface adapts to the screen size.
Which languages are included?
English and German. PagePin is translation-ready for every other language through the usual WordPress tools.
Still have questions?
Ask in the PagePin support forum on WordPress.org, try PagePin in the live demo or write to service@pagepin.io.
