Skip to main content
whitep4nth3r logo

11 Feb 2022

2 min read

How to build an HTML-only accordion — no JavaScript required!

You don't need JavaScript to build accordions! Use HTML only and just four lines of code.

⚠️ This post is over two years old and may contain some outdated technical information. Please proceed with caution!

If you've been watching my Twitch streams lately, you'll know I'm currently rebuilding, redesigning and reimagining the full experience — and I'm trying to do this with as little JavaScript as possible. And whilst building the table of contents for the new blog page layout, I discovered a way to build an accordion with no JavaScript in just four lines of code! Let's take a look!

Use the HTML details element

To build the markup for an HTML accordion, use the <details> element. Use a <summary> tag to provide the title for the accordion. Add your content, and you're done!

<summary>Section title</summary>
<p>Here is the content!</p>

Load the open accordion by default

By default, the <details> element loads in a closed state, and I always prefer to not hide content from readers when the page loads. We can load the accordion open by default by adding the open attribute to the <details> element. Perfect!

<details open>
<p>Here is the content that is open by default!</p>

Readers can click to close the accordion to minimise clutter if they so wish — especially when on a mobile device.

A video showing the clicking of the table of contents that is opening and closing.

Browser support and accessibility

At the time of writing this article, there's full modern browser support for the details element as reported by, apart from Internet Explorer (obviously!) and Opera.

I also confirmed that the <details> element is keyboard-accessible in Chromium, Firefox and Safari. Tab to the element and use space or enter to open and close.

Further reading

If you're curious, you can view the source code that creates the full table of contents. Read more about the details element on MDN and have fun building with HTML!

Like weird newsletters?

Join 209+ subscribers in the Weird Wide Web Hole to find no answers to questions you didn't know you had.


Salma is looking at you, with a rather large smile. She's pointing across herself up to her left, with a very tatooed arm. She's wearing a black shirt and black rimmed glasses.

Salma Alam-Naylor

I'm a live streamer, software engineer, and developer educator. I help developers build cool stuff with blog posts, videos, live coding and open source projects.