
Umbraco Repository Pattern
This gets you up to speed on Umbraco's repository pattern for backoffice customization. It covers the core architecture: repositories as data operation entry points, data sources for actual I/O, and optional stores for session state. The big callout here is auth: never use raw fetch for API calls or you'll get 401 errors. Always use a generated OpenAPI client configured with Umbraco's auth context. The examples walk through basic CRUD repos, tree repositories, and wiring them into contexts with observable state. Good fit if you're building custom backoffice features and need to understand how Umbraco separates data concerns from UI logic.
- skills.sh installs
- 400
- GitHub stars
- 27
- last updated
- Aug 21, 2026
Install
$ npx -y skills add umbraco/umbraco-cms-backoffice-skills --skill umbraco-repository-pattern --agent claude-codeInstalls into .claude/skills of the current project.
Files
Umbraco Repository Pattern
What is it?
Repositories are the Backoffice's entry point for data requests and update notifications, abstracting data access from various sources (server, offline database, store, Signal-R). They provide a structured way to manage data operations, separating business logic from direct data access for easier maintenance and scalability. Repositories use data sources behind the scenes, allowing consumers to work with data without knowing where or how it's stored.
CRITICAL: API Authentication
NEVER use raw fetch() for custom API calls. This will result in 401 Unauthorized errors.
ALWAYS use a generated OpenAPI client configured with Umbraco's auth context. See the umbraco-openapi-client skill for setup instructions.
Documentation
Always fetch the latest docs before implementing:
- Main docs: https://docs.umbraco.com/umbraco-cms/extend-your-project/backoffice-extensions/foundation/repositories
- Working with Data: https://docs.umbraco.com/umbraco-cms/extend-your-project/backoffice-extensions/foundation
- Store: https://docs.umbraco.com/umbraco-cms/extend-your-project/backoffice-extensions/foundation
Sponsors
Details
- Repository
- github.com/umbraco/umbraco-cms-backoffice-skills
- Category
- .NET & C#
- First seen
- Jun 3, 2026
More from umbraco/umbraco-cms-backoffice-skills
All 76- Umbraco Auth Provider399
- Umbraco Dynamic Root399
- Umbraco Collection View398
- Umbraco Entity Bulk Actions398
- Umbraco Localization398
- Umbraco Modals398
- Umbraco Entry Point397
- Umbraco Granular User Permissions397
- Umbraco Header Apps397
- Umbraco Health Check397
- Umbraco Icons397
- Umbraco Package View397
- Umbraco Property Action397
- Umbraco Property Editor Schema397
- Umbraco Review Checks397
- Umbraco Sections397
- Umbraco Block Editor Custom View396
- Umbraco Bundle396
- Umbraco Collection396
- Umbraco Current User Action396
- Umbraco Entity Actions396
- Umbraco File Upload Preview396
- Umbraco Picker Data Source396
- Umbraco Collection Action395