# Install the widget
Add the feedback launcher to any page — a script tag, the React component, or `npx iterateto init`.
## Quickstart
Add one script tag to any page. It can go in `` or at the end of `` — it does not matter, because the loader is tiny and async and pulls the widget UI on demand. The widget renders in a shadow root, so your page styles are never affected.
```html
```
Replace `pk_...` with your project's public key from [the dashboard](/dashboard/projects). A launcher pill appears in the corner; that is the whole install.
## Install with the CLI
`npx iterateto init` detects your framework, writes the embed in the right place, and wires env for you. Pass `--key` to skip the prompt, and `--yes` for non-interactive use (CI, or an AI agent running it for you).
```bash
npx iterateto init --key pk_... --yes
```
Want to see what it will do first? Run `iterateto info --json` to print the detected framework and current install state, or run `init` without `--yes` to review each change before it is written.
## React / Next.js component
`@iterateto/react` wraps the loader as a component. Install it, then mount it once near the root of your app.
```bash
npm install @iterateto/react
```
```tsx
import { IterateTo } from "@iterateto/react";
export default function RootLayout({
children,
}: {
children: React.ReactNode;
}) {
return (
{children}
);
}
```
In a plain Next.js app without the package, use `next/script` with `strategy="afterInteractive"` in your root layout's `` and pass `data-key` as a prop. Avoid `worker` (Partytown) and `type="module"` — use the config object below for those.
## Runtime API
The widget exposes a global `iterateTo` function: `iterateTo("open" | "close")`, `iterateTo("identify", { ... })`, and `iterateTo("metadata", { ... })`. Use `identify` to attach who is reporting and `metadata` for app state (both take a flat object, max 20 keys).
Because the loader is async, `window.iterateTo` does not exist until it runs. Install the one-line queue stub **before** the script tag so calls made early are buffered and replayed once the widget is ready.
```html
```
## Configuration attributes
- `data-key` (required) — your project's public key (starts with `pk_`). Safe to embed publicly.
- `data-position` (optional) — `bottom-right` (default) or `bottom-left`. Overrides the position set in project settings.
See [Widget configuration](/docs/widget) for the full set of settings and targeting attributes.
## Frameworks & tag managers
The plain `
```