Who this path is for
Section titled “Who this path is for”You are a solutions architect, technical lead, or senior developer responsible for designing systems on the Optimizely One platform. You need to understand how each product works, how they connect, and how to make architecture decisions that balance flexibility, performance, and maintainability. This path assumes familiarity with web architecture, APIs, and content management concepts.
How to use this path
Section titled “How to use this path”Work through the steps in order. The first eight steps build your understanding of each platform component and how they interrelate. Steps 9 through 11 apply that knowledge through cross-product solution patterns. Step 12 provides the API reference you will use during implementation.
Estimated total time: 8-10 hours (spread across multiple sessions is recommended).
Step 1: Understand the CMS foundation
Section titled “Step 1: Understand the CMS foundation”📖 Read — What is Optimizely CMS?
You will learn:
- The role CMS plays as the content hub of Optimizely One
- How CMS connects to Graph, Experimentation, Personalization, and Opal
- The architectural boundary between content management and content delivery
- How CMS supports both traditional and headless delivery patterns
Time: 15 minutes
Step 2: Master content modeling for scale
Section titled “Step 2: Master content modeling for scale”📖 Read — Content Modeling in Optimizely
You will learn:
- Content types, properties, and the inheritance model
- Block composition patterns for flexible page layouts
- 5 design principles that affect Graph queryability and headless delivery
- How content model decisions cascade into frontend architecture and API design
Time: 20 minutes
Step 3: Evaluate SaaS vs PaaS deployment
Section titled “Step 3: Evaluate SaaS vs PaaS deployment”📖 Read — CMS SaaS vs PaaS Architecture
You will learn:
- The architectural differences between SaaS (cloud-hosted) and PaaS (self-managed)
- Feature parity matrix and where the platforms diverge
- Migration paths from PaaS to SaaS
- Decision criteria: team size, customization needs, operational overhead, timeline
Time: 25 minutes
Step 4: Understand content delivery with Graph
Section titled “Step 4: Understand content delivery with Graph”📖 Read — Content Delivery with Optimizely Graph
You will learn:
- How Graph indexes CMS content into a queryable GraphQL API
- Content synchronization architecture and eventual consistency
- Authentication modes (single key, HMAC, public) and when to use each
- Caching layers and cache invalidation strategies
- How Graph enables multi-channel and multi-site content delivery
Time: 25 minutes
Step 5: Design data-driven experiences with ODP
Section titled “Step 5: Design data-driven experiences with ODP”📖 Read — Customer Data and Segmentation with ODP
You will learn:
- How ODP unifies customer profiles from multiple touchpoints
- Event ingestion, identity resolution, and the unified customer profile
- Real-time segmentation and how segments flow to other Optimizely products
- Data architecture: events, customers, attributes, and computed fields
- Privacy considerations and consent management
Time: 30 minutes
Step 6: Architect experimentation into your platform
Section titled “Step 6: Architect experimentation into your platform”📖 Read — How Feature Experimentation Works
You will learn:
- SDK architecture and how flag decisions are evaluated at the edge
- Environment management for dev, staging, and production
- Feature flag lifecycle from rollout to experiment to permanent release
- How experimentation integrates with CI/CD pipelines
- Performance impact and SDK optimization strategies
Time: 25 minutes
Step 7: Plan the personalization layer
Section titled “Step 7: Plan the personalization layer”📖 Read — Visitor Groups and Personalization
You will learn:
- Three personalization approaches and their architecture trade-offs
- Visitor groups (server-side, CMS-native) vs ODP segments (data-driven) vs Web Experimentation (client-side)
- How to design custom visitor group criteria for domain-specific targeting
- The role personalization plays in conversion optimization alongside experimentation
Time: 20 minutes
Step 8: Connect the platform with Opti ID
Section titled “Step 8: Connect the platform with Opti ID”📖 Read — Opti ID and the Optimizely One Ecosystem
You will learn:
- How Opti ID provides SSO across all Optimizely products
- Organization hierarchy and role-based access control
- Why Opti ID is required for Opal (AI) capabilities
- Enterprise SSO integration with SAML and OIDC
- User provisioning and lifecycle management across products
Time: 15 minutes
Step 9: Apply cross-product patterns — Content and Commerce
Section titled “Step 9: Apply cross-product patterns — Content and Commerce”📋 Follow — Headless Content Delivery with CMS and Graph
You will learn:
- How to design a headless architecture using CMS as the authoring layer and Graph as the delivery API
- Multi-site and multi-language content delivery patterns
- Frontend framework integration strategies (React, Next.js, Vue)
- Content preview and on-page editing in headless mode
- Performance optimization through Graph caching and CDN configuration
Time: 30 minutes
Step 10: Apply cross-product patterns — Data and Experimentation
Section titled “Step 10: Apply cross-product patterns — Data and Experimentation”📋 Follow — Personalized Experiences with ODP and Experimentation
You will learn:
- How to connect ODP audience segments to Feature Experimentation targeting
- Designing experiments that leverage behavioral data from ODP
- Event forwarding between Experimentation and ODP for unified analytics
- Building a closed-loop optimization system: collect data, segment, experiment, measure
Time: 30 minutes
Step 11: Apply cross-product patterns — Full Platform Integration
Section titled “Step 11: Apply cross-product patterns — Full Platform Integration”📋 Follow — Browse these solution recipes:
- CMS Content Personalization — Connecting visitor groups, ODP segments, and experimentation for content-level personalization
- Multi-Product Analytics Pipeline — Unifying data from CMS, Experimentation, and ODP into a single analytics view
- Enterprise SSO and Governance — Configuring Opti ID, SAML, roles, and permissions across the platform
You will learn:
- End-to-end integration patterns spanning the full Optimizely One stack
- How to design governance models for multi-team platform usage
- Architecture decision records for common platform trade-offs
Time: 45 minutes
Step 12: Reference the platform APIs
Section titled “Step 12: Reference the platform APIs”🔍 Reference — Browse these pages as needed:
- Graph Query Syntax — Filtering, sorting, pagination, and full-text search
- Graph SDK Reference — C#, JavaScript, and TypeScript SDK methods for Graph
- Feature Experimentation SDKs — SDK methods for flag evaluation, events, and user context
- ODP API Reference — Event ingestion, customer profiles, and segment APIs
- IContent Interface — The base CMS content interface and its extension points
- Content Type Attributes — All attributes for CMS types and properties
Time: Browse as needed (60-90 minutes for initial read)
What to do next
Section titled “What to do next”After completing this path, you are ready to:
- Design production architectures — Apply platform patterns to real customer solutions with confidence in trade-offs
- Lead platform evaluations — Use the SaaS vs PaaS decision framework and product capability knowledge to guide technology selection
- Build integration blueprints — Design cross-product data flows connecting CMS, Graph, ODP, Experimentation, and Opti ID
- Establish governance — Define roles, permissions, and operational processes across the Optimizely One platform
- Mentor development teams — Guide developers through the CMS Developer Fundamentals and Experimentation Practitioner paths
- Prepare for certification — Visit Optimizely Academy for advanced certification tracks