naresh Azhagarselvam
Sep 30, 2016
(2 votes)

IPageCriteriaQueryService - GET THE RELATIVE URL OF A PAGE


Problem Statement

Imagine that we have a scenario where we will need to navigate between EPiServer pages in screens of wizards and one simple way to achieve the navigation is by using the below JavaScript

window.location.href = pageUrl

In this case, we will need to retrieve the relative URL of the EPiServer page so that it can be used in the above JavaScript statement


 Image Functional_Sequence.png

IPageCriteriaQueryService is an API in EPiServer using which we can search for pages programmatically. We can create Page criteria to search by page name , page id etc. We can create page level criteria using PropertyCriteria class and add those objects to a collection named PropertyCriteriaCollection. The API exposes a method FindPagesWithCriteria which searches for page instances using this PropertyCriteriaCollection object as parameter and the other parameter will be the content reference (page reference) where to start the search. The return type is a PageDataCollection object. We can retrieve the first page object from this collection and retrieve its virtual path using UrlResolver object as shown below.

Code snippet:

            var myPageUrl = GetPageRelativeURL<MyCMSPage>();

            public static string GetPageRelativeURL<PageToSearch>() where PageToSearch : BasePageClass


               string returnurl = "/404";



                var pages = FindPagesWithCriteria<PageToSearch>();

                if (pages != null && pages.Any())


                    returnurl = GetPageUrl(pages.FirstOrDefault());




            catch (Exception ex)


                //logging mechanism


            return returnurl;


        private static PageDataCollection FindPagesWithCriteria<PageSearch>() where PageSearch : BasePageClass


            PageDataCollection pages = new PageDataCollection();



                PropertyCriteriaCollection criterias = new PropertyCriteriaCollection();

                PropertyCriteria criteria = new PropertyCriteria();

                criteria.Condition = CompareCondition.Equal;

                criteria.Name = "PageTypeID";

                criteria.Type = PropertyDataType.PageType;

                var contentRepository = ServiceLocator.Current.GetInstance<IContentTypeRepository>();

                criteria.Value = contentRepository.Load<PageSearch>().ID.ToString();

                criteria.Required = true;



                IPageCriteriaQueryService queryService = ServiceLocator.Current.GetInstance<IPageCriteriaQueryService>();

                pages = queryService.FindPagesWithCriteria(ContentReference.StartPage, criterias);


            catch (Exception ex)


                 //Add your logging mechanism


            return pages;



       public static string GetPageUrl(IContent page)


            if(page != null)


               UrlResolver _urlResolver = ServiceLocator.Current.GetInstance<UrlResolver>();


                return _urlResolver.GetVirtualPath(page).GetUrl() ?? "/";




                return "/";



Sep 30, 2016


Sep 30, 2016 04:16 PM


Instead of using FindPagesWithCriteria, you can use IContentRepository please see

Sep 30, 2016 04:28 PM

It's also possible to add a few properties to the page/block of type content reference and let editor configure the function. Pro is that you don't need to scan the entire page tree which can affect performance. Con is that you need to set up a few properties the first time you use the function. 

Also noted that the above function will take the first randomly found item of a specific type. That works well if you only have one wizard function but will be problematic if you need to add a second. Your wizard might work well one day and fail the next if editor moves a page or two in the tree structure...

K Khan
K Khan Sep 30, 2016 04:39 PM

Which CMS Versions are you using?

arivoli.elamparithi Oct 3, 2016 05:00 PM

Hi Johan,

Any reason why IContentRepository should be used over FindPagesWithCriteria ??

Thanks in advance.

arivoli.elamparithi Oct 3, 2016 05:03 PM

Hi Khan,

We are using Episerver version 9.X.

Replying on behalf of Naresh.

Please login to comment.
Latest blogs
Translating Optimizely CMS 12 UI components

Optimizely CMS 12 have been out for a while now, but still some elements haven't been properly translated resulting in a GUI defaulting to english....

Eric Herlitz | Jan 26, 2023 | Syndicated blog

Image preview in Optimizely CMS12 all properties view

With these simple steps, you can now see an Image and its Metadata, including size and dimensions, when editing an Image property in Optimizely...

Tomas Hensrud Gulla | Jan 26, 2023 | Syndicated blog

Setting up the ImageEditor in Optimizely CMS 12

Setting up certain configurations on Opimizely CMS 12 differs quite a bit from prior versions of (Episerver CMS 11 and older). Here's a small guide...

Eric Herlitz | Jan 25, 2023 | Syndicated blog

Happy Hour Returning in February

Hi everyone! It's been a while and we're excited to resume our Happy Hour in February for more learning, sharing, connecting, relaxing, and just to...

Patrick Lam | Jan 24, 2023

Planned breaking change for Locale parameter in Content Graph

Content Graph, a new service which makes it possible to query content using GraphQL, will have a breaking change soon. The service is currently in...

Jonas Bergqvist | Jan 23, 2023

Optimizely Advanced ContentArea Render is Back!

If you have used EPiBootstrapArea package - then back in those days we had an opportunity to render Episerver ContentArea items with different...

valdis | Jan 23, 2023 | Syndicated blog