{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":42630,"path":"platform-user-interface/service-portal/widget-showcase.md","title":"Widget library","bundle":null,"doc_type":null,"release":"australia","body":"\n# Widget library\n\nYou can use base system widgets as-is in your Service Portal or duplicate them to suit your own business needs.\n\n**Note:** Base system widgets are read-only so you can benefit from future updates. To make changes, you can clone base system widgets. However, cloned widgets are considered custom and don't benefit from future updates to the widgets they were cloned from. To learn more about cloning or creating widgets, see [Developing custom widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/widget-dev-guide.md).\n\nTo view and configure the instance options for a widget, see [Configure widget instances](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/c_ConfigureWidgetInstances.md).\n\n## Example widgets\n\nExample widgets help show what you can do in the Service Portal. They demonstrate how common portal features work and what information you can access directly from a portal page.\n\nUse example widgets to do the following:\n\n-   View announcements, approvals, and service information.\n-   Navigate the portal more easily.\n-   Interact with common tools such as calculators, data tables, and carousels.\n-   See how information can display dynamically on a page.\n\nThese widgets appear as ready‑to‑use components in the Service Portal. Some focus on everyday tasks, such as approving requests or viewing announcements, while others show interactive or informational elements you might see on a portal page. For more information, see [Example widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/sp-example-widgets.md).\n\n## Service Catalog widgets\n\nService Catalog widgets let you browse, request, and track services directly from the Service Portal. They provide the building blocks for a complete Service Catalog experience, allowing you to find what you need and submit requests in one central place.\n\nUse Service Catalog widgets to do the following:\n\n-   Browse available services and catalog items.\n-   Search the catalog from the portal homepage.\n-   View services by category.\n-   Order catalog items and submit requests.\n-   Track your requests and approvals.\n\nThese widgets display service information in a clear, task‑focused way. For example, some widgets help you search or browse the catalog, while others let you view request details or check the status of items you have already ordered. For more information, see [Service Catalog widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/sc-widgets.md).\n\n## Knowledge Management widgets\n\nKnowledge Management widgets let you search, browse, and read knowledge articles directly in the Service Portal. They provide the core components for building a knowledge experience that helps you find answers quickly and consistently.\n\nUse Knowledge Management widgets to do the following:\n\n-   Search the knowledge base for information and solutions.\n-   Browse knowledge bases and categories.\n-   View knowledge articles and related content.\n-   See popular, featured, or top‑rated articles.\n-   Interact with articles by rating or commenting, when available.\n\nThese widgets organize knowledge content in a clear and easy‑to‑navigate way. Some widgets help you discover articles through search and filters, while others display article details and related information on the article page. For more information, see [Knowledge Management widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/km-widgets.md).\n\n## Service Portal service status widgets\n\nService status widgets show the current health of business services in the Service Portal. You use these widgets to see whether services are available, experiencing issues, or undergoing planned maintenance.\n\nUse the service status widgets help you do the following:\n\n-   View current service availability and outages.\n-   Understand the impact of service issues.\n-   See planned maintenance schedules.\n-   Review recent service status history.\n-   Subscribe to updates for specific services.\n\nThese widgets present service health information in a clear, visual format. Some widgets show current issues, while others display planned maintenance or historical service status trends. This lets you quickly understand what is happening and plan your work accordingly. For more information, see [Service Portal service status widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/service-status-widgets.md).\n\n## Service Portal configuration page widgets\n\nService Portal configuration page widgets help you set up and manage your Service Portal experience. Use these widgets when you configure portals, pages, themes, and widgets in the Service Portal Configuration workspace, rather than for end‑user interaction.\n\nThese widgets support portal configuration tasks such as:\n\n-   Navigating Service Portal configuration pages.\n-   Viewing portals and pages in a structured, tree‑based layout.\n-   Editing portal themes and previewing design changes.\n-   Configuring pages and widgets using visual editors.\n\nService Portal configuration page widgets run behind the scenes and are internal to the configuration experience. For example, they power tools like the Portal Map, Page Map, Branding Editor, and Widget Editor, helping you understand and manage how your portal is structured and displayed. For more information, see [Service Portal configuration page widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/sp-config-widgets.md).\n\n## Search widgets\n\nService Portal search widgets let you find information quickly across the Service Portal. Use these widgets to search for knowledge articles, catalog items, records, and other content without navigating through multiple pages.\n\nSearch widgets help you to do the following:\n\n-   Search for answers, services, and records from a single search bar.\n-   See relevant results as you type with predictive search.\n-   Filter and refine search results to find what you need faster.\n-   Get suggested or context‑aware results while submitting requests.\n\nService Portal search widgets work in different locations, such as the portal homepage, search results page, or within record producers. Some widgets display a simple search bar, while others show detailed results with filters and facets for easier discovery. For more information, see [Search widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/search-widgets.md).\n\n-   **[Example widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/sp-example-widgets.md)**  \nAll widgets in Service Portal can be used as example code for how scripts are used in a widget. However, several base system widgets have been included expressly for this purpose.\n-   **[Search widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/search-widgets.md)**  \nSeveral search widgets are provided with Service Portal.\n-   **[Knowledge Management widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/km-widgets.md)**  \nUse Knowledge Management widgets to build a knowledge base for your portal.\n-   **[Service Catalog widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/sc-widgets.md)**  \nUse the Service Catalog widgets to build a catalog for your portal.\n-   **[Service Portal configuration page widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/sp-config-widgets.md)**  \nService Portal uses widgets for configuration. When you configure a page or a widget for a portal in the Service Portal Configuration page, you actually use Service Portal widgets to do so.\n-   **[Service Portal service status widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/service-status-widgets.md)**  \nUse the service status widgets to display current, planned, and historical outages for business services to your end users.\n\n**Parent Topic:**[Using portal widgets](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-user-interface/service-portal/service-portal-widgets.md)\n\n"}}