---
title: episerver.shell
slug: cms-11/dev-docs/episervershell
docTags: 
createdAt: 2026-07-22T19:45:18.981Z
---

The [Configure CMS](docId:-eEADlLWvxOYZN97jCo8N) topic describes the syntax of the configuration elements.

```xml
<episerver.shell>   
       <dashboard>
       <navigation>
       <protectedModules>
       <publicModules>
    </episerver.shell>
```

## \<dashboard>

```xml
<dashboard defaultService="string" >
       <disabledGadgets>
          <add name="string" /> 
          ... 
       </disabledGadgets> 
      <templates> 
          <add forRoles="string" > 
              <tabs>
                 <add layout="string"
                      name="string" >
                       <gadgets>
                          <add column="int"
                               name="string" >
                       </gadgets>
                 </add>
                 ...
              </tabs>
              ...
       </templates>
    </dashboard>
```

### \<disabledGadgets>/\<add> element attributes

| Name                                                                                                         | Default value | Description                                                                        |
| ------------------------------------------------------------------------------------------------------------ | ------------- | ---------------------------------------------------------------------------------- |
| [name](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/F493AF26) |               | ***Required***. The class name, including namespace, of the gadget to be disabled. |

### \<templates>/\<add> element attributes

| Name                                                                                                             | Default value | Description                                                                        |
| ---------------------------------------------------------------------------------------------------------------- | ------------- | ---------------------------------------------------------------------------------- |
| [forRoles](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/E67E6D5F) |               | ***Required***. Comma-separated list of roles for which the template should apply. |

### \<tabs>/\<add> element attributes

| Name                                                                                                           | Default value | Description                                                                         |
| -------------------------------------------------------------------------------------------------------------- | ------------- | ----------------------------------------------------------------------------------- |
| [layout](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/499E8166) |               | ***Required***. The name of the layout to be used on this tab. Example: “2 Column”. |
| [name](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/74266DCF)   |               | ***Required***. The name of the tab.                                                |

### \<gadgets>/\<add> element attributes

\| Name | Default value | Description |

\| [column](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/FD09F6E5) |   | ***Required***. The zero-based index of the column in which this gadget should be placed. |

\| [name](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/1F7F64D6) |   | ***Required***. The class name of the gadget, including namespace. |

## \<navigation>

```xml
<navigation>
       <add alignment="MenuItemAlignment"
            menuItemType="MenuItemType"
            menuPath="string"
            sortIndex="int"
            target="string"
            text="string"
            url="string" />
      ...<br /></navigation>
```

### \<navigation> element attributes

| Name                                                                                                                 | Default value          | Description                                                                                                                                                                                                                                                   |
| -------------------------------------------------------------------------------------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [alignment](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/6DF5119A)    | MenuItemAlignment.Left | The alignment of the menu item. Possible values are **Left** and **Right**.                                                                                                                                                                                   |
| [menuItemType](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/7989B8E7) | MenuItemType.Link      | The type of this menu item. Possible values are **Link**, **Section** and **DropDown**.<br />Link items must be children of container items, either a **Section** or a **DropDown**. The hierarchy of menu items is controlled by the **menuPath** attribute. |
| [menuPath](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/4510065F)     |                        | ***Required***. The menu path/key of this menu item. The path defines the structure and is also the unique key to this menu item.<br />“/global/” refers to the full menu area, **menuPath** must start with “/global/” to be visible in the menu.            |
| [sortIndex](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/D8333B5)     |                        | The sort index of this menu item. Menu items are sorted from low to high within each section.                                                                                                                                                                 |
| [target](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/83D0A554)       |                        | The frame in which to open the linked file.                                                                                                                                                                                                                   |
| [text](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/DA02D622)         |                        | ***Required***. The text that should appear in the menu item.                                                                                                                                                                                                 |
| [url](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/279EC9DE)          |                        | The URL of the file to be opened.                                                                                                                                                                                                                             |

## \<protectedModules>

