Documentation

Choose the job you want to complete. Each link goes directly to the focused guide or reference.

Start

Take the shortest path from account setup to a live study.

Learn the product model, research principles, and shared vocabulary.

How it works — see the product loop at a glance.
For agents — understand the agent-facing integration surfaces.
Glossary — Look up the shared vocabulary used across interviews, evidence, and delivery.
Core Concepts — Understand how interviews become evidence, reviewed work, and delivery.
Methodology — Apply the evidence-first research principles behind UserTold interviews.
Agentic User Research — See how research supplies trustworthy input to an agentic delivery loop.

Design studies that capture useful participant evidence.

Studies — Create, activate, pause, and operate studies.
Study Runtime — Understand talk, observe, and scripted speak segments at runtime.
Study Design Guide — Turn a research goal into a valid, focused study script.
In-Product User Interviews: When They Fit — Choose in-product interviews when a real workflow and immediate debrief answer the product question.
Research Script Templates — Adapt practical scripts for common product research questions.
Find Why Users Get Stuck Before They Leave — Connect unexplained onboarding or activation drop-off to observed behavior and a focused debrief.
Learn Why Users Switch — Design interviews that uncover switching decisions and tradeoffs.

Connect the widget, API, CLI, or MCP to your product and agents.

OpenAPI schema — inspect the generated endpoint contract.
Agent authentication protocol — register, claim, and use agent credentials.
Widget Integration — Embed the interview widget and configure its runtime behavior.
API Reference — Use the stable REST contract, errors, retries, and webhook workflows.
MCP Integration — Connect an MCP client to 19 research tools and two bounded bootstrap resources.
CLI Reference — Automate auth, project setup, studies, and evidence workflows.

Verify source evidence, decide what should become work, and keep delivery connected.

From User Interviews to Linear and GitHub Issues — Move reviewed, source-linked Work into Linear or GitHub without losing user context.
Track Resolved Evidence — Keep shipped work connected to resolved evidence and recurrence review.
Turn Feedback Into Work Worth Building — Turn feature requests and Evidence into reviewed product problems before delivery.

Understand consent, security, data handling, and product changes.

Security — review the product security posture.
Privacy — see what data UserTold processes and why.
Terms — read the service terms.
Data Processing Agreement — review controller and processor responsibilities.
Changelog — see builder-facing shipped updates.
Participant Consent — Design a clear consent experience before recording begins.