UDI Identifiers

    Introduction

    Umbraco 7.6.0+ Umbraco stores identifiers in UDI format for most Umbraco object types. This identifier stores all of the metadata required to retrieve an Umbraco object and is parse-able within text. Example: umb://document/4fed18d8c5e34d5e88cfff3a5b457bf2. UDI's can be used in many of the querying APIs.

    NOTE: UDI is currently not an acronym for something. There is no official definition of what it's short for. Therefore it's just called UDI

    Format

    An Umbraco UDI consists of three parts: the scheme, the type and a GUID Identifier. For example: umb://document/4fed18d8c5e34d5e88cfff3a5b457bf2.

    Breaking it down:

    1. The scheme is umb:// - this is always the same and makes it easy to identify an Umbraco UDI
    2. The type is document - so in this is an Umbraco node, but it could also be media, member, etc.
    3. The GUID Id is 4fed18d8c5e34d5e88cfff3a5b457bf2 - this is a GUID (dashes removed) which is randomly generated when the item is being created

    Usage

    You can use UDIs in several of the Querying and Management/Service APIs. The UDI API reference is found here:

    There are 2x types of UDIs: