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 configurations 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.


    Notifications 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!

    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 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 RecurringHostedServiceBase.

    IoC & Dependency Injection

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

    Response Caching

    Information about how to modify or add the Cache-Control header.

    API Documentation V9





    These links open in a documentation browser that is different from the documentation section you're viewing now.

    Angular, JavaScript, CSS & Less UI API references for building Umbraco backoffice components.

    External resources