This content is archived. See latest version here

Last updated: Sep 21 2015

The AllowedRoles property for a component definitions lets you control the groups that are allowed to view and select a certain component. You can hide a component completely by setting the AllowedRoles property to none, or setting it to a null string which prevents an access check.

The following example shows how to hide or show a certain component, depending on a global setting.

    public class FileManagementComponent : ComponentDefinitionBase
        public FileManagementComponent()
            : base("epi-cms.component.FileManagement")
            Categories = new string[]{"cms"};
            LanguagePath = "/episerver/cms/components/filemanagement";
            SortOrder = 200;
            PlugInAreas = new string[] { PlugInArea.DefaultAssetsGroup };

            if (!EPiServer.Configuration.Settings.Instance.UseLegacyFileManagerMode)

Do you have feedback on this documentation? Send an email to For development-related questions and discussions, refer to our Forums on