Start building FAQ sections everyone can read


Hi again ๐Ÿ‘‹

If you're new here - hello, and welcome!

If you've not yet checked out davedavies.dev - head there to find loads of free videos and articles on how to make your product pages available for everyone. And then let me know what you want to hear more about!

This week...

I was looking at FAQ sections. These do a lot of heavy lifting on your product pages, and if you get them right they're a real winner.

Shipping. Returns. Sizing. What's actually in the product. The FAQ section is often where the last objection gets handled before someone buys.

However - so many FAQ areas are built using outdated methods, which actively stop keyboard users from reaching them - and can even stop the SEO crawlers. Not great...

The usual old approach is a custom component. A

that hides and shows a panel when you click it. It looks good, it animates nicely, and it works perfectly with a mouse. And that was fine, in its time.

But a

doesn't respond natively to either a mouse or a keyboard. So your devs have to add custom JavaScript to make it work. Now with JavaScript added in, it looks great - and works great with a mouse - but did anyone check with a keyboard? Possibly not.

So what does great look like?

You can now use the widely supported

/ elements.
These are built into the browser and supported everywhere - and it looks something like this:

That's the whole thing. Opening, closing, keyboard support, screen reader support: the browser does all of it.

What that gives you is really worth understanding, even if you're not part of the dev team, because it stops so many things from going wrong.

Every custom accordion not using the

/ pattern needs a small pile of JavaScript that someone has to write, and test, and then maintain. Every one is a fresh chance to forget the keyboard.
has none of that. There is no JavaScript to write and no ARIA to get wrong, because there's almost nothing to build.

It's also plain HTML, so the content inside is there in the page whether it's open or not. This keeps the crawlers happy too!

Ask whoever looks after your site whether your FAQs use

and . It's a question with a yes or no answer.

But here's the catch...

You're still responsible for making sure the content inside the FAQs is still accessible!

The element gives you the mechanics, and is accessible out of the box - but... it doesn't automatically fix the content for you.

Here's a great example I found this week. Nc'nean whisky distillery uses the

/ pattern perfectly (their hover state could have a better colour contrast, but lets move past that for now). Each "accordion" has great information - helping you decide if this is the right purchase for you.

They have loads of awards - however - in the awards accordion, every award logo has an empty alt text - essentially removing it from the accessibility tree. When someone using a screen reader opens the awards accordion, they'll hear nothing. Sometimes this is useful on images, but it's probably not what the company wants here.

What to ask this week?

Can someone reach your FAQ panels with a keyboard? If they're built with

and , yes. That one's answered for you.

Can someone read what's inside them? Open each panel and look for anything that isn't text. Award logos. Certification badges. Star ratings. Size charts as images. If it's a picture, it needs words attached, or for some of your customers it isn't there at all.

The information is there on the page. Now make sure everyone can access it.

Talk soon,
Dave

600 1st Ave, Ste 330 PMB 92768, Seattle, WA 98104-2246
โ€‹Unsubscribe ยท Preferencesโ€‹

davedavies.dev

Actionable tips to remove the hidden accessibility barriers currently stopping your customers from completing their purchase. Join the top 6% - watch your sales grow, and your brand reputation shines.

Read more from davedavies.dev

Hi Reader ๐Ÿ‘‹ It's been really interesting reading everyone's responses to the SOEA 2026 report. One thing which surprised many people is this question: Should more traffic mean a more accessible product page? You might expect the busiest stores to be in better shape. After all, they have the most to lose. The State of Ecommerce Accessibility 2026 groups stores by traffic ranking. Here's the share of product pages in each group with at least one critical accessibility issue: Ranked 500,000โ€“1...

Built with Kit

Hi Reader ๐Ÿ‘‹ Exciting week - The State of Ecommerce Accessibility 2026 is out. What is the State of Ecommerce Accessibility report? Over the summer I scanned 59,400 Shopify and WooCommerce product pages, one per store, all from stores ranked among the world's top million websites. The headline stat is this: 64% of product pages had at least one critical accessibility issue. Overall, 96% failed at least one automated accessibility check. And if you've been reading my newsletters for a while,...

Hi again ๐Ÿ‘‹ If a customer clicks "Add to basket" on your best-selling product without choosing a size and nothing is added, what happens next? Perhaps the size selector turns red, or an error message appears on the page. The problem is that neither of these guarantees that your customer knows what went wrong. Questions to ask yourself: Is colour the only clue that something went wrong? A customer with colour blindness may miss that change and not realise anything needs their attention. My...