We have moved!

You are currently looking at documentation for Umbraco 8 and older versions.
Go to docs.umbraco.com for documentation for Umbraco 9 and newer versions.

    Developers' Reference

    Developers' Reference primarily consists of API references of the different core Umbraco APIs. In many cases, the references come with code snippets with examples. For a more in-depth study of the different APIs, consult the "using-umbraco" and "extending-umbraco" sections of the documentation.


    Information about all of Umbraco's configuration files and options.


    Working with Umbraco templates: views, partial views, child actions, razor syntax, macros and working with JavaScript/Css.

    Querying & models

    Information about the data models used to display content in Umbraco and the various ways of querying it.

    Routing & Controllers

    How routing works within Umbraco, how content is mapped to URLs and how URLs are generated for content. This section also describes the types of Controllers used in Umbraco, how they work and how they get routed.


    Details on how to implement search capabilities for your Umbraco website using Examine, which is a Lucene-based search engine for Umbraco.


    Event model covering all major aspects of the system for triggering custom code or automation.

    Management APIs

    APIs that focus on creating, updating and deleting.


    The term 'Plugins' refers to any types in Umbraco that are found in assemblies that are used to extend and/or enhance the Umbraco application.


    Describes how to work with caching custom data structures in Umbraco. When creating Umbraco packages that have custom data sources and you want to cache some of this data, it's important to understand how caching works in Umbraco and to understand how it affects Umbraco installations in load balanced environments.


    Information on Umbraco security, its various security options and configuring how authentication & authorization works in Umbraco.

    Common Pitfalls & Anti-patterns

    This section is ultra important! It describes many common pitfalls that developers fall in to. Make sure you read this section - it might save your site!

    API Documentation V8

    C# API Documentation

    Note: opens a documentation browser that is different from the documentation section you're viewing now.

    C# API references for the Umbraco Core and Web libraries.

    Backoffice UI API documentation

    Rest APIs

    How to use Web API with Umbraco to create REST services.


    How to debug your code with Visual Studio

    Language Variation

    Language Variation allows you to have several different variations of content based on a language culture.


    Find out how to map one object's properties to another type of object.


    Run recurring code using the BackgroundTaskRunner.

    IoC & Dependency Injection

    Information about setting up Inversion of Control / Dependency Injection to work with Umbraco.

    External resources