---
title: WordPress Joo FAQ Advanced Documentation
description: "Complete guide to creating, customizing and publishing FAQs with Joo FAQ Advanced FREE and PRO."
url: "https://joothemes.net/wordpress-plugins/joo-faq-advanced/documentation"
category: Documentation
date: "2026-11-15 23:54:13"
author: Jacek Nadolny
ai_policy: none
x-markdown-tokens: 4918
---

## Structured Data

- **Type:** Article
- **Title:** WordPress Joo FAQ Advanced Documentation
- **URL:** https://joothemes.net/wordpress-plugins/joo-faq-advanced/documentation
- **Author:** Jacek Nadolny
- **Published:** 2026-11-15T23:54:13+01:00
- **Modified:** 2026-11-16T19:44:56+01:00


# WordPress Joo FAQ Advanced Documentation

JOOTHEMES · WORDPRESS PLUGIN DOCUMENTATION
Joo FAQ Advanced
Create and publish organized FAQ sections with categories, search, eight visual themes and automatic FAQPage structured data.

Explore PRO↗

FREE + PROWordPress 6.0+PHP 8.0+8 themes

ANSWER

CREATE · ORGANIZE · PUBLISHFAQ SETREUSABLE · EASY TO FIND

01 Shared editor02 Categories and search03 Appearance & themes04 PRO tools

CHOOSE YOUR EDITIONOne powerful FAQ editor. More tools with PRO.FREE is a fully usable, standalone edition for creating and publishing FAQs. PRO builds on the same editor and adds data import and export, full backups, Schema.org file export, custom CSS, and license and update management.

FREEStandalone edition
Create and publish FAQsThe essential tools for creating, organizing, customizing and publishing FAQ sets.

- Unlimited FAQ sets, up to 500 questions per set
- Question and answer editor, categories and aliases
- Search and filtering
- Eight themes and appearance settings
- Shortcode and direct links to questions
- FAQPage JSON-LD
- Translated admin and frontend interface

PROFREE edition extension
Transfer, back up and manageEverything in FREE, plus advanced tools for importing, exporting and restoring FAQ data, as well as managing your PRO license and updates.

- JSON import and export
- Append or replace questions on import
- Full backup and restore
- Schema.org file export
- Custom CSS for authorized users
- License and Download ID management
- Plugin updates via the Joothemes update service

Explore Joo FAQ Advanced PRO↗

Important: FREE and PRO are two editions of the same plugin. Do not install them as separate plugins. To upgrade, replace the installed FREE package with the PRO package without uninstalling the plugin first.

GETTING STARTEDInstallation and setupThe plugin requires WordPress 6.0 or later and PHP 8.0 or later.

01Installing FREE
1. In your WordPress dashboard, go to Plugins → Add New.
2. Select Upload Plugin, then choose the plugin ZIP file.
3. Install and activate Joo FAQ Advanced.
4. Open Joo FAQ Advanced in the admin menu.
5. Click Add FAQ to create your first set.

02Upgrading from FREE to PRO
1. Download the Joo FAQ Advanced PRO package.
2. Go to Plugins → Add New → Upload Plugin.
3. Upload the PRO ZIP file.
4. Choose the option to replace the currently installed plugin.
5. When WordPress finishes replacing the plugin, confirm that Joo FAQ Advanced Pro is active.
Do not uninstall FREE manually before upgrading. Both editions use the same plugin identity and database structure, so your FAQ sets, questions, answers, settings and shortcodes are retained.

Tip: Create a standard website backup before upgrading to PRO. After replacing the package, check a few FAQ sets on the frontend.

FEATURES SHARED BY FREE AND PROCreating and managing FAQ setsEach FAQ set is independent and can have its own questions, categories, search options and appearance settings.

01Independent FAQ setsCreate as many FAQ sets as your website needs. For example, you might use separate sets for products, services, shipping, payments or customer support. Each set can contain up to 500 questions.
02Questions and answersAdd, edit, delete and reorder questions. Answers can contain supported HTML formatting and images. Incomplete entries can be saved as unpublished and completed later.
03Categories and aliasesAssign each question to a category and edit its URL alias. Categories make it easier to filter a set, while aliases provide direct links to individual questions.

FAQ set editor
The editor is organized into horizontal tabs. On smaller screens, you can scroll the tab bar horizontally. You can also navigate between tabs with the Left and Right Arrow keys, or jump to the first or last tab with Home and End.
QuestionsSettingsAppearanceSearchChange history
In PRO, the Questions tab also provides JSON import and export controls. FREE includes the full question editor but does not include data-transfer tools.

