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.

AI user interviewer — see how observed behavior informs a planned debrief.
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 Studies become Interviews, Evidence, reviewed Findings, 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.

Pricing page research — investigate plan comprehension with a focused task and debrief.
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.
How to Identify User Needs — Investigate the situation, expected outcome, and workaround behind a feature request.

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 UserTold research and delivery workflows.
CLI Reference — Run the focused Study-to-Finding workflow and discover the current CLI contract.

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

From User Interviews to Linear and GitHub Issues — Send reviewed, source-linked Findings to Linear product intake or GitHub delivery 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.
How to Analyze User Interviews — Review sources, group related moments, and check counter-evidence before writing a Finding.

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.