Manage FAQ Pages in Magento 2
This guide explains how to create and manage FAQ landing pages in the FAQ Manager. Pages are standalone frontend URLs where you display grouped FAQ topics with their questions. Each page has its own URL key, design theme, page layout, and SEO metadata — all translatable per store view. You don't need CMS pages; the module handles routing automatically.
Location: Content → FAQ → FAQ Pages
Page Grid
The page grid shows all your FAQ pages with columns for title, URL key, status, and timestamps. Use the grid to manage your pages.
Mass actions available:
- Delete
- Enable
- Disable
Creating a Page
Click Add New Page in the page grid.
General Fields
Is Active Toggle the page on or off. Inactive pages return a 404 on the frontend.
Title The page heading displayed on the frontend. This is translatable per store view.
URL Key
The URL path for the page. For example, a URL key of faq makes the page available at https://yourstore.com/faq. This must be unique across all FAQ pages.
Tip: Keep URL keys short and SEO-friendly. Use hyphens to separate words (e.g., shipping-faq, returns-policy).
Introduction Optional intro text displayed above the FAQ accordions. Supports the WYSIWYG editor with full formatting and CMS directives. This is translatable per store view — useful for adding localized context.
Design
Page Layout Choose the page structure:
- 1 Column — full-width, works best for most FAQ pages
- 2 Columns with Left Bar — adds the left sidebar
- 2 Columns with Right Bar — adds the right sidebar
- 3 Columns — both sidebars
Design Theme Choose how FAQs are rendered on this page:
- Hyva - Simple — clean accordion with AlpineJS, no icons
- Hyva - With Topic Icons — same as simple but displays topic icons next to headings
- Luma - Simple — vanilla JS accordion, no icons
- Luma - With Topic Icons — vanilla JS with topic icons
Tip: Pick the design that matches your active theme. Using a Hyva template on a Luma store (or vice versa) will not render correctly.
Search Engine Optimization
Meta Title The browser tab title and the title shown in search results. Translatable per store view. If left empty, the page title is used.
Meta Description The description shown in search engine results. Translatable per store view. Keep it under 160 characters for best display.
Meta Keywords Optional keywords for SEO. Translatable per store view.
Assigned Topics
This is where you connect topics to the page.
- Click Add Topic
- Select a topic from the dropdown
- Set a Position value to control the display order on this page
- Repeat for additional topics
- Use drag-and-drop to reorder, or the delete icon to remove a topic
A single topic can appear on multiple pages with different position values. Only active topics with active FAQs will display content on the frontend.
Multi-Store Translations
Title, introduction, and all SEO fields can be translated per store view:
- Switch to the desired store view using the store switcher
- Override the translatable fields with localized content
- Save the page
URL key, page layout, design theme, and assigned topics are global settings.
How Routing Works
The module registers a custom URL router. When a visitor navigates to a URL that matches an FAQ page's URL key, the router intercepts the request and renders the FAQ page — no CMS page or URL rewrite needed. This means your FAQ pages work as soon as you set a URL key and save.
Need More Help?
Documentation:
- All Help Articles - Complete documentation overview
Support:
- Contact Support - Get help from our team