Publishing individual questionsEach question has its own publication status. Disabling a question removes it from the public FAQ and from the generated FAQPage structured data. The question remains in the set and can be published again at any time.

FRONTENDDisplaying FAQs on your websiteUse a shortcode to display an FAQ set on your website. You can reuse the same set on multiple pages or place several different sets on a single page.
SHORTCODECopy[faq_advanced id="123"]Replace 123 with the ID of your FAQ set.

Where can I use the shortcode?Place the shortcode in any WordPress area that supports shortcodes, including:
- A Shortcode block in the block editor.
- The Classic Editor.
- Theme areas that support shortcodes.
- Compatible page builders and widgets.

Multiple sets on one pageAdd a separate shortcode for each set. Each instance receives unique HTML IDs, allowing multiple sets to work independently on the same page.[faq_advanced id="123"][faq_advanced id="456"]

Direct links to questionsWhen direct links are enabled, visitors can copy a link to an individual question. Opening that link takes them to the relevant FAQ entry and expands its answer. This is useful in emails, instructions, help articles and product documentation.Example URL fragment: #faqa-wp-123-question-alias. The actual fragment is generated from the FAQ set ID and the question alias.
Accordion behaviorFirst answer openSingle-open modeMultiple answers openExpand / collapse allCSS animationReduced motionChoose whether the first answer should be open when the page loads. In single-open mode, opening one answer closes the previously opened answer. Turn this option off to let visitors expand several answers at once. You can also enable controls that expand or collapse all answers in the set.The expand and collapse animations adapt to the height of the answer, including long text and images. If a visitor has enabled the reduced-motion preference in their operating system or browser, answers open and close without animation.

FINDING INFORMATIONCategories and searchCategories and search can be used separately or together, helping visitors narrow down a long list of questions and find relevant answers more quickly.

Categories
- Display categories as a dropdown or as tabs.
- Filter questions by category.
- Show the number of questions in each category.
- Choose from three tab styles: Classic, Pills and Underline.

Search
- Search both questions and answers.
- Choose partial-word or whole-word matching.
- Highlight matching terms in the results.
- Optionally open answers that contain matching results.
- Set a custom search-field placeholder and no-results message.
- Display the number of currently visible questions.

Tip: For larger FAQ sets, use categories to organize topics and search to find specific wording. Both features can be enabled at the same time.

APPEARANCE & CUSTOMIZATIONMatch FAQs to your websiteEvery FAQ set can have its own theme and display settings. Joo FAQ Advanced includes eight ready-made themes and controls for fine-tuning the appearance.

Appearance settings

Alignment and widthSet the FAQ block alignment to left, right or center, and define its maximum width.
ColorsCustomize the colors of questions, answers, backgrounds, active items, icons and search highlights.
TypographyAdjust question and answer font sizes, font weights and line heights.
SpacingControl the spacing between questions, internal padding and corner radius.
IconsChoose the expand/collapse icon: plus, arrow, chevron, circle or caret.
Heading structureChoose a heading level from H2 to H6 to maintain a logical heading hierarchy on the page.

The Joothemes theme is selected by default for new FAQ sets. The way color controls are applied can vary by theme. Use the reset option to restore the default appearance settings.

PROCustom CSSPRO includes a custom CSS field for users with the WordPress edit_css capability. The CSS is validated and sanitized before it is used. The field has a 50,000-byte limit. External resources, url() and @import are blocked.Explore PRO↗

STRUCTURED DATAFAQPage structured data and Schema.org exportBoth FREE and PRO can add FAQPage structured data to your website. PRO also lets you download the data as a separate Schema.org JSON file.

FREE + PROFAQPage JSON-LD on the pageWhen the Schema option is enabled for a set, the plugin generates JSON-LD from its published questions and answers. If a page contains multiple FAQ sets, their data is combined into one output. A set used more than once on the same page is included only once.
PROSchema.org file exportPRO lets you download FAQ data in Schema.org JSON format. This export contains published questions only and does not include the full set configuration, so it is not a substitute for a backup.

Note: Structured data helps search engines interpret page content. It does not guarantee rich results or a particular search ranking. The WordPress theme should call `wp_footer()` correctly.

