{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":5639,"path":"customer-service-management/banner-widget-inst-options.md","title":"Portal Banner widget instance options form","bundle":null,"doc_type":null,"release":"australia","body":"\n# Portal Banner widget instance options form\n\nInstance options enable you to configure the Portal Banner widget on a portal page.\n\n<table id=\"table_csm_base_entities\"><thead><tr><th>\n\nInstance option\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nHeading\n\n</td><td>\n\nRequired title of a Portal Banner widget to greet a user who signs in into the website. The default text is `Home Page Banner`.The heading field supports placeholder variables such as &lt;user&gt;, &lt;title&gt;, and &lt;part\\_of\\_day&gt;. For example, you could display a banner title such as `Hello Mr. Luddy! Good Morning.`\n\n-   &lt;user&gt;: The name of the logged-in user.\n-   &lt;title&gt;: The salutation of the logged-in user. The &lt;title&gt; variable details are retrieved from the User \\[sys\\_user\\] table.\n-   &lt;part\\_of\\_day&gt;: Displays the greeting based on the part of the day of the user's region. For example, Good morning, Good afternoon, or Good evening.\n\n</td></tr><tr><td>\n\nDescription\n\n</td><td>\n\nRequired subtitle that appears below the heading. The default description is `This is home page description`.\n\n</td></tr><tr><td>\n\nBackground Image\n\n</td><td>\n\nImage to appear as the background on the banner. **Note:** You can select images from the Images \\[db\\_image\\] table or upload a new image to it. For more information, see [Storing images in the database](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-user-interface/c_StoringImagesInTheDatabase.md).\n\n</td></tr><tr><td>\n\nHeading Text Color Hex code\n\n</td><td>\n\nColor of the heading text in hex code format.The default value is \\#FFFFFF \\(white\\).\n\n</td></tr><tr><td>\n\nDescription Text Color Hex code\n\n</td><td>\n\nColor of the description text color in hex code format.The default value is \\#FFFFFF \\(white\\).\n\n</td></tr><tr><td>\n\nAlignment\n\n</td><td>\n\nAlignment of the banner content inside the widget.The available options are:\n\n-   Left\n-   Center\n\nThe default alignment is Center.\n\n**Note:** Currently, if you select None, the alignment is set to Left.\n\n</td></tr><tr><td>\n\nShow Search bar\n\n</td><td>\n\nOption to display the search bar on the Portal Banner widget to search content.**Note:** You can enable the AI search for a banner widget to get quick results. For more information, see [Enable and configure AI Search in Service Portal](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-user-interface/enable-ais-sp.md).\n\n</td></tr><tr><td>\n\nShow Primary Button\n\n</td><td>\n\nOption to display the primary button on the Portal Banner widget.\n\n</td></tr><tr><td>\n\nPrimary Button Label\n\n</td><td>\n\nLabel of the primary button.\n\n</td></tr><tr><td>\n\nPrimary Button URL\n\n</td><td>\n\nThe URL that opens an internal web page or a portal page in the same tab and an external page or a portal in a new tab. The two types of primary URLs are:-   Absolute URL: The full URL including its protocol \\(http or https\\). For example:\n\n    ```\nhttps://example.servicenow.com/scripts/sn_csm_ec.js?v=3.1\n    ```\n\n-   Relative URL: A URL that includes only the path that comes after the domain. For example:\n\n    ```\nscripts/sn_csm_ec.js?v=3.1\n    ```\n\n\n</td></tr><tr><td>\n\nShow Secondary Button\n\n</td><td>\n\nOption to display a secondary button on the banner widget.\n\n</td></tr><tr><td>\n\nSecondary Button Label\n\n</td><td>\n\nLabel of a secondary button.\n\n</td></tr><tr><td>\n\nSecondary Button URL\n\n</td><td>\n\nThe URL that opens an internal web page or a portal page in the same tab and an external page or a portal in a new tab. The two types of secondary URLs are:-   Absolute URL: The full URL including its protocol \\(http or https\\). For example:\n\n    ```\nhttps://example.servicenow.com/scripts/sn_csm_ec.js?v=3.1\n    ```\n\n-   Relative URL: A URL that includes only the path that comes after the domain. For example:\n\n    ```\nscripts/sn_csm_ec.js?v=3.1\n    ```\n\n\n</td></tr><tr><td>\n\nSearch Placeholder Text\n\n</td><td>\n\nPlaceholder text for the search option.\n\n The default text is `Search articles and request items`.\n\n</td></tr></tbody>\n</table><table id=\"table_emr_mqk_2zb\"><thead><tr><th>\n\nInstance option\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nButtons Condition Script\n\n</td><td>\n\nScript to show or hide the primary or secondary button.You can use the scripted extension point to implement the condition script. By default, the new script displays both buttons and doesn’t include any condition. For more information, see [Provide web page link buttons to display on the Portal Banner widget](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/customer-service-management/customer-self-service-and-omnichannel-engagement/portal-scripted-extension-banner.md).\n\n</td></tr><tr><td>\n\nWidget Placeholder\n\n</td><td>\n\nOption to embed an additional widget on the Portal Banner widget.You can include only widgets from the Widgets \\[sp\\_widget\\] table.\n\n</td></tr><tr><td>\n\nWidget Option Schema\n\n</td><td>\n\nDefines the parameters of the widget that you want to add.For more information, see [Add a widget in the Portal Banner widget](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/customer-service-management/customer-self-service-and-omnichannel-engagement/portal-banner-option-schema.md).\n\n</td></tr></tbody>\n</table>**Related topics**  \n\n\n[Add and configure the Portal Banner widget](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/customer-service-management/customer-self-service-and-omnichannel-engagement/config-portal-banner-widget-inst-opt.md)\n\n"}}