Portal FAQ widget instance options form

  • Release version: Xanadu
  • Updated August 1, 2024
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Portal FAQ Widget Instance Options Form

    The Portal FAQ widget allows ServiceNow customers to configure frequently asked questions on a portal page. The instance options provide flexibility in selecting the data source, defining how FAQs are displayed, and determining user interaction functionalities.

    Show full answer Show less

    Key Features

    • Table Selection: Default is set to Knowledge [kbknowledge], allowing customization of the source of FAQs.
    • Question and Answer Fields: Specify fields for questions and answers; records with empty fields will not display.
    • Query: Filter FAQs with an encoded query; if left empty, all FAQs are displayed.
    • Sorting: FAQs can be sorted by a chosen field (default: View Count) and order (default: z to a).
    • Title: Customize the title of the widget; default is "Frequently Asked Questions".
    • Search Functionality: Option to include a search field with customizable placeholder text (default: "Search FAQs").
    • FAQ View Page: Redirects users to the kbarticleview by default when selecting "Read more".
    • FAQs Per Page: Set the number of FAQs shown at once (default: 5).
    • Browse Options: Filter options for users (default: Knowledge Category).
    • Show Read More: Control display of full article content based on user selection (default: Exceeds preview).

    Key Outcomes

    By effectively utilizing the Portal FAQ widget instance options, ServiceNow customers can enhance the user experience by providing a tailored, searchable FAQ section on their portals. This customization leads to improved user engagement and satisfaction through accessible and relevant information.

    The instance options enable you to configure the Portal FAQ widget on a portal page.

    Table 1. Data fields on the Instance form
    Instance option Description
    Table Table from which the records shown as frequently asked questions (FAQs) on the widget are selected.

    By default, this field is set to the Knowledge [kb_knowledge] table.
    Question Field The field of the table set in the Table field that contains the questions.

    Records with an empty question field aren't displayed on the widget.
    Answer Field The field of the table set in the Table field that contains the answer.

    Records with an empty answer field aren’t displayed on the widget.
    Query Query to filter FAQs.

    If this field is empty, the widget displays all the FAQs.

    You can include fields from the provided table only in the encoded filter query. For more information, see Generate an encoded query string through a filter
    Sort by Field in the Knowledge [kb_knowledge] table that determines the field by which FAQs are sorted and displayed on the widget.

    By default, the field is set to View Count.
    Sort Order The order of the FAQs on the search result page on the widget.
    The available options are:
    • z to a
    • a to z

    The default order is z to a.

    Note:
    Currently, if you select None, the order is set to z to a.
    Table 2. Presentation fields on the Instance form
    Instance option Description
    Title Required title of a Portal FAQ widget. The default text is Frequently Asked Questions.
    Table 3. Behavior fields on the Instance form
    Instance option Description
    Display search Option to display a Search field on the widget.
    Search Bar placeholder text Placeholder text for the search field label. The default text is Search FAQs.
    FAQ View Page The article page that opens when the Read more option is selected by the user.

    By default, this field is set to the kb_article_view.
    FAQ per page The number of FAQs to appear by default on the widget.

    The default value is set to 5.
    Browse Options The filter options that appear in the widget and can be selected by the user.
    The available options are:
    • Knowledge Category
    • Related products

    The default option is Knowledge Category.

    Note:
    Currently, if you select None, the filter option is set to Knowledge Category.
    Show Read More Displays the entire content of an article when the related FAQ is accessed on the widget.
    The available options are:
    • Always: Display the Show Read More option on a widget for both complete and incomplete preview content
    • Exceeds preview: Display the Show Read More option only when the article content exceeds the preview limit on the widget

    The default option is Exceed preview.

    Note:
    Currently, if you select None, the filter option is set to Knowledge Category.