ADDITIONAL CAPABILITIESPRO-only featuresPRO adds tools for importing and exporting FAQ data, restoring set configurations, working with supported data formats and managing your license and updates.
PRO 01JSON importImport questions and, when included in the file, supported FAQ set settings from JSON. Before the imported data is applied, the plugin validates the JSON syntax, record structure, field types and applicable limits.Supported input formats include:
- A JSON array containing question records.
- A JSON object containing an items or faq_items collection.
- A Schema.org FAQPage object containing mainEntity.
- The documented mod_faq_advanced.backup data structure.
Standard WordPress JSON records must use the English field names question, answer and category. The optional fields are alias and published. Localized field names are not accepted in this format.
PRO 02Three import modesAppend questionsAdds the imported questions to the end of the existing list. The current set settings are retained.Replace questionsReplaces the existing question list with the imported questions while keeping the current set settings.Restore full backupRestores the questions and supported settings contained in the backup file.The Replace and Restore modes require confirmation. After reviewing the imported data, click Publish or Update to save the changes.
PRO 03Full backupA full backup includes all questions and answers, their categories and aliases, each question’s publication status, and the FAQ set settings. Disabled questions are included as well, so you can restore content that was being prepared for publication.You create a backup manually for each FAQ set. This feature does not replace a full backup of your WordPress website.
PRO 04Import limits and security500questions per set5 MBmaximum JSON file sizeHTML in answers is sanitized with WordPress’s wp_kses_post() function. Script elements and iframes are not supported. Your hosting environment may impose a lower upload limit than the plugin’s 5 MB limit.
PRO 05License and updatesPRO includes a dedicated License and Updates screen. From this screen, you can save your Download ID, review your license status and expiry date, check for new versions, and download eligible updates.
- View your current license status and expiry date.
- View the installed version and the latest available version.
- Manually check for updates.
- See a license and update status bar on Joo FAQ Advanced Pro admin screens.
- Download update packages after the license has been successfully verified.
Managing the license and updates requires the WordPress manage_options and update_plugins capabilities. The saved Download ID is not exposed in the page HTML. Leaving the field blank keeps the existing key; to remove it, you must explicitly select the removal option.The plugin can detect that a newer version is available even when the license is expired. However, downloading an update package requires successful verification of the Download ID and license.

LOCALIZATIONInterface languagesThe plugin package includes translations for both the WordPress admin interface and the public-facing FAQ. German translations include regional variants for Germany, Austria and Switzerland, with formal and informal forms. Portuguese is available in Brazilian and European variants. No separate language plugin is required.
PolishEnglishGermanJapaneseSpanishFrenchPortuguese (Brazil)Portuguese (Portugal)ItalianDutch
WordPress admin languageThe WordPress admin interface follows the language selected in the user’s profile under Users → Profile → Language.Website languageThe public-facing FAQ follows the website language selected under Settings → General → Site Language.
Translations cover the plugin interface, including menus, tabs, fields, buttons, help text, validation messages and frontend search controls. Your questions, answers and category names are your own content and are not translated automatically. For a multilingual website, create a separate FAQ set for each language.

DATA & SECURITYStorage, permissions and visibilityJoo FAQ Advanced uses WordPress APIs and security mechanisms for user permissions, data storage and content sanitization.

Data storage
- FAQ sets, questions, answers and settings are stored in the WordPress database.
- Deactivating the plugin does not delete sets from the database.
- Deleting the plugin files does not delete the stored data.
- Sets are deleted through the Trash in the WordPress dashboard.

Access control
- The plugin uses dedicated WordPress capabilities to control who can create, edit, publish and delete FAQ sets.
- Administrative write operations are protected with WordPress nonce checks.
- The Custom CSS field in PRO is available only to users with the edit_css capability.
- The PRO license and update settings require the manage_options and update_plugins capabilities.

Public visibility: The shortcode displays only published sets that are neither private nor password-protected. Drafts, trashed items and password-protected sets are not rendered publicly. Disabled questions are also excluded from FAQPage JSON-LD.
Content and external servicesThe plugin does not include an AI content generator and does not send FAQ questions or answers to an external AI service. FAQ content and settings are stored in your WordPress database. The frontend does not depend on jQuery or Bootstrap and does not load assets from third-party CDNs.

SUPPORTTroubleshootingThis section covers common issues and the checks you can perform before contacting support.

The FAQ does not appear on the page
1. Check that the set is published.
2. Make sure the shortcode contains the correct set ID.
3. Check that the set contains questions enabled for publication.
4. Make sure the insertion location supports WordPress shortcodes.
5. Clear the page cache, caching plugin and CDN cache, if used.

