Adopt

5 surfaces

Surfaces

Integrations

Strategy & Discovery

2
VistalyProductboard

Research & Insights

1
Dovetail

Knowledge & Docs

1
Notion

Design

1
Figma

Analytics

1
PostHog
Research & InsightsBeta

Coming from Dovetail

70% entity overlap

Import

Your research lives in Dovetail; UPG connects those insights to strategy, hypotheses, and execution.

The structural finding

Dovetail solves one domain (research) with depth. UPG's research domain maps almost exactly: Project → research_study, Note → observation, Highlight → quote, Theme → affinity_cluster, Doc → insight. The gap is what happens after the insight: the insight_informs_opportunity bridge that connects research to product decisions.

What UPG adds

1

Cross-domain connectivity: research insights connect to the opportunities they surface, the hypotheses they validate, and the features that result.

2

Evidence chains: every insight becomes a typed node with traceable relationships, not a tagged paragraph in a research repository.

3

AI-queryable context: an agent can ask "which pain points have been validated by research?" and traverse the answer in one call.

Schema mapping

Direct matches
Project→research_study
Note / Transcript→observation
Highlight→quote
Theme→affinity_cluster
Tag→affinity_clusterFlat tags map to cluster labels
Doc (insight)→insight
Participant→participant
Maps with caveats
Insight (in project)→insightinsight_surfaces_opportunity edge must be added manually
What UPG adds
opportunityhypothesisfeatureoutcomepersonaexperiment
Skipped:Sharing links · Team settings · Integration configs

The key edge

The single most important semantic relationship this integration enables.

insight_informs_opportunity

Defined in the UPG specification

Sample import

A typical research project: transcripts → highlights → themes → insight

Input (from Dovetail)
Output (UPG nodes)
Project
Q2 Onboarding Study
→
research_study
Q2 Onboarding Study
Highlight
I had no idea what to do next after signing up
→
quote
I had no idea what to do next after signing up
↳ research_study_captures_observation
Theme
Confusion
→
affinity_cluster
Confusion
↳ affinity_cluster_synthesises_insight
Doc (Insight)
Users lack orientation cues in the first session
→
insight
Users lack orientation cues in the first session
↳ insight_informs_opportunity

Roundtrip

API ROUNDTRIPPlanned
Dovetail ──import──▶ UPG ──enrich──▶ UPG ──push via REST──▶ Dovetail

Import research insights → link to opportunities in UPG → push opportunity links back to Dovetail for closed-loop research traceability.

Writes back
  • ·UPG opportunity nodes linked back to Dovetail insights that surfaced them
  • ·Feature delivery status written back to related Dovetail projects

How to import your Dovetail data

Via the CLI (coming soon)

The Dovetail adapter is built and tested. A one-command import via the UPG CLI is in development:

npx unified-product-graph import --from dovetail

This will fetch your Dovetail data, map entity types automatically, and write everything to your graph. Today you can use the Markdown import or the adapter directly in code.

▸ For developers: use the adapter directly
import { DovetailAdapter } from '@unified-product-graph/adapters'
// Pass pre-fetched Dovetail data as SourceItem[]
const adapter = new DovetailAdapter()
const result = await adapter.convert(items)
// result.nodes → typed UPG entities
// result.edges → canonical relationships
// result.warnings → items needing review

Get started

The Dovetail adapter ships in @unified-product-graph/adapters. Install it, then run the import command.

# one-time install
$ npm install -g unified-product-graph

# then import
$ upg import --from notion

Other tools in Research & Insights

← All integrations