# FAQs

## What is FAQs

FAQs enhances the user experience by **presenting frequently asked questions in a smart and user-friendly format**. Users can access concise answers, valuable resources, and instructions for infrequently performed procedures through the FAQs section.

You can view questions and answers in a user-friendly format, facilitated by a **filtering system** that makes it easy to gather questions on a specific topic. Additionally, you have the option to **bookmark your favorite questions**, ensuring quick access to your personalized FAQs.

Our FAQ pages are integrated with [Advanced Search](https://docs.intranet.ai/configuration/advanced-search), allowing users to **find answers to their questions within seconds.**

Our FAQs are also integrated with[ Intranet Analytics](https://intranet.ai/features/intranet-analytics/), allowing you to **monitor the most frequently asked questions** within the SharePoint intranet. This integration enhances your understanding of the most sought-after information. The data analysis component offers **valuable insights**, contributing to the **continuous improvement of both the portal and business processes**.

{% hint style="info" %}
Explore the **advantages** of Intranet.ai **FAQs** by [**clicking here** ](https://intranet.ai/features/company-faq-page/)to learn more.
{% endhint %}

***

## Add the FAQs web part to a SharePoint page&#x20;

* If your page is not already in edit mode, click **Edit** at the top right of the page.
* Hover your mouse above or below an existing web part and you'll see a line with a circled +, like this: <img src="/files/l5ySSL5qOCO7zmUJPhxZ" alt="" data-size="line">&#x20;
* Click on it and, in the web part search box, enter **FAQ** to quickly find and select the FAQs web part, which is named "IAI - FAQ".

<div align="left"><figure><img src="/files/TW4uAaHxW2aZTm53UpUV" alt="" width="447"><figcaption></figcaption></figure></div>

* Click the **Edit** **properties** <img src="/files/3NusM7PyGy6CtExLVX0e" alt="" data-size="line"> button on the left of the web part to open the property pane and set options such as Layout settings, Data sources, Filter settings, General settings, Display settings settings and Fields settings. See below for more information on each of these options.

> You can create as many FAQ lists and FAQ areas as you like. For example,  you can divide your FAQs by department or by topic, and create specific pages with specific FAQ lists.

***

## Configuration

1. [Layout settings](#list-settings)
2. [Data sources](#data-sources)
3. [Filter settings](#filter-settings)
4. [General settings](#general-settings)
5. [Display settings](#display-settings)
6. [Fields settings](#fields-settings)

### Layout settings <a href="#list-settings" id="list-settings"></a>

The layout settings allow you to customize the appearance of your application by adjusting various layout settings.

<div align="left"><figure><img src="/files/rZ2gEMtGyYTQv5BOG8ZG" alt=""><figcaption></figcaption></figure></div>

By opening this first configuration, you will see the following options:

* **Do you want to hide the background?** You can choose to hide or display the webpart background The default setting is “No”. This means that, by default, the webpart is characterized by a white background. If you enable this option, the white card background will be completely removed, allowing the content appear directly on the page. As a result, the webpart will be transparent, showing either the selected background image or the chosen SharePoint page color.
* **Do you want to hide the shadow?** You can choose whether to show or hide the background shadow. The default setting is “No”. This means that, by default, the webpart is characterized by a subtle depth effect that can make the webpart stand out more against the rest of the page. If you enable this option, the shadow behind the background will be removed, giving the web part a flatter, cleaner look without any depth.
* **Select the type of shadow you want to use**: if you decide to set the background shadow, a further configuration will appear and you can select the style from High Contrast, Light, or Dark options.
  * If you select **High contrast**, this option creates a strong, bold shadow effect that provides a high level of contrast between the background and the content.
  * By choosing the **Light background shadow**, it will create a soft and subtle effect, giving a more delicate and gentle depth to the background.
  * Finally, the **Dark background shadow** style provides a darker, more intense effect, adding depth and emphasizing the background even more.
* **Do you want to hide the title?** Here you can select whether to show the webpart title or hide it. If set to visible, the web part title will appear on the left side.
* **Enter the title of the application**: thanks to this configuration, you can customize the application title. If you keep it blank, SharePoint will show the default title “FAQ” at the top left angle of the webpart.

### Data sources

This section allows the webpart to take elements from the selected lists.

<div align="left"><figure><img src="/files/nzctijoMIKfwTF2fbKlu" alt=""><figcaption></figcaption></figure></div>

* In the first fields, you need to paste the URL of your intranet site and the select the **FAQ list** you want to display in the web part.
* You need to do the same in the next two fields: copy paste the URL of your intranet site and select the **favorites list** associated to the FAQ list just chosen.

### Filter settings

This section is divided into two sub-sections.

1. The **prefilter configurator** allows you to show only FAQs that belong to specific categories.
2. The **filter configurator** allows you to add filters to the web part to help users find information quickly. These filters are used to categorize FAQs.

<div align="left"><figure><img src="/files/KrChzYKahatY7VYf8m49" alt=""><figcaption></figcaption></figure></div>

1. **Open the prefilter configurator**: click on **Configure prefilters** and a dialog box will open with two fields to fill in:

<figure><img src="/files/zHGWWDXB8erUC5gUBgHc" alt=""><figcaption></figcaption></figure>

* In the **first** box, you need to choose the filter: select the single option, **Categories**.
* In the **second** box, you need to insert the categories you want to show, divided by the | symbol. For example: TFR|Injury.

> In this example, only the FAQs related to the selected topics (TFR and Injury) are shown in the web part:

<div align="left"><figure><img src="/files/9wKDSyEJrCrJD9GSUEJV" alt=""><figcaption></figcaption></figure></div>

2. **Open filter configurator:** click on **Configure filters** and a dialog box will open with a few fields to fill in:

<figure><img src="/files/zvDE9CDveSluOhbeWXX9" alt=""><figcaption></figcaption></figure>

* In the first box, you need to choose the filter: select the single option, **Categories**.
* In the second box, you can **customize** the name of the filter.

> For example: Categories, Typologies, Topics.

* With the third option, you can choose to show the **search bar** inside the filters (this is interesting when there are a lot of filters).
* Finally, with the fourth option, you can choose to display the filter box open or close by default.

Here’s an example of the filter box opened by default with the search bar:

<div align="left"><figure><img src="/files/hqijkR1s9i1mUYGYUi9G" alt=""><figcaption></figcaption></figure></div>

* **Hide filters**: you can choose whether to show or hide the filters on the right side of the web part.

### General settings

These settings allow you to choose the number of FAQs to display inside the web part.

In these settings, you’re asked to:

* Select the number of FAQs you’d like to display as a preview.
* Select the sorting logic: you can decide to sort FAQs by title (i.e., alphabetically), or by the Order field. The Order field is an entry required while putting FAQs in the dedicated list (more information is available in the [final section of this guide](https://docs.intranet.ai/sharepoint-intranet/components/faqs#configuration)). If you enable this option, FAQs will be displayed according to the specific order you have selected while filling out the list.

<div align="left"><figure><img src="/files/Pq1nvoAKflAuC4zgjIAf" alt=""><figcaption></figcaption></figure></div>

### Display settings

Thanks to this section, you can customize the favorite section for your selected FAQs. You should fill in some configuration such as the name of the section, the name for opening other faqs and more.

<div align="left"><figure><img src="/files/GGXCV7T19BmzS2FIPvzF" alt=""><figcaption></figcaption></figure></div>

* **Favorite section name**: here you can customize the name of the Favorite section. If you leave this field empty, the web part will use the default name, which is “Only favorites”.
* **Section name all FAQs**: here you can customize the name of the section containing all the FAQs. If you leave this field empty, the web part will use the default name, which is “All FAQs”
* **Enter text for the button to see other faqs**: choose the name for the button regarding loading other faqs
* **Set the button to load more faqs or to open a link?** Here two options are available:
  * You can decide to load additional FAQs or redirect users to a specific link.
  * If you choose the second option, another configuration is needed, which is inserting the URL to open when clicking the button.

<div align="left"><figure><img src="/files/yv09aKjEn307tLbVlMiV" alt=""><figcaption></figcaption></figure></div>

* Finally, you can choose whether to open the link on the same page or on a new one.
* **Show the last modified item**: you can choose to include a section named "Last modified" in the Favorites drop-down menu. This filter will allow you to display recently updated questions.

### Fields settings

These settings allow you to customize some of the web part's fields and link the various FAQ list columns to the web part.

<div align="left"><figure><img src="/files/1txqivnSFjAsonoBptWL" alt=""><figcaption></figcaption></figure></div>

* For the first fields, you need to select the fields to refer to: by clicking the several dropdowns, you’ll be asked to select between one or two entries. For the Question, please select **Question**. For the Answer, please select **Answer**. For the Categories, choose **Categories**. For the Order, select **Order**, and for the Last modified, choose **Last Modified**.

{% hint style="info" %}
Once you’re done with this quick configuration, please always remember to click on **Republish** to save what you’ve done right now.
{% endhint %}

The web part is composed of the following elements:

* A **number of boxes containing the questions**. Each card features a star icon which can be clicked to add the respective FAQ to the favorites list. If you click on a box, another box will appear showing the answer. This box also features a button allowing you to mark a FAQ as favorite.
* A **search bar** which allows you to quickly find FAQs.
* The **Favorites filter**, which is composed of two or three sections: the Favorite section, the All FAQs section and the Last modified section, if you have decided to show it.
* The **Categories filter**, which allows you to filter FAQs by category.

<figure><img src="/files/szehTRR24QXK1xnadlDB" alt=""><figcaption></figcaption></figure>

***

## Create FAQ categories and add new elements to the FAQ list

This section will show you how to create FAQ categories inside your FAQ list, as well as how to add new items (question-answers) to the list.

* First, click on **Site Contents**.

<figure><img src="/files/7UWe2Mtr7IHqoxmK8LDx" alt=""><figcaption></figcaption></figure>

* Then please scroll down until the **FAQ list** and click on it:

<figure><img src="/files/EFRjhvrK4wgqopJ38WOx" alt=""><figcaption></figcaption></figure>

* You’ll see an empty list, the first step is to create FAQs categories: please click on **Categories > Column Settings > Edit:**

<figure><img src="/files/4BoIiTqWpqvdsU0bLZrZ" alt=""><figcaption></figcaption></figure>

A sidebar will appear on the right side of the page.

* To add a new filter, please click on **+Add Choice**.
* Then write the filters you’d like to consider for the FAQs. Once you’re done, please click on **Save**.

<div align="left"><figure><img src="/files/UqDuEkis3e1IDbrKPIXB" alt="" width="199"><figcaption></figcaption></figure> <figure><img src="/files/XZPiJz5vtS7eyuJsd3yZ" alt="" width="196"><figcaption></figcaption></figure></div>

* Now, let’s add the FAQs, by clicking on **+New** on the top right of the page:

<figure><img src="/files/dhdvg39MW0415zQ2HZkC" alt=""><figcaption></figcaption></figure>

* Once you click the New button, a sidebar will appear on the right, with the following fields to be filled in:

<div align="left"><figure><img src="/files/zW60DjtPt7NPHntvYYv1" alt=""><figcaption></figcaption></figure></div>

* **Question**: write the question that the user will see.
* **Answer**: write the answer to the question you are asking.
* **Categories**: choose one of the categories you created earlier.
* **Order**: this field corresponds to the sorting logic. You need to fill it in if you want to set a specific display order. Also, while configuring the [Display order settings](#display-order-settings) of the web part, you need to activate the option for sorting the FAQs according to the Order field.

> For example, if you want an important FAQ to be shown first, you need to enter number 1 in the Order field.

* &#x20;**Last Modified**: indicate the date and time when you’re creating the FAQ.
* Once you’re done, please click on **Save**.

{% hint style="info" %}
You can also add new elements using the **grid view**. This allows you to copy-paste more elements as in an Excel file and save time. Once you've finished adding items to the list, don't forget to click on **Exit grid view**.
{% endhint %}

***

## Configure the Faq favorites list

The Faq favorites list requires a **specific configuration** so that users can **interact with the list** and **mark FAQs as favorites**. To learn how to configure this list, read the [dedicated guide](https://docs.intranet.ai/sharepoint-intranet/other-configurations/configuration-of-favorites-lists-and-user-lists). In particular, please refer to the **First type of configuration** section. &#x20;

{% embed url="<https://intranet.ai/>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.intranet.ai/sharepoint-intranet/components/faqs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
