# Management Dashboard

The management dashboard is accessible from the administration area under **Content > FAQ** in the main navigation. It consists of two tabs: **FAQ Entries** and **FAQ Groups**.

## FAQ Groups Tab

A **FAQ group** bundles a set of FAQ entries and assigns them to one or more products via a dynamic product group. Each FAQ group has the following fields:

| Field                        | Type          | Description                                                                                                                                                                            |
| ---------------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                         | Text          | The translatable group title, rendered above the FAQ entries.                                                                                                                          |
| Description                  | Rich text     | An optional translatable description, rendered below the title. Visibility is controlled by the field "Group description visibility".                                                  |
| Dynamic product group        | Selection     | The dynamic product group that decides on which products this FAQ group is shown. Empty groups are not rendered.                                                                       |
| Group description visibility | Selection     | Per-group override for the description visibility. Allowed values: **Use plugin setting** (default), **Show**, **Hide**. The per-group value always wins over the plugin-wide setting. |
| Priority                     | Numeric input | Controls the order of FAQ groups on the product detail page. Higher values are rendered first.                                                                                         |
| Active                       | Toggle        | Inactive groups are excluded from the storefront and from CMS elements.                                                                                                                |

Each FAQ group's detail page also lists the FAQ entries that belong to the group.

### Group Limit (Free Version)

The free version of the plugin allows a maximum of **3 FAQ groups**. The FAQ Groups tab displays a progress bar showing current usage (e.g. "2 of 3 FAQ groups used"). Once the limit is reached, no new FAQ groups can be created and a message points to the In-App Purchase upgrade. Existing groups beyond the limit are still editable, but the storefront only renders the first 3 active groups.

## FAQ Entries Tab

A **FAQ entry** is a single question/answer pair belonging to exactly one FAQ group. Each entry has the following fields:

| Field        | Type          | Description                                                                                                                                                                                                      |
| ------------ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| FAQ group    | Selection     | The FAQ group this entry belongs to.                                                                                                                                                                             |
| Question     | Text          | The translatable question, rendered as the accordion header in the storefront.                                                                                                                                   |
| Content type | Selection     | Allowed values: **Text**, **Text + image**, **Text + video**, **Text + document**. Image, video and document content types require the Advanced version. The available options adapt automatically to your plan. |
| Answer       | Rich text     | The translatable answer body. HTML formatting is preserved.                                                                                                                                                      |
| Priority     | Numeric input | Controls the order of FAQ entries inside a group. Higher values are rendered first.                                                                                                                              |
| Active       | Toggle        | Inactive entries are excluded from the storefront and from CMS elements.                                                                                                                                         |

Depending on the content type, additional cards become available on the entry detail page:

* **Text + image** — pick an image from the media library, choose its position (above / below / left / right of the answer) and size, and optionally wrap the image in a link with a target.
* **Text + video** — choose YouTube, Vimeo or "Other", paste the video URL, choose the position relative to the answer, toggle YouTube's extended privacy mode, and toggle whether YouTube player controls are shown.
* **Text + document** — pick a file from the media library and add an optional title and description that are rendered next to the download button.

### Entry Limit (Free Version)

The free version allows a maximum of **5 FAQ entries**. The FAQ Entries tab displays a progress bar showing current usage. Once the limit is reached, no new entries can be created and a message points to the In-App Purchase upgrade.

In addition, the content types **Text + image**, **Text + video** and **Text + document** are only available with the Advanced version. The selection list for the content type only shows the options unlocked by your current plan.


---

# 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.premsoft.de/en/plugins/faq-products-+-shopping-experiences/management-dashboard.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.