```xml
<protectedModules autoDiscovery="AutoDiscoveryLevel"
                      rootPath="string" >
      <add clientResorcePath="string"
           name="string"
           resourcePath="string" >
        <assemblies>
          <add assembly="string" />
           ...
        </assemblies>
      </add><br />  ...
    </protectedModules>
```

### \<protectedModules> element attributes

| Name              | Default value                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| \`autoDiscovery\` | \`AutoDiscoveryLevel.Minimal\` | Option for probing the module folder and load of module assemblies automatically on start-up. Possible values are:<br />- **Minimal** will only load modules configured by \`web.config\` and associate assemblies explicitly configured in \`web.config\`.<br />- **Modules** auto-discover modules in the module directory and load assemblies defined in the module’s \`module.config\` file and load assemblies located in the module’s \`bin\` directory in addition to those defined in the module’s \`module.config\` file. |
| \`rootPath\`      |                                | ***Required***. The root path below which module directories are located.                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

### \<protectedModules>/\<add> element attributes

| Name                                                                                                                      | Default value | Description                                                                                                                                                                            |
| ------------------------------------------------------------------------------------------------------------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [clientResourcePath](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/3A9578B) |               | The client resource path. If no value is specified the **resourcePath** is used.                                                                                                       |
| [name](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/DC968CAE)              |               | ***Required***. The name of the module/folder. If no **resourcePath** value is specified the name value is combined with the **rootPath** value to form the path to the module folder. |
| [resourcePath](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/B6E2CCE)       |               | The path to the module directory.                                                                                                                                                      |

### \<assemblies>/\<add> element attributes

| Name                                                                                                             | Default value | Description                                                                                                                                                                                               |
| ---------------------------------------------------------------------------------------------------------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [assembly](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/B0EA4907) |               | ***Required***. An assembly to load and associate with the module. The assemblies listed in this collection may be combined with assemblies defined by the module depending on the auto discovery option. |

## \<publicModules>

```xml
<publicModules autoDiscovery="AutoDiscoveryLevel"
                   rootPath="string" >
       <add clientResorcePath="string"
            name="string"
            resourcePath="string" >
          <assemblies>
             <add assembly="string" />
             ...
          </assemblies>
       </add>
       ...
    </publicModules>
```

### \<publicModules> element attributes

| Name                                                                                                                 | Default value              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| -------------------------------------------------------------------------------------------------------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [autoDiscovery](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/FDA5ABD) | AutoDiscoveryLevel.Minimal | Option for probing the the module folder and load of module assemblies automatically on start-up.<br />Possible values are:<br />- **Minimal** will only load modules configured by web.config and associate assemblies explicitly configured in web.config.<br />- **Modules** auto-discover modules in the module directory and load assemblies defined in the module’s module.config file and load assemblies located in the module’s bin directory in addition to those defined in the module’s module.config file. |
| [rootPath](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/BD05BD4F)     |                            | ***Required***. The root path below which module directories are located.                                                                                                                                                                                                                                                                                                                                                                                                                                               |

### \<publicModules>/\<add> element attributes

| Name                                                                                                                      | Default value | Description                                                                                                                                                                            |
| ------------------------------------------------------------------------------------------------------------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [clientResourcePath](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/3A9578B) |               | The client resource path. If no value is specified the **resourcePath** is used.                                                                                                       |
| [name](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/DC968CAE)              |               | ***Required***. The name of the module/folder. If no **resourcePath** value is specified the name value is combined with the **rootPath** value to form the path to the module folder. |
| [resourcePath](/epiui/CMS/Content/documentation/Class-library,,66786/?epieditmode=False\&documentId=cms/10/B6E2CCE)       |               | The path to the module directory.                                                                                                                                                      |

### \<assemblies>/\<add> element attributes

| Name     | Default value | Description                                                                                                                                                                                               |
| -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| assembly |               | ***Required***. An assembly to load and associate with the module. The assemblies listed in this collection may be combined with assemblies defined by the module depending on the auto discovery option. |
