# About the Question Entries V2 API

The Question Entries API manages FAQ questions and answers in the [FAQ app](fallback::https://support.wix.com/en/article/the-wix-faq-app-an-overview). This API allows you to manage FAQ content that appears in a site's Wix FAQ widgets, helping site visitors find answers to common questions.

With the Question Entries API, you can:

- Create and manage question entries with multiple possible answer formats.
- Organize questions using categories and labels for better content structure.
- Perform bulk operations for efficient content management.

Question entries work together with the [Categories API](fallback::https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/introduction) to create a complete FAQ management system. Categories provide the organizational structure, and question entries contain the actual FAQ content and must be assigned to categories. Question entries reference the category they belong to via `categoryId`.


The Question Entries API supports 3 different answer formats to accommodate various content needs:

- **[Draft.js](fallback::https://draftjs.org/)**: Structured rich text format ideal for complex formatting and editing workflows.
- **[Rich Content](fallback::https://ricos.dev/)**: Advanced format supporting media, interactive elements, and sophisticated layouts.
- **Plain Text**: Simple text format for basic answers without special formatting.

## Before you begin

It's important to note the following points before starting to code:

- The Wix user must install the [FAQ app](fallback::https://support.wix.com/en/article/adding-and-setting-up-the-wix-faq-app) on their site.
- Question entries must be assigned to categories. Use the [Categories API](fallback::https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/introduction) to create and manage categories first.

## Use cases

- [Sync FAQ content across multiple sites](fallback::https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/sample-flows)

## Terminology

- **Question entries**: Individual FAQ content items, containing a question and its answer. The questions and answers appear in Wix FAQ widgets on a site.
- **Categories**: Themed groupings that organize question entries. For example, Shipping or Returns. Managed via the Categories API. Categories appear as sections in Wix FAQ widgets on a site, allowing visitors to browse questions by topic.
- **Labels**: Additional groupings of FAQ question entries. Labels aren't visible to site visitors, but are useful in specific contexts, such as chat bots.
- **Share links**: Direct URLs that link to specific question entries in the site's Wix FAQ widgets.

@sdk_package_setup

# FAQ Question Entries: Sample Use Cases and Flows

This article presents possible use cases and corresponding sample flows that you can support. This can be a helpful jumping off point as you plan your implementation.

## Sync FAQ content across multiple sites

You can synchronize both categories and question entries across multiple sites to maintain consistency.

To sync FAQ content across multiple sites:

1. Call the Categories API's [List Categories](fallback::https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/list-categories) method on the source site to retrieve all existing categories.

2. Add categories to target sites by calling the Categories API's [Create Category](fallback::https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/create-category) method for each category and passing the retrieved category data. Store a mapping between the source site's and target site's category IDs to use for question entry synchronization.

3. Call [List Question Entries](fallback::https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/list-question-entries) on the source site to retrieve all of the site's question entries.

4. For each question entry in the response, extract the question entry data and update the `categoryId` to match the corresponding category ID on the target site using your stored mapping.

5. Call [Create Question Entry](fallback::https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/create-question-entry) to add the updated question entries to each target site.

# Question Entries V2: Supported Filters and Sorting

The following table shows field support for filters and sorting for the question entry object:

| Field | Supported Filters | Sortable |
|-------|------------------|----------|
| `id` | `$eq`, `$ne`, `$in`, `$nin` | Sortable |
| `question` | `$eq`, `$ne`, `$in`, `$nin`, `$startsWith`, `$endsWith`, `$contains` | Sortable |
| `answer.draftjs` | `$eq`, `$ne`, `$in`, `$nin`, `$startsWith`, `$endsWith`, `$contains` | Sortable |
| `answer.rich_content` | `$eq`, `$ne`, `$in`, `$nin`, `$startsWith`, `$endsWith`, `$contains` | Sortable |
| `answer.plain_text` | `$eq`, `$ne`, `$in`, `$nin`, `$startsWith`, `$endsWith`, `$contains` | Sortable |
| `sort_order` | `$eq`, `$ne`, `$in`, `$nin`, `$lt`, `$lte`, `$gt`, `$gte` | Sortable |
| `category_id` | `$eq`, `$ne`, `$in`, `$nin` | Sortable | 

__Related content:__
[API Query Language](portalId::d1972c09-74e2-4d36-a6f2-54e3310d4ad9resourceId::8158a590-f60c-4606-9fed-16a34e275f3a*fallback::https://dev.wix.com/api/rest/getting-started/api-query-language),
[Query Question Entries](fallback::https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/query-question-entries)