Umbraco Test Builders

This is a fluent builder library for creating Umbraco backoffice test data without all the boilerplate. Instead of manually constructing JSON models for document types, content, media, and data types in your tests, you get chainable builders with sensible defaults. The nested builder pattern with done() and build() methods keeps complex structures readable, especially when you're setting up block lists or document types with multiple property groups. It's maintained by the Umbraco core team and primarily used in their E2E and MSW testing setups. If you're writing integration tests for Umbraco projects and tired of massive object literals, this will clean things up considerably.

skills.sh installs: 370
GitHub stars: 27
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add umbraco/umbraco-cms-backoffice-skills --skill umbraco-test-builders --agent claude-code

Installs into .claude/skills of the current project.

Files

Umbraco Test Builders

What is it?

The @umbraco/json-models-builders package provides fluent builder classes for creating Umbraco backoffice models. These builders simplify test data creation with sensible defaults and chainable configuration methods.

Documentation

Package: @umbraco/json-models-builders
Repository: https://github.com/umbraco/Umbraco.JsonModels.Builders
Reference: /Users/philw/Projects/Umbraco.JsonModels.Builders

Related Skills

umbraco-testing - Master skill for testing overview
umbraco-e2e-testing - E2E testing (primary user of builders)
umbraco-msw-testing - MSW testing (can use builders for mock data)

Installation

npm install @umbraco/json-models-builders

Builder Pattern

All builders follow this pattern:

const model = new SomeBuilder()
  .withProperty(value)        // Configure scalar properties
  .withOtherProperty(value)   // Chain multiple configurations
  .addChild()                 // Create nested builder
    .withChildProperty(value)
    .done()                   // Return to parent builder

SKILL.md on GitHub