UJG • Open Specification

User Journey Graph (UJG)

UJG cleanly separates design-time intent from runtime execution so teams can design, validate, measure, and iterate on journeys with confidence

Editor's Draft (ED)

Always evolving

The ED workspace captures the newest ideas, examples, and proposals. Documents can change at any time.

  • Track upcoming changes while implementing.
  • Participate in discussions and contribute.
  • Prototype the newest journey patterns.

What's inside the UJG family

Each document focuses on a specific aspect of journey modeling. Together, they connect intent, execution, and measurement.

Overview & Concepts

Motivation, terminology, and the design-time vs runtime split in clear language.

/ed/overview/

Core Model

Journeys, states, transitions, start/end, identity, and versioning.

/ed/core/

How to read (by role)

Product / UX

Overview & Concepts → Design-Time Definitions → Metrics & Conformance

Engineering

Overview & Concepts → Core Model → Runtime Executions → Serialization

Analytics / Data

Overview & Concepts → Runtime Executions → Metrics & Conformance

Tool builders

Core Model → Serialization → Runtime Executions

Publishing model

UJG evolves in the Editor's Draft workspace. When parts become stable they are snapshotted into a new Technical Report version.

  • Stable subset captured at a point in time.
  • Stable URL space for implementers.
  • ED continues iterating alongside TR releases.

Participate

UJG is developed openly. Feedback, issues, and implementation reports are welcome.