{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":42459,"path":"platform-user-interface/service-portal/configure-header-menu.md","title":"Configure a portal header menu","bundle":null,"doc_type":null,"release":"australia","body":"\n# Configure a portal header menu\n\nDefine the look and behavior of the portal header menu and assign menu items to appear in the header. The header menu is one of the primary navigation controls for Service Portal users.\n\n## Before you begin\n\nRole required: admin\n\n## About this task\n\nConfiguring a portal header with a menu involves several steps.\n\n## Procedure\n\n1. Create a header and add it to a theme.\n\n Until you add a theme with a header to a portal, the header menu does not display.\n\n2. Create a main menu with menu items and assign it to the portal.\n\n The main menu record is where you assign which navigation options appear in the header. For example, you can add a menu item that links to another page within your portal, such as the service catalog.\n\n\n## Result\n\nThe main menu and header form a header menu when associated with a theme and a portal.\n\n\\[Omitted image \"HeaderMenu.png\"\\] Alt text: Gif showing how the header menu and the stock header combine to form the portal menu\n\n**Parent Topic:**[Create a portal](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/create-a-portal.md)\n\n## Add a header or footer to a portal\n\nUse the theme to add a header or footer to your portal.\n\n### Before you begin\n\nRole required: \\(admin or none\\)\n\n### Procedure\n\n1. Navigate to **All** > **Service Portal** > **Service Portal Configuration**.\n\n2. Select **Portal Tables** > **Themes** and then select the theme you want to add the header or footer to.\n\n3. In the header or footer field, select the header or footer you want to use for your portal.\n\n If you are just getting started, you can reuse the base system Stock Header or Sample Footer widgets.\n\n4. Select **Fixed Header** or **Fixed Footer** to lock the header or footer in one place so when users scroll up or down they remain in the same location on the page.\n\n5. To configure the appearance of the header, in the Service Portal configuration page, open the Branding Editor.\n\n6. Under the **Theme Colors** tab, use the color selectors in the Navbar section to control the colors in the header.\n\n\n## Create a portal header menu\n\nCreate a menu with menu items to display in the header of a portal.\n\n### Before you begin\n\nRole required: \\(admin or none\\)\n\n### Procedure\n\n1. From the Service Portal configuration page \\(**Service Portal** > **Service Portal Configuration**\\), navigate to **Portal Tables** > **Instance with Menu** and select **New**.\n\n2. Complete the fields in the menu form.\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nTitle\n\n\n\nName of the header menu. You need to know this when you associate the menu with your portal.\n\n
\n\nAdditional options, JSON format\n\n\n\nAdvanced configuration options. For example, use this field to enable the shopping cart in the header menu with the following code:```\n{\n\t\"enable_cart\": {\n\t\t\"displayValue\": \"true\",\n\t\t\"value\": true\n\t}\n}\n```\n\n
\n\nApplication\n\n\n\nThe record scope. The header menu record and the source table must have the same application scope.\n\n
\n\nWidget\n\n\n\nThe widget that the header menu is based on. Select a menu-type widget from the list. For example, the header menu widget that is included as a base system widget.\n\n
3. Save the form, and then select **Menu Items** from the related lists.\n\n4. Select **New** and complete the menu item form.\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nLabel\n\n\n\nName that appears for the item in the menu\n\n
\n\nParent menu\n\n\n\nThis field should already contain the name of the menu you are adding items to. You can change the value as needed to other menus\n\n
\n\nParent menu item\n\n\n\nUse this field to nest menu items within other menu items\n\n
\n\nOrder\n\n\n\nValue that determines where the item appears in the menu in relation to other menu items\n\n
\n\nType\n\n\n\nThe kind of page the item links to. Form fields vary depending on the option that you select from this list. Choose from:- Page: Link to another page in the Service Portal.\n- URL: Link to an external website. To have the URL open on a new browser tab or window, enter `_blank` in the **URL target** field.\n- Service Catalog: Link to the Service Catalog.\n- Catalog Category: Link to a specific catalog category within the Service Catalog.\n- Catalog Item: Link to a specific catalog item.\n- Knowledge Base: Link to the knowledge base that you previously configured as the portal's default knowledge base.\n- KB Topic: Link to a KB topic page.\n- KB Article: Link to a KB article by number.\n- KB Category: Link to a specific KB category within the knowledge base.\n- Filtered List: Set conditions to determine which page to link to.\n- Scripted List: Enter a script to determine which page to link to.\n\n\n
\n\nPage\n\n\n\nName of the portal page the item links to. This option is available if you select **Page** as the menu item type.\n\n
\n\nCondition\n\n\n\nDetermines what conditions are required for menu items to show in the header. For example, the condition `gs.hasRole(\"sp_admin\")` restricts access to menu items to users with the sp\\_admin role. Hide a menu item by setting this value to **false**. For more information on what conditions to use in the **Condition** field, see Create a UI Action .\n\n
\n\nGlyph\n\n\n\nIcon that appears beside the menu item\n\n
5. Select **Submit**.\n\n6. After you create a menu and menu items, add the menu to a portal.\n\n 1. Navigate to **Service Portal** > **Portals**, then open the portal you want to add a menu to.\n\n 2. From the **Main menu** field, select the reference lookup icon, then select the appropriate menu by name.\n\n 3. Select **Save**.\n\n\n### What to do next\n\nAssociate the menu you created with a portal, then create a header with a theme for your menu.\n\n## Enable a language selector in portal headers\n\nAllow all users to select their language preferences by enabling the language selector in your portal header.\n\n### Before you begin\n\nActive the languages your portal users need and configure a portal header menu. For more information, see and [Configure a portal header menu](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/configure-header-menu.md).\n\nRole required: admin\n\n### About this task\n\nFor all portals except the Knowledge \\(/kb\\), Customer Support \\(/csm\\), and Customer Service \\(/csp\\) portals, the language selector is included but turned off by default. To display the language selector in the portal header for other portals, you must enable it according to this procedure.\n\nIn portal headers, the language selector displays the current language selection of the user and a menu of languages that the user can choose from. If region grouping is enabled, languages are displayed according to the configured region groups. For more information about grouping languages, see .\n\n### Procedure\n\n1. Navigate to **All**, and then enter `sys_properties.list` in the navigation filter.\n\n2. Open the **glide.sp.portals.language\\_selector\\_enabled** property.\n\n3. In the **Value** field, enter the sys\\_ID of the portal to display the language selector widget.\n\n4. Select **Update**.\n\n\n### Result\n\nThe language selector displays in the header menu for both authenticated and unauthenticated users.\n\n"}}