How to add an FAQ accordion to your Shopify store

An "accordion" is a great way to display the FAQ to your ecommerce store, since it allows the user to quickly and easily browse your FAQ without much scrolling. And luckily, it's simple and easy to add one to your store!

Demo

This is the first question

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin tincidunt cursus eros et porta. Sed a elit tellus. Vivamus imperdiet nunc non orci faucibus, a ornare metus ultrices. Nulla vitae sapien in sapien elementum convallis.

This is the second question

Cras varius faucibus bibendum. Curabitur sit amet arcu aliquam felis ultrices rutrum. Ut auctor neque augue, in egestas elit blandit pellentesque.

This is the third question

Suspendisse ac rutrum nibh. Praesent sit amet tempor neque. Donec sed tortor felis. Nunc eu eros urna. Nunc vulputate porta ligula id mattis. In tempus massa eu risus congue commodo. Phasellus quis sapien ac lorem suscipit feugiat.

I've made this video tutorial walking you through how to add this FAQ accordion to your Shopify store. The steps are also written below.

Step 1: Download the ZIP file of necessary assets.

Click the link above to download now. Unzip it, and then upload the 3 files inside to the "Assets" folder of your Shopify template editor. If you're not sure how to do this, watch the video above and I'll walk you through it.

Step 2: Create a new page template in your Shopify template editor

You can name it whatever you want, but I recommend something simple like "faq."

Step 3: Paste the following code at the very bottom of your new page template:

[code]<script type="text/javascript" src="{{ 'jquery_accordion.js' | asset_url }}"></script>
<script type="text/javascript">
$(document).ready(function() {
$('.accordion').accordion({
defaultOpen: 'section1',
cookieName: 'accordion_nav'
});
});
</script>
<style>
.accordion {
margin: 0;
padding:10px;
border-top:#f0f0f0 1px solid;
background: #cccccc;
text-decoration:none;
color: #000;
font-size:1em;
position:relative;
}
.accordion-open {
background:#50b3da;
color: #fff;
}
.accordion-open span {
display:block;
position:absolute;
right:3px;
top:25%;
padding:10px;
}
.accordion-open span {
background:url('{{ 'minus.png' | asset_url }}') center center no-repeat;
}
.accordion-close span {
display:block;
position:absolute;
right:3px;
top:25%;
background:url('{{ 'plus.png' | asset_url }}') center center no-repeat;
padding:10px;
}
.faqpage div.container {
padding:0;
margin:0;
}
.faqpage div.container {
max-width:100%;
padding:5px 0;
}
.faqpage div.content {
background:#f0f0f0;
margin: 0;
padding:10px;
font-size:.9em;
line-height:1.5em;
}
.faqpage div.content ul {
padding:0;
margin:0;
padding:3px;
}
.faqpage div.content p {
padding:0;
margin:3px 0 10px;
padding:3px;
}
.faqpage div.content ul li {
list-style-position:inside;
line-height:25px;
}
</style>[/code]

IMPORTANT: On the new page template you just made, find a <div> tag above the {{ page.content }} tag. Add the class "faqpage" to this div. When finished, it should look something like this (if there are other words between the quotes already, that's fine--don't remove them):

[code] <div class="faqpage">[/code]

If this is confusing, watch the video above.

Step 4: Create a new page called "FAQ." Save, then change the page to the new template.

Step 5: Paste the following code into the page:

[code]<div class="accordion" id="section1">Question 1<span></span></div>
<div class="container">
<div class="content">
<p>This is the answer to question 1.</p>
</div>
</div>
<div class="accordion" id="section2">Question 2<span></span></div>
<div class="container">
<div class="content">
<p>This is the answer to question 2.</p>
</div>
</div>
<div class="accordion" id="section3">Question 3<span></span></div>
<div class="container">
<div class="content">
<p>This is the answer to question 3.</p>
</div>
</div>[/code]

Step 6: Edit the contents to your heart's content!

Need help?

