We have moved!

You are currently looking at documentation for Umbraco 8 and older versions.
An automated guess is that docs.umbraco.com/umbraco-cms/extending/ could be the link to the new documentation for Umbraco 9 and newer versions.

    Extending Umbraco


    A Dashboard is a component for displaying elements on the right-hand side of the backoffice UI area.

    Sections & Trees

    The Umbraco backoffice consists of sections (sometimes referred to as applications) which contain trees. For example, when you load the backoffice you'll see that the 'Content' section contains one tree: the content tree whereas the 'Settings' section contains a number of trees: Stylesheets, Content Types, Media Types, etc...

    Both sections and trees can be created to extend Umbraco.

    Property Editors

    A property editor is the editor used to insert content into Umbraco. See here for definition.

    This section will describe how to work with and create Property Editors.

    Macro Parameter Editors

    A Parameter Editor is the editor used to insert values into a Macro.

    This section will describe how to work with and create Parameter Editors.

    Language Files

    The Umbraco backoffice can be configured so that the user interface runs in the user's native language. This is made possible with community generated language files, if your language is not currently supported, why not help to add support?

    Backoffice tours

    Backoffice tours is the integrated and interactive help for the backoffice.

    Backoffice UI API Documentation

    A library of API Reference documentation.

    Extending the Umbraco Backoffice search, customising the fields searched - replacing the searching mechanism.

    Content Apps

    Content Apps are a new concept in v8. Editors can switch from editing 'Content' to accessing contextual information related to the item they are editing.

    Content Apps encapsulate companion read-only information relating to the current content item in the Umbraco backoffice.


    Create a custom Database table.

    Embedded Media Providers

    Details on how to create a custom Embedded Media Provider to enable editors to embed third party media content into Umbraco via the embed button in the Rich Text Area.

    FileSystemProviders (IFileSystem)

    Details on implementing virtual file systems for things like media which will allow you to store your files outside of the physical file system (i.e. Cloud based for example).

    Health Checks

    Developers can create their own Umbraco Health Checks and Health Check notification methods.


    Information on the packaging manifest format and how assets should be packaged as a zip file for distribution