Try our conversational search powered by Generative AI!

Henrik Fransas
Oct 26, 2015
(2 votes)

The known and unknown of Include, IncludeOn, Exclude and ExcludeOn

These four settings have always been and are little headache for me and today I took some time trying to learn more about them.
Basically they work like this:

A type array of typed content to specify which content types are available under a content instance of the type with the attribute.


A type array of typed content to specify which content types are not available under a content instance of the type with the attribute.


States that the content with this attribute is available under the typed content in the type array.


States that the content with this attribute is not available under any of the typed content in the type array.

This is pretty straight forward and the most importing part is to realize that the Include is not just including the defined types, it is also excluding all other things.
But the funny/hard thing to learn is what happens when you combine them together, which property is more important than the other.

To figure that out I took a normal Alloy site and changed the settings for StartPage and ProductPage. 

        Include = new[] { typeof(SearchPage) }, 
        ExcludeOn = new[] { typeof(ProductPage) })] 
    public class StartPage : SitePageData
        Availability = Availability.Specific,
        Include = new[] { typeof(StartPage), typeof(SearchPage) },
        IncludeOn = new[] { typeof(StartPage) })]
    public class ProductPage : StandardPage, IHasRelatedContent

That gave me this look inside admin:

Image startpage1.png

Image productpage1.png

This shows me that IncludeOn and ExcludeOn are prioritized over Include and Exclude, since even though I say that I should include StartPage on ProductPage, it is not included and even though I do not define ProductPage to be included below StartPage it is included on it.

Then I wounded what would happen if I say that the only thing that should be able to be created below ProductPage should be StartPage and keep saying to StartPage that it should be ExcludedOn Productpage. So I changed the code for ProductPage so it looks like this:

        Availability = Availability.Specific,
        Include = new[] { typeof(StartPage) },
        IncludeOn = new[] { typeof(StartPage) })]
    public class ProductPage : StandardPage, IHasRelatedContent

I thought that I would end up not being able to create anything at all below ProductPage but to my surprise this is what the result was:

Image product2.png

Somehow I ended up with being able to create everything but StartPage and that was not I was hoping for and for me it feels like a bug, what does you think?

Oct 26, 2015


valdis Oct 26, 2015 10:10 PM

Sounds like a space to dig deeper :)

henriknystrom Oct 27, 2015 12:20 AM

Had a quick look at this and would say that there is an issue here if the combined Include/IncludeOn and Exclude/ExcludeOn sets are matching up. The result will instead be the same as if only the exclude attributes were applied.

tss Oct 28, 2015 12:01 PM

We figured out that if you use the Availability.Specific option you need to include at least one page in the Include clause

for the IncludeOn option to work for any sub pages you want to include on the page at a later point.

Hopefully this gets some love at some point, right now it is kind of confusing to use.

Henrik Fransas
Henrik Fransas Nov 17, 2015 08:28 AM

This is now fixed in EPiServer.CMS.Core 9.3.2

Jiri Cepelka
Jiri Cepelka Feb 7, 2018 06:42 PM

I’ve found discussion about related issue.

Why there is Availabilty property? 

I see there should be Include automatically excluding all others, Exclude automatically including all others, IncludeOn automatically excluding content type (CT) on all other CTs and ExcludeOn automatically including CT on all other CTs.

Why there is need to tell the attribute what is my intention specifically?

I think about properties like ExclusivelyIncluded, ExclusivelyExcluded, ExclusivelyIncludedOn, ExclusivelyExcludedOn.

The answer for question of prioritizing one over other in non-on and on ones strife lays in design intentions, i.e. to be able to overwrite class behavior without option to change it or not to be able to do that, I think so.

I found this quite a hodgepodge.

Please login to comment.
Latest blogs
Optimizely and the never-ending story of the missing globe!

I've worked with Optimizely CMS for 14 years, and there are two things I'm obsessed with: Link validation and the globe that keeps disappearing on...

Tomas Hensrud Gulla | Apr 18, 2024 | Syndicated blog

Visitor Groups Usage Report For Optimizely CMS 12

This add-on offers detailed information on how visitor groups are used and how effective they are within Optimizely CMS. Editors can monitor and...

Adnan Zameer | Apr 18, 2024 | Syndicated blog

Azure AI Language – Abstractive Summarisation in Optimizely CMS

In this article, I show how the abstraction summarisation feature provided by the Azure AI Language platform, can be used within Optimizely CMS to...

Anil Patel | Apr 18, 2024 | Syndicated blog

Fix your Search & Navigation (Find) indexing job, please

Once upon a time, a colleague asked me to look into a customer database with weird spikes in database log usage. (You might start to wonder why I a...

Quan Mai | Apr 17, 2024 | Syndicated blog