Install pinthread.
Sign up, create a project, and paste one script tag. There is nothing to install or host.
01 · Create your account
Sign up with Google. Your account starts on the Free plan at $0. No credit card.
02 · Create a project
In the dashboard, create a project for your site. Its Install tab shows the script tag with your project key filled in. Under Settings, add each address where your site runs, such as your preview domain. pinthread loads only on approved sites.
The project key is public, not a password. It only tells the widget which project to load.
03 · Paste the script tag
Add the tag to your site’s shared layout. Choose your setup:
<script src="https://pinthread.dev/embed.js"
data-project="YOUR_PROJECT_KEY" defer></script>Paste it before </body> in every page you want reviewed, or in your shared layout.
import Script from 'next/script';
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
{children}
<Script src="https://pinthread.dev/embed.js"
data-project="YOUR_PROJECT_KEY" />
</body>
</html>
);
}Add it to app/layout.tsx so it loads on every route.
<script is:inline src="https://pinthread.dev/embed.js"
data-project="YOUR_PROJECT_KEY" defer></script>Add it to your base layout, before </body>. is:inline keeps Astro from bundling it.
Use the pinthread plugin. Install and activate it, open Settings > pinthread, paste your project key, and choose who sees the widget: administrators only, or everyone. The plugin loads the widget in the footer without editing your theme, and deleting it removes its settings.
Without the plugin, paste the tag into the footer code setting of your theme or page builder.
Webflow, Framer, and Squarespace each have a custom code setting for the page footer. Paste the tag there and publish.
Guides for your framework
Each guide shows the exact file, a check that it works, and fixes for common problems.
- Expo webBrowser feedback for Expo. Native views are not supported.
- Next.jsnext/script in the App Router or Pages Router.
- ViteReact, Vue, or Svelte: one tag in index.html.
- AstroAn inline script in your base layout.
- SvelteKitOne tag in src/app.html.
- NuxtA head script in nuxt.config.ts.
- AngularOne tag in src/index.html.
- HTMLStatic sites, site generators, and templates.
Local development
A widget on localhost uses branch local unless you set data-branch. MCP tools default to shared. Ask your agent to call list_threads({ branch: "local" }) and get_thread({ thread_id: "THREAD_ID", branch: "local" }) for these comments. status: "all" includes all statuses in one branch, not all branches.
Or ask your coding agent
Paste this prompt into Claude Code, Codex, Cursor, or another agent with access to your repository.
Add pinthread to this website. Put this script tag in the root layout, before </body>, so it loads on every page in development and preview builds:
<script src="https://pinthread.dev/embed.js"
data-project="YOUR_PROJECT_KEY" defer></script>
Replace YOUR_PROJECT_KEY with my project key from https://pinthread.dev/dashboard/. Docs: https://pinthread.dev/install/Then follow the agent workflow guide to let it work through your comments.
04 · Leave the first comment
Open your site. The Install tab changes from waiting to installed when the tag first loads. Click the pinthread button, sign in with Google, and pin a comment to any element.
Review without activating the page
Element picking intercepts presses before the page's document-level capture handlers. Disabled buttons and delegated table rows remain selectable without activation. Native modal dialogs and popovers keep the widget inside their input boundary. Leaving comment mode restores ordinary page input.
A host listener registered earlier on window in the capture phase still receives events first. It must ignore events from the pinthread host, matched by the selector [data-branch-comments]. The browser fixes that ordering.
05 · Invite your team
Open the project’s Members tab and create an invitation for each teammate’s email address. Copy the link and send it to them. Reviewers can also join as a named guest on projects with link access.
Project settings