If you need help installing this feature on your site, I recommend that you post a job on Storetasker. Storetasker is a platform that will connect you with vetted Shopify developers who can give you a reasonable quote for small store updates like this.

Get help from Storetasker

Note: The Storetasker link above is an affiliate link, which means that if you hire a developer to help you install this code, I'll receive a commission at no extra cost to you. If you choose to use this affiliate link, I'm grateful for your support!

Comments (87)

Leave a comment

Awesome tutorial – easy to follow instructions and exactly what I was looking for. Thanks so much!

Ann-Marie Fleming

Sadly i could not get this to work on the Simple template. It affected all of my links on the side bar and looked bad. A shame as i liked this tutorial.

Mark Griffin

Sadly i couldn’t get this working on the Simple template. It messed up the links on the sidebar and formatted them to look the same as the FAQ itself. eg plus and minus and background colour. A shame as i would have liked it.

Mark Griffin

Hi Leighton, thanks for a great tutorial. I’m having issues with the “plus” and “minus” images. They seem to function just fine, but their position is off. They are position way up to the top right of my page, almost as if the “span” is spanning a different area beyond the FAQ section. Do you have any idea how I might fix this? Thanks very much!

Keegan

Hey Leighton

Just came across this first tutorial. I’ve got to say Well Done! It was a great tutorial with nice simple, easy to follow instructions. I like the fact the video followed the on-screen instructions.

I was about to ask you a question but then figured the issue out myself!!!

The only thing I have to ask is that the accordion does not go all the way across the page. Is this something to do with my style.css settings or theme settings? We had a similar issue with text an resolved that with columns.large-12. We are using the blockshop theme!

Any idea’s would be greatly appreciated. Thanks again

Matt

Matt

Hi Dusty,

Have you managed to get this working in the end? I’m trying to achieve the same thing, but from another section in my case.

Ideally I’d like the original section to stay expanded as well, until you click another section. Then all sections except the selected one should collapse.

If you nailed it, you would be a great help if you could share what you did. Alternatively, would you know to do this Leighton?

Rolf Wemmenhove

Hi Leighton,
I loved the tutorial, but I had the same problem, but only on my FAQ page specifically. Is there anyway that I can contain the accordion script to the main body of the FAQ page only. Please check out our page if you have a chance http://brightthreadsco.com/pages/faq
Looking forward to any new shopify tutorials you may have!

Thanks so much! I appreciate any help you can offer. I plan to remove the page soon if I can’t find a resolution.

Kim Le

Hi Leighton,
I loved the tutorial, but I had the same problem, but only on my FAQ page specifically. Is there anyway that I can contain the accordion script to the main body of the FAQ page only. Please check out our page if you have a chance http://brightthreadsco.com/pages/faq
Looking forward to any new shopify tutorials you may have!

Thanks so much! I appreciate any help you can offer. I plan to remove the page soon if I can’t find a resolution.

Kim Le

Hi Kim, when I look at the page it seems to be working—the FAQ accordion is just in the main page area. If it’s still not working, go ahead and email me a screenshot at leighton@ecommercepulse.com.

Leighton Taylor

Oh, you’re referring to the sidebar, right? If so, just add “.faqpage” in front of any CSS lines that don’t already have it. For example, change “.accordion {” to “.faqpage .accordion {”, “.accordion-open {” to “.faqpage .accordion-open {”, etc. Hope that helps!

Leighton Taylor
« Previous 1 3 4 5 6 7 9 Next »

You Might Also Like

View All Articles

61: Research-based A/B testing, with Nick Disabato

April 21, 2026

Topics covered in this episode:

  • Nick D's work, writing, tips, and tools
  • Basics of A/B testing
  • How to interview your customers to learn what needs to change on your website
  • How to know when your business is ready for A/B testing
  • Most common UX and copy mistakes to watch out for
  • Common misconceptions about A/B testing

Links mentioned on the show:

Read Article

How to add an announcement bar on your Shopify store (without an app)

August 26, 2018

Read Article