Changes are not visible after savingClick Publish or Update to save the set. Then clear your website cache and, if applicable, your CDN cache. If you use CSS or JavaScript optimization, make sure it is not serving an outdated copy of the plugin files.
A direct link does not open the correct questionCheck that direct links are enabled and that the question has an alias. Copy the link again from the public FAQ. If the alias changes, an older URL may no longer point to the current question.
FAQPage JSON-LD does not appear in the page sourceMake sure the Schema option is enabled in the FAQ set settings and that your WordPress theme calls the standard wp_footer() hook. The page must also contain a published FAQ set with at least one published question.
I cannot see the import and export optionsImport and export are PRO-only features. Check which edition is active and confirm that the PRO package replaced FREE rather than being installed as a separate plugin.
I cannot access the menu or edit FAQ setsCheck the user’s WordPress role and capabilities. FAQ set management uses dedicated Joo FAQ Advanced capabilities. Access to PRO license and update settings additionally requires manage_options and update_plugins.
JSON import failsMake sure the file contains valid JSON, is no larger than 5 MB and uses one of the supported data structures. A single FAQ set can contain no more than 500 questions. Your web host may enforce a lower upload limit.

FAQFrequently asked questions about the plugin

Is FREE a trial version?No. FREE is a standalone edition, not a trial. You do not need to purchase PRO, enter a license key or create an account. You can continue creating and publishing FAQ sets without a time limit.
How many FAQ sets and questions can I create?There is no fixed limit on the number of FAQ sets you can create. Each set can contain up to 500 questions.
Can I use one FAQ set on multiple pages?Yes. Add the same shortcode to each page where you want the FAQ to appear. When you update the set, the changes are reflected everywhere that shortcode is used.
Does FREE generate FAQPage JSON-LD?Yes. Both FREE and PRO can generate FAQPage JSON-LD on your website. Downloading a separate Schema.org JSON file is a PRO-only feature.
What does PRO add?PRO adds JSON import and export, options to append or replace questions during import, full backups and restore, Schema.org file export, custom CSS for authorized users, and license and update management.
Will I lose data when upgrading from FREE to PRO?No. When you upgrade by replacing the installed FREE package with PRO, your FAQ sets, questions, answers, settings and shortcodes are retained. Do not uninstall FREE manually before installing PRO.
Does the plugin translate questions and answers?No. The translations apply to the plugin interface, not to the FAQ content you enter. On a multilingual website, create a separate FAQ set for each language.
Does the plugin use AI?No. The plugin does not include an AI generator or connect to an AI service. You can prepare questions and answers using your preferred tools and then paste the content into the editor.

COMPARISONFREE vs. PRO: feature comparisonCompare the two editions at a glance. Green badges mark features included in the edition; coral badges identify features that require PRO.

| Feature | FREE | PRO |
| --- | --- | --- |
| Unlimited FAQ sets | ✓Included | ✓Included |
| Up to 500 questions per set | ✓Included | ✓Included |
| Questions, answers, categories and aliases editor | ✓Included | ✓Included |
| Categories, filtering and counts | ✓Included | ✓Included |
| Question and answer search | ✓Included | ✓Included |
| Direct links to questions | ✓Included | ✓Included |
| Eight themes and appearance settings | ✓Included | ✓Included |
| Shortcodes and multiple sets per page | ✓Included | ✓Included |
| FAQPage JSON-LD on the page | ✓Included | ✓Included |
| Translated interface | ✓Included | ✓Included |
| JSON import | PRO only | ✓Included |
| JSON backup export | PRO only | ✓Included |
| Append or replace questions on import | PRO only | ✓Included |
| Full backup and settings restore | PRO only | ✓Included |
| Schema.org file export | PRO only | ✓Included |
| Custom CSS for authorized users | PRO only | ✓Included |
| PRO license and update management | PRO only | ✓Included |

READY TO GET STARTED?Organize your FAQs. Help visitors find the answers they need.Start with FREE, then upgrade to PRO when you need data import and export, backups, custom CSS or license-managed updates.Get FREE↗Explore PRO↗

QUICK NAVIGATIONOn this pageFREE or PRO?InstallationFAQ editorDisplaying FAQsCategories & searchAppearanceStructured dataPRO featuresLanguagesData & securityTroubleshootingFAQFeature comparison↑ Back to top
Joo FAQ Advanced · Documentation EN · Version 1.0.15Back to top ↑
