Skip to content

Learning Path: CMS Developer Fundamentals

⏱ 6–8 hours beginner
📜Foundationcms

You are a developer new to Optimizely CMS. You may have .NET experience, frontend experience, or both. By the end of this path, you will understand how CMS works, have built a working site, and know where to find answers for advanced scenarios.

Work through the steps in order. Each step builds on the previous one. Concepts give you the mental model; the tutorial gives you hands-on experience; guides teach specific tasks; reference pages give you the lookup details.

Estimated total time: 6–8 hours (spread across multiple sessions is fine).


Step 1: Understand what CMS is and where it fits

Section titled “Step 1: Understand what CMS is and where it fits”

📖 ReadWhat is Optimizely CMS?

You will learn:

  • What problems CMS solves
  • Where CMS fits in the Optimizely One platform
  • The difference between SaaS and PaaS
  • How CMS connects to Experimentation, Personalization, Graph, and Opal

Time: 15 minutes


📖 ReadContent Modeling in Optimizely

You will learn:

  • Content types (page, block, media) and how they relate
  • Properties and their data types
  • Why blocks enable composable pages
  • 5 design principles for effective content models
  • How modeling decisions affect headless delivery through Graph

Time: 20 minutes


🛠️ DoBuild Your First CMS Site

You will build:

  • A working CMS project from an empty template
  • An ArticlePage content type with properties
  • A CallToActionBlock for composable layouts
  • A StartPage with ContentArea
  • Razor views with on-page editing

Time: 90 minutes


📋 FollowCreate a Content Type

You will learn:

  • Page types vs block types in detail
  • GUID management and GroupName strategy
  • AvailableContentTypes restrictions
  • Common issues and fixes

Time: 15 minutes


📋 FollowDefine Properties on Content Types

You will learn:

  • All property types and their editor controls
  • Validation attributes (Required, StringLength, Range, Regex)
  • Tab grouping for organized editing forms
  • Selection factories for dropdown properties
  • Default values

Time: 20 minutes


Step 6: Understand content delivery with Graph

Section titled “Step 6: Understand content delivery with Graph”

📖 ReadContent Delivery with Optimizely Graph

You will learn:

  • How Graph indexes CMS content automatically
  • The GraphQL API and how content types become queryable
  • When to use traditional rendering vs headless vs hybrid
  • Authentication modes and caching strategies

Time: 20 minutes


📋 FollowSet Up Optimizely Graph

You will do:

  • Install the Graph NuGet package
  • Configure credentials
  • Trigger a content sync
  • Write your first GraphQL query
  • Query content in C#, JavaScript, and GraphQL

Time: 30 minutes


🔍 Reference — Browse these pages as needed:

Time: Browse as needed (30–60 minutes for initial read)


📖 ReadVisitor Groups and Personalization

You will learn:

  • Three personalization approaches (visitor groups, ODP segments, Web Experimentation)
  • When to use each approach
  • How to create custom visitor group criteria in code
  • How personalization connects to experimentation

Time: 20 minutes


Step 10: Understand the platform identity layer

Section titled “Step 10: Understand the platform identity layer”

📖 ReadOpti ID and the Optimizely One Ecosystem

You will learn:

  • How Opti ID provides SSO across all Optimizely products
  • Organization and role management
  • Why Opti ID is required for Opal
  • Enterprise SSO integration options

Time: 15 minutes


After completing this path, you are ready to:

  • Build production sites — Apply content modeling principles to real projects
  • Add personalization — Follow the Configure Visitor Groups guide
  • Manage users — Follow the Manage Users and Permissions guide
  • Explore experimentation — Learn how to A/B test CMS content (coming soon)
  • Prepare for certification — Visit Optimizely Academy for certification tracks