=== Ultimate FAQ Accordion Plugin ===
Contributors: rustaurius
Tags: faq, faqs, woocommerce faq, faq block, faq shortcode, accordion, documentation, knowledge base, mobile faq, responsive faq
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 2.4.8
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Full-featured FAQ and accordion plugin with advanced search, simple UI and easy-to-use FAQ blocks and shortcodes.

== Description ==

Having an FAQ section or knowledge base on your site is essential to make sure you are not losing customers and to reduce your support load.

With the Ultimate FAQ plugin and its simple UI, you can quickly create FAQs and add them to your site using the included blocks, patterns or shortcodes. It works with WordPress's built-in editor as well as third-party editors like **Elementor** and is translation-ready, with many already available [here](https://translate.wordpress.org/projects/wp-plugins/ultimate-faqs/).

All this in an accordion layout that is automatically responsive and adapts your FAQs to any site!

👩‍💻 [Demo](https://www.etoilewebdesign.com/ultimate-faq-demo/) | 🌟 [Premium](https://www.etoilewebdesign.com/plugins/ultimate-faq/) | ℹ️ [Support](https://www.etoilewebdesign.com//support-center/)


### Key Features

- Add an unlimited number of FAQ entries, categories, tags and pages.
- Display your FAQs anywhere with the included Gutenberg blocks and shortcodes.
- FAQ accordion layout that automatically adapts to fit in any site and on any device.
- Works with third-party editors like Elementor.
- Easily translate FAQ entries using WPML, Loco Translate, Polylang, etc. With many translations already available [here](https://translate.wordpress.org/projects/wp-plugins/ultimate-faqs/)!
- Automatically adds FAQ and FAQPage structured data.
- Advanced FAQ and category sorting and ordering options.
- Zero coding!

[youtube https://www.youtube.com/watch?v=ULAq7e-JyL8]

### Get Set Up in No Time!

When you first activate the Ultimate FAQ plugin, it will automatically run a walk-through, which will help you create your FAQs and add them to a page.

### Google Optimized

The plugin includes full FAQPage and FAQ schema structured data markup, in LD+JSON format. So, when your page is indexed, Google will know it’s an FAQ page and can list it accordingly in search results.

### Multiple Languages? We've got you covered!

Your FAQs are created using a post type. This means it works out of the box with language plugins like WPML, Loco Translate and Polylang. There are also many community translations already available [here](https://translate.wordpress.org/projects/wp-plugins/ultimate-faqs/). And, of course, we include an up-to-date .pot for good measure, in case you like to create your own custom translations for your FAQs.

### FAQ Customization Options

We've included (in the free version!) advanced customization features that let you choose what elements show for each FAQ (e.g. categories, tags, author, date, etc.), set the order of your FAQs and categories, fine tune accordion behavior, add your own custom CSS and more!

### FAQ Statistics

Statistics and view counts are automatically enabled, so you can easily keep track of which FAQs are the most popular.

### FAQ Comments

We've included the ability for you to enable comments on FAQs, giving you a platform to communicate with your users/customers and help improve not only your knowledge base, but your overall product or service. The FAQ comments make use of WordPress's built-in comment engine, which means seamless integration and you can use WordPress's comment and moderation settings to fine tune the experience.

### Use AI to Generate FAQs

You no longer need to manually create all your FAQs. Let the plugin do the heavy lifting for you! We now offer Open AI integration, via which the plugin will automatically generate new FAQs for you. You just need to specify which page or post should be used and the plugin will automatically create the FAQ based on the content of it. You can also choose to automatically assign an FAQ to a category. You then get a chance to review the generated content before publishing it to your site. 

#### Premium AI-generated FAQs

In the premium version you will get access to create up to 20 AI-generated FAQs at a time as well as to specify multiple pages and/or posts from which the content should be pulled to generate the FAQs.

*Privacy note: The plugin sends post or page content to our server, which is forwarded to Open AI when using the AI FAQ generation feature. No other data is sent to external sources.*

### Powerful FAQ Search (Requires Premium)

Have a lot of FAQs? Our powerful search engine eliminates the need for your customers to scroll through endless FAQ entries to find the info they need.

- Add the FAQ search form anywhere on your site via block, pattern or shortcode.
- It uses asynchronous requests to search your whole database of FAQs in real time, without having to reload the page. 
- It comes with an option to display your FAQs on page load, so you can use one block for everything. No duplicates. No mess. Super easy for your users!
- Enable the **highlighting** and **auto-complete** options for an even better FAQ search experience. 

### WooCommerce FAQ Support (Requires Premium)

With our built-in WooCommerce integration, you can easily add FAQs to your product pages. 

- Adds an FAQs tab to product pages.
- Uses the same adaptive FAQ layout for seamless integration with any theme.
- Options to automatically or manually add FAQs to a product.
    - Automatically: Just create an FAQ category that matches the name of a category or product from your WooCommerce.
    - Manually: Go to the WooCommerce product edit screen and add the FAQs you want.

### Let People Submit Their Own FAQ Ideas (Requires Premium)

Want to give your customers the power to make your knowledge base better? Add an FAQ submission form anywhere on your site using the included block or shortcode, so people can give new FAQ ideas and even optionally include a suggested answer.

### Need More? We've Got You Covered with the Ultimate FAQ Premium Version!

Enhance your user experience by customizing the Ultimate FAQ plugin to your exact needs with the following premium features:

- Additional FAQ layouts
- 15 icon sets for the FAQ toggle symbol
- WP Forms Integration that automatically loads matching FAQs as people type in the form.
- Drag and drop FAQ ordering
- Social media sharing for your FAQs
- FAQ animation options
- Add custom fields to your FAQs (e.g. links, text areas, dates, files, etc.)
- SEO-Friendly FAQ pretty permalinks
- FAQ export and import via spreadsheet
- Export all FAQs to a PDF (e.g. to create a user manual)
- Advanced FAQ styling options
- FAQ labelling options

[youtube https://www.youtube.com/watch?v=fLory4igOWs]

For further information and purchasing options, please visit our **[WordPress FAQ plugin](https://www.etoilewebdesign.com/plugins/ultimate-faq/)** homepage.

### Want to Try Out the Ultimate FAQ Premium Version for Free?

We're happy to offer a free 7-day trial of the premium version of the Ultimate FAQ plugin, which you can use to test out features like the FAQ search form, custom fields and styling options!**

### Customize Your FAQs with the Included Template System

The Ultimate FAQ plugin front end is built on a series of templates that can be customized by creating your own version of the template files (to modify and/or overwrite the existing ones). This gives you a powerful and non-destructive way to customize the look and functionality to your exact needs. More info about this can be found [in our documentation](https://doc.etoilewebdesign.com/plugins/ultimate-faq/developer/). 

### For FAQ help and support

- [Ultimate FAQ documentation](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/)
- Our FAQ pages [here](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/faq) and [here](https://wordpress.org/plugins/ultimate-faqs/faq/)
- [Ultimate FAQ installation guide and information about the walk-through](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/getting-started/install)
- [Ultimate FAQ tutorial videos](https://www.youtube.com/playlist?list=PLEndQUuhlvSrNdfu5FKa1uGHsaKZxgdWt)
- [The Ultimate FAQ support forum](https://wordpress.org/support/plugin/ultimate-faqs/)
- [Our Support Center](https://www.etoilewebdesign.com/support-center/)

== Frequently Asked Questions ==

= Is there a Gutenberg block to display FAQs? =

Yes, you can search for the **Display FAQs** block. Alternatively, you'll find it in its own block category/section called **Ultimate FAQs**. 

For a complete list of FAQ blocks and their associated parameters, please see [here](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/blocks-shortcodes/).

= Is there a shortcode to display FAQs? =

Yes, you can use the `[ultimate-faqs]` shortcode. 

For a complete list of FAQ shortcodes and their associated attributes, please see [here](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/blocks-shortcodes/).

= Can I have multiple FAQ pages with different FAQs on each =

Yes. For this, we would recommend assigning your FAQs to different categories and then using the FAQ shortcode to include only the category you want on each page. For more info, see [here](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/blocks-shortcodes/ultimate-faqs-shortcode).

= How do I sort the order of my FAQs? =

The FAQ order can be sorted by title, created date or modified date. The categories can be sorted by name, slug or count. If you are using the premium version, there is also a drag-and-drop table that can be used for precise FAQ ordering. For more info, see [here](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/faqs/order).

= Can I translate my FAQs? =

Yes, the Ultimate FAQ plugin uses a custom post type and all of the strings/labels are localized in the code. For more information on plugin translation, please see [here](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/labelling/translating).

= Is the Ultimate FAQ plugin compatible with WPML? =

Yes, it uses a custom post type and taxonomies. As such, if you enable our post type in the WPML settings, you'll be able to create translations of your FAQs, categories and tags. As well, all the strings/labels are localized in the code. As such, they will be picked up by WPML's String Translation tool for easy direct translating. 

For more info on translating FAQs, please see [here](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/labelling/translating).

= The individual FAQ page isn't displaying correctly =

For the FAQ single post pages, it would be your theme that controls the look and layout. Because the FAQs are a custom post type, the single post page for FAQ posts would, by default, make use of your theme's single.php template file. If you'd like to modify the single post page for FAQs, we'd suggest duplicating your single.php file and creating one specifically for our post type, as discussed [here](https://codex.wordpress.org/Post_Type_Templates). Our post type is called **ufaq**, so you'd want to call your template file **single-ufaq.php**.

= How can I make my FAQs sharable over social media? =

On the premium FAQ settings page you can choose to link to twitter, facebook and more!

= How do I make my FAQs searchable? =

You can use the premium shortcode [ultimate-faq-search] or the premium "FAQ Search block", which displays an AJAX FAQ search form. You can use the "Auto-Complete Titles" option to have a list of all matching questions pop up when a user has typed 3 or more characters into the FAQ search field.

= How do I add FAQs to a WooCommerce product page? =

In the premium version, you can add FAQs for either a specific product or for a WooCommerce category.

For a specific product, create an FAQ category with the same name as the product, and then select that category for all of the FAQs you want included on your product page.

For a category of WooCommerce products, create an FAQ category with the same name as the WooCommerce category, and then select that category for all of the FAQs you want included on your product page.

= How do I customize my FAQs, for example, to change the font? =

You can customize the plugin by adding code to the Custom CSS box on the FAQ settings page.

You can also use the "Styling" area of the "Options" tab if you're on the premium version, which has a built-in color picker for FAQ fields and more!

= For more FAQs, help and support, please see: =

- [Ultimate FAQ documentation](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/)
- [More FAQs](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/faq)
- [Ultimate FAQ installation guide and information about the walk-through](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/getting-started/install)
- [Ultimate FAQ tutorial videos](https://www.youtube.com/playlist?list=PLEndQUuhlvSrNdfu5FKa1uGHsaKZxgdWt)
- [The Ultimate FAQ support forum](https://wordpress.org/support/plugin/ultimate-faqs/)
- [Our Support Center](https://www.etoilewebdesign.com/support-center/)

== Installation ==

1. Upload the 'ultimate-faqs' folder to the '/wp-content/plugins/' directory
2. Activate the plugin through the 'Plugins' menu in WordPress

or

1. Go to the 'Plugins' menu in WordPress and click 'Add New'
2. Search for 'Ultimate FAQ' and select 'Install Now'
3. Activate the plugin when prompted

= Getting Started =

After you activate the plugin, a walk-through will run automatically that will help you create your first FAQs and set a few key options. 

For more info on installing and activating the plugin, and on the walk-through, please see here: [https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/getting-started/install](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/getting-started/install)

= For FAQ help and support =

- [Ultimate FAQ documentation](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/)
- Our FAQ pages [here](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/faq) and [here](https://wordpress.org/plugins/ultimate-faqs/faq/)
- [Ultimate FAQ installation guide and information about the walk-through](https://doc.etoilewebdesign.com/plugins/ultimate-faq/user/getting-started/install)
- [Ultimate FAQ tutorial videos](https://www.youtube.com/playlist?list=PLEndQUuhlvSrNdfu5FKa1uGHsaKZxgdWt)
- [The Ultimate FAQ support forum](https://wordpress.org/support/plugin/ultimate-faqs/)
- [Our Support Center](https://www.etoilewebdesign.com/support-center/)

== Changelog ==

= 2.4.8 (2026-03-26) =
- Updated escaping of FAQ answer content output.

= 2.4.7 (2026-03-02) =
- Fixes for PHP warnings related to the new admin help button.

= 2.4.6 (2026-02-03) =
- New: You can now add a featured image to an FAQ and it will display on the single post page if your theme supports it.
- New: Helper button with info/support/tutorials for admin and settings pages.
- Update: Added a class to the h2 output for the FAQs heading on the WooCommerce product page.
- Fix: Linebreaks/spacing not being applied.
- Fix: WP Forms FAQs not working.

= 2.4.5 (2026-01-08) =
- Fixed issue with pagination not working in certain cases. 
- Updated the Permalink Destination option description to more clearly explain the fallback behaviour when pagination is being used.

= 2.4.4 (2025-11-19) =
- Added a new option to display a toggle icon for the category toggle feature.

= 2.4.3 (2025-10-16) =
- Fix to prevent all FAQs from being displayed if an FAQ is added to a WooCommerce product and then subsequently deleted.

= 2.4.2 (2025-09-26) =
- Fix: Tabs not displaying on WooCommerce product page when no FAQs assigned to that product.

= 2.4.1 (2025-09-23) =
- AI feature now uses GPT-5.
- Updated WooCommerce compatibility.

= 2.4.0 (2025-08-28) =
- **IMPORTANT NOTE: Significant updates have been made to the styling of several layouts, especially the "Minimalist" FAQ display style. We highly recommend, especially if you are using this display style, that you install the update on a staging environment first and test with with the updated style, especially if you have customized the layout and/or CSS.**
- Refresh of the "Minimalist" FAQ display style.
- Redesign of the plugin admin.
- Added: Option to have nested categories (i.e. sub-categories can now appear nested within categories).
- Added: New Category Tabs option (displays categories as horizontal tabs).
- Changed: It is now possible to include an FAQ search shortcode or block on the same page as a regular FAQ shortcode or block.
- Changed: Updated conditional options on the settings page, to reduce the likelihood of using conflicting styles/options and to make it cleaner.
- Fixed: Broken links in FAQs when there was highlighted search text within them.
- Fixed: FAQ search querying also being applied to other FAQ shortcodes or blocks on the same page.

[See changelog for all versions](https://www.etoilewebdesign.com/changelogs/ultimate-faqs.txt).