Umbraco - Using the new umb:document/guid/Udi

Hey Peeps,

So today I came across this new Umbraco umb:document/guid/Udi referencing. It seems something has changed very recently and now when querying content pickers and multi node tree pickers it doesn't return the Id any more. Some people are saying this has been introduced since version 7.6. I am not 100% on this fact though.

Previously when looked up the selected item/s in the back-end umbraco's api returned an Id which we could easily use in whatever we were doing with it. Now it seems that it returns a Udi which is basically the document guid with some other bits. It will look something like this.

Content Picker

The return value will be something like.

umb://document/d4741f7f7acc4791a4dcb46f89b9f0b8

Multi Node Tree Picker

The return value will be something like.

umb://document/d4741f7f7acc4791a4dcb46f89b9f0b8,umb://document/d4741f7f7acc4791a4dcb46f89b9f0a4,umb://document/d4741f7f7acc4791a4dcb46f89b9f0e3

So the question is what do we do with this values and how do we get the content items from the strange looking string?

I will save you the trouble! Here are two methods I use for getting this data. You have a choice of simply passing the string in or passing in the UDI

public static IPublishedContent GetPublishedContentByUdi(string udi)
{
     var umbracoHelper = new UmbracoHelper(UmbracoContext.Current);
     return umbracoHelper.TypedContent(udi);
}

public static IPublishedContent GetPublishedContentByUdi(Udi udi)
{
     var umbracoHelper = new UmbracoHelper(UmbracoContext.Current);
     return umbracoHelper.TypedContent(udi);
}

If you do pass in the Udi here is a handy bit of code you might find useful.

Udi udi = Udi.Parse("umb://document/d4741f7f7acc4791a4dcb46f89b9f0b8");

About the author

David Armitage

.Net MVC Developer
.Net Core Developer
Umbraco Certified Master
Recruitment Professional

Hey Peeps,

I'm an entrepreneur and web developer with a passion for coding. I absolutely love working with Umbraco CMS and appreciate the Umbraco community even more.

I've got 10 years+ .Net experience and 7 years+ experience working in the recruitment industry, both coding and marketing job websites. I wanted to use my skills to help give something back to this awesome community and so I decided to build UmbraJobs.com.

My vision & fundamentals

I want this website to be a place where Umbraco Professionals and Umbraco Partners can advertise their services but at the same time I want to filter out all the under-qualified freelancers & agencies that take up the biggest part of other job & freelancer websites. We've all worked hard to gain our Umbraco certifications, partnership status, and help build the Umbraco community to what it is today. I want to see everyone get rewarded for their efforts.

Follow me on social media

If you're an Umbraco professional, partner, employer, recruiter or a passionate Umbraco community builder then I'm more than happy to hear from you. Follow me on my social media channels and please reach out if you have any needs, want help or consultation with anything Umbraco related or just want a general chat.