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 Maze

40% entity overlap

Import

Usability tests become research_study nodes, with the prototype_tests_hypothesis edge unique to Maze in the series.

The structural finding

Maze is the only tool in the series with an explicit prototype→hypothesis relationship. A Maze study tests a prototype against a hypothesis, and UPG has a canonical edge for exactly that: prototype_tests_hypothesis. This makes Maze uniquely integrated with UPG's validation domain.

What UPG adds

1

Validation chains: Maze studies connected to the hypotheses they tested and the insights they produced.

2

Design evidence: prototypes linked to the features they validated and the opportunities they addressed.

3

Research synthesis: Maze insights bridged to Dovetail themes and Vistaly opportunity nodes.

Schema mapping

Direct matches
Maze (Study)→research_study
Tester→participant
Clip (with transcript)→quote
Block (task type)→test_plan
Block Response (task)→observation
Block Response (question)→survey_response
Maps with caveats
Prototype URL in Block→prototypeFigma URL → prototype node + prototype_tests_hypothesis edge
Metric (completion_rate)→metricAggregate stats flow into metric.current_value
What UPG adds
hypothesisinsightlearningopportunitypersona
Skipped:Heatmap (visualisation layer) · Panel recruitment · Block ordering logic

The key edge

The single most important semantic relationship this integration enables.

prototype_tests_hypothesis

Defined in the UPG specification

Sample import

Maze usability test: Study → Tasks → Participants → Clips

Input (from Maze)
Output (UPG nodes)
Maze (Study)
Onboarding Flow Usability Test
type: usability, responses: 24
→
research_study
Onboarding Flow Usability Test
Block (task)
Complete workspace setup in under 3 minutes
→
test_plan
Complete workspace setup in under 3 minutes
↳ research_study_captures_observation
Clip
P12: Success path recording
completion_rate: 58%
→
quote
P12: Success path recording
↳ observation_evidenced_by_quote
Prototype URL in Block
https://figma.com/file/abc/Onboarding-v3
→
prototype
Onboarding-v3
↳ prototype_tests_hypothesis

Roundtrip

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

Import usability studies → connect to UPG hypotheses and prototypes → push learning conclusions and opportunity context back to Maze via API.

Writes back
  • ·Hypothesis and opportunity context written back to Maze study descriptions
  • ·UPG learning node conclusions added to study result summaries
  • ·Prototype-to-feature traceability links surfaced in study metadata

How to import your Maze data

Via the CLI (coming soon)

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

npx unified-product-graph import --from maze

This will fetch your Maze 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 { MazeAdapter } from '@unified-product-graph/adapters'
// Pass pre-fetched Maze data as SourceItem[]
const adapter = new MazeAdapter()
const result = await adapter.convert(items)
// result.nodes → typed UPG entities
// result.edges → canonical relationships
// result.warnings → items needing review

Get started

The Maze 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