Do you deliver to my area? Is there parking? How long does a first appointment take? The same handful of questions reach you every week by phone, email or WhatsApp, and every one of them has an answer that could have been on your website all along.
A block that is already in the editor is enough to add an FAQ section in WordPress, and an accordion from a plugin can take over if you need more styling. The harder part is choosing questions that actually save you those calls. There is also a common belief about FAQ schema and Google that leads owners to build their FAQ for the wrong reason, and it is worth clearing up before you start.
Start with the questions, not the layout
An FAQ built from guesses reads like a sales page in disguise. “Why should I choose you?” is not a question anyone asks. Before you open the editor, spend a week collecting real ones:
- Scroll back through your email, enquiry form entries and chat messages and note the questions that repeat.
- Ask whoever answers the phone which questions they are tired of.
- Note the worries people raise just before they book or buy: cost, timing, what happens if something goes wrong.
Write each question the way the customer said it, then write a direct answer. Six to ten good questions is plenty for most service pages. If you end up with thirty, that is usually a sign that some of them belong on the page itself, in the main text, rather than tucked away in an FAQ.
The simplest way to add an FAQ section in WordPress: the Details block
Recent versions of WordPress include a Details block. It shows a single line, the summary, and hides the rest until the visitor clicks it. Stack a few of them and you have a working FAQ accordion with no plugin at all.
- Open the page in the block editor and place your cursor where the FAQ should go.
- Add a Heading block above it, for example “Questions customers ask”, so the section is easy to find when scanning.
- Click the + block inserter, search for “Details” and add the block.
- Type the question into the summary line.
- Click inside the block below the summary and type the answer. You can add more than one paragraph, a list or a button inside it.
- Repeat for each question. A quick way is to select the finished Details block, open its options menu (the three dots) and choose Duplicate, then change the text.
- Preview the page on desktop and on a phone, and click every question to check it opens.
In the block settings sidebar you will find an option to show the block open by default. Leave it off for most questions. Turning it on for the first one can help if that question is the one almost everyone needs.
The Details block uses the browser’s own show-and-hide element, so it works without extra scripts and can be opened with the keyboard. The answers are part of the page’s text, which matters for visitors using screen readers and for search engines.
How it looks depends on your theme. Some themes style it neatly with an arrow; others leave it very plain. If yours looks bare, the colour and typography settings in the block sidebar may be enough, or you can group the Details blocks inside a Group block and give that a background.
If you use a classic theme or a page builder
The Details block works in the block editor regardless of whether your theme is a block theme or a classic one, because it lives inside the page content. If your pages are built with Elementor or another builder, use the builder’s own accordion or toggle element instead, so the FAQ is edited in the same place as the rest of the page.
Option 2: an accordion block from a plugin
Block collections such as Kadence Blocks, Spectra and similar plugins include an accordion block with more styling choices, icons, and often a setting to close other panels when one opens. If you already use one of these collections, use its accordion. If you do not, think twice before installing a whole block library for one FAQ; the Details block may be all you need.
The SEO plugins also offer FAQ blocks. Rank Math and Yoast SEO each include one that adds FAQ structured data to the page for you. That is convenient, but read the next section before you choose a tool for that reason.
FAQ schema: what it does now
For a while, adding FAQ structured data could make expandable questions appear under your result in Google. Google later cut that back: today the dropdowns appear mainly for a few authoritative government and health websites, and Google can change its search features again whenever it likes. For a typical small business, do not expect FAQ schema to bring those dropdowns back.
The markup is not harmful, and it still describes the page accurately. The point is simply that an FAQ should exist because visitors need it, not to carry schema. If you want to understand structured data more broadly, our guide to adding schema markup in WordPress covers the types that still matter for a business. Two rules apply whichever tool you use:
- The questions and answers in the schema must match what is visible on the page.
- Do not add FAQ schema twice. If your SEO plugin’s FAQ block adds it, do not also paste a block of FAQ code from a generator on the same page.
Writing answers people actually read
The FAQ format pushes you towards short answers, which is good. A few habits make them better:
- Answer in the first sentence. “Yes, we deliver to most of the city. The exceptions are…” beats a paragraph of background before the yes.
- Be specific where you can. If the honest answer is “it depends”, say what it depends on.
- Do not invent promises. If you cannot always call back the same day, do not write that you do.
- Link to the full page when the answer is long. An FAQ answer about your returns process can be two sentences and a link to the returns page.
- Use plain words. Write as if you were answering at the counter.
Where to put the FAQ
A single FAQ page is useful as a reference, but most questions are best answered where they come up. A question about delivery belongs on the product or service page, near the price. A question about what happens at a first appointment belongs on the booking page. Put a short FAQ of three to six questions at the bottom of each key page, and keep a general FAQ page for the rest.
Avoid copying one identical FAQ block onto every page. It repeats the same text across the site and gives the visitor nothing new on each page. If some questions genuinely apply everywhere, such as payment methods, keep them on the FAQ page and link to it. For a block you really do want in several places, a synced pattern lets you edit it once; our post on WordPress block patterns shows how.
An FAQ is usually the first of several small additions owners make, and our overview of adding features to your WordPress site helps you decide how to build the next one. The complete WordPress guide covers the rest of looking after the site.
Keeping the FAQ up to date
An out-of-date FAQ is worse than none, because visitors trust it. When something changes, such as prices, opening times or delivery areas, search your site for the old detail and update every FAQ answer that mentions it. A note in your calendar every few months to read the FAQ from top to bottom catches the rest.
Treat it as a page that grows. When a new question reaches you twice, it has earned a place.
FAQ mistakes worth avoiding
- Questions written for search engines. “What is the best plumber in [City]?” is a keyword, not a question a customer asks you.
- Hiding important information. Price, cancellation terms and anything a visitor must know should be on the page itself, not only behind a click.
- One giant accordion. Twenty-five closed questions in a row are hard to scan. Group them under small headings, such as “Booking” and “Payment”.
- Mixing two FAQ tools on one page. A builder accordion and an SEO plugin FAQ block on the same page can produce conflicting markup and two different styles.
Frequently asked questions
Can I have more than one FAQ section on the same page?
Yes, as long as each one has a clear purpose, such as one group about booking and another about payment. Give each group a short heading. If you are adding FAQ structured data, keep it to one FAQ block per page so the markup describes the page once rather than in pieces.
Will Google still read the answers if they are hidden in an accordion?
Generally, yes. The Details block keeps the answer in the page’s text even while it is closed, so search engines can read it. Still, anything a visitor must know before deciding, such as the price or a key condition, is better shown openly in the main text of the page.
Can my FAQ answers include links and buttons?
Yes. Inside a Details block you can add paragraphs, lists, links and even a Buttons block. Linking from a short answer to the full page is often the best approach. Keep buttons for the one action that answer leads to, such as booking or calling.
How do I reorder the questions later?
Select a Details block and use the up and down arrows in its toolbar, or drag it. List View, opened from the editor’s top toolbar, shows every block on the page and is easier for moving questions in a long FAQ. Preview afterwards to check each one still opens.
An FAQ block that stops opening after an update, or a page carrying two sets of FAQ markup from tools you cannot identify, is usually a small fix once you know where to look. If you would rather not dig through it yourself, our WordPress support team can help.
Next in this series: How to Display Testimonials in WordPress
