Back to FAQ
FAQ

Searchable FAQ Accordion

#faq

Live preview

Source code

html
<div class="container py-5">
  <h2 class="text-center fw-bold mb-3">Help Center</h2><input class="form-control form-control-lg mb-4" placeholder="🔍 Search questions...">
  <div class="accordion" id="faqS">
    <div class="accordion-item">
      <h2 class="accordion-header"><button class="accordion-button" data-bs-toggle="collapse" data-bs-target="#f1">How do I install Bootstrap?</button></h2>
      <div id="f1" class="accordion-collapse collapse show" data-bs-parent="#faqS">
        <div class="accordion-body">Add the CDN link in your HTML head, or install via npm: <code>npm install bootstrap</code></div>
      </div>
    </div>
    <div class="accordion-item">
      <h2 class="accordion-header"><button class="accordion-button collapsed" data-bs-toggle="collapse" data-bs-target="#f2">Do components work offline?</button></h2>
      <div id="f2" class="accordion-collapse collapse" data-bs-parent="#faqS">
        <div class="accordion-body">Yes, once you download the Bootstrap CSS/JS files locally.</div>
      </div>
    </div>
    <div class="accordion-item">
      <h2 class="accordion-header"><button class="accordion-button collapsed" data-bs-toggle="collapse" data-bs-target="#f3">Can I customize colors?</button></h2>
      <div id="f3" class="accordion-collapse collapse" data-bs-parent="#faqS">
        <div class="accordion-body">Yes — override Bootstrap SASS variables or use utility classes.</div>
      </div>
    </div>
  </div>
</div>
How to use this faq

Add it to your project in three steps

  1. Copy the HTML from the Source code tab above and paste it inside your <div class="container"> wrapper.
  2. Make sure the Bootstrap 5 CDN CSS and JS are linked in your <head> and before </body>. Any CodeShikhi component assumes Bootstrap 5.3+ is already loaded.
  3. Swap the placeholder text, links, and images for your own content — the layout, spacing, and responsive behaviour stay intact.

The Searchable FAQ Accordion block is fully responsive and works on every screen from 320 px phones to 1440 px+ desktops without additional CSS.

Accessibility checklist

Ship it accessible by default

  • Use semantic HTML landmarks — <header>, <nav>, <main>, <footer> — so screen readers can navigate your page.
  • Give every image an alt attribute (empty alt="" if it's decorative).
  • Label icon-only buttons with aria-label and keep focus outlines visible.
  • Maintain a contrast ratio of at least 4.5:1 for body text against its background.
  • Test the faq with Tab / Shift+Tab and Enter — every interactive element should be reachable.
Step-by-step customisation

Make it match your brand

  1. Change the colour palette by overriding Bootstrap CSS variables: --bs-primary, --bs-body-bg.
  2. Adjust spacing with utility classes such as py-5, gap-4, and mt-lg-5 — no custom CSS required.
  3. Swap the typography by loading a Google Font in your <head> and setting --bs-body-font-family.
  4. Replace stock images with brand assets. Keep dimensions similar to avoid layout shift.
  5. Preview at multiple breakpoints (mobile, tablet, desktop) and tweak column spans if content wraps awkwardly.

Need the full theory? Read our Bootstrap 5 Technical Introduction Guide for grid, breakpoints, and Sass customisation in depth.

About the Searchable FAQ Accordion faq

This faq is part of the free CodeShikhi (কোড শিখি) Bootstrap 5 library — a growing collection of copy-paste website building blocks curated for learners and freelance developers. Every block is written in clean, semantic HTML with Bootstrap utility classes, keeps custom CSS to the minimum needed, and works without any build step. Use it as a starting point and adapt the markup, colours, and content to fit your project's brand and audience.

If you spot a bug, want a new variation, or would like to contribute an improvement, reach us via the contact page — we ship updates weekly based on community feedback.

Detailed Technical Breakdown

Detailed Technical Breakdown: Searchable FAQ Accordion

Browser compatibility & standards

The Searchable FAQ Accordion faq is authored against Bootstrap 5.3, which drops legacy Internet Explorer support and targets modern evergreen engines — Chrome, Edge, Firefox, Safari, and all Chromium-based mobile browsers. Because the markup relies exclusively on the standard CSS features that ship with Bootstrap (Flexbox, CSS Grid, CSS custom properties, and the responsive breakpoint system), you can safely deploy this faq to any browser released in the last five years without polyfills. If you need to support very old WebKit or Samsung Internet builds, load the standard Bootstrap 5 CSS from the official jsDelivr CDN — the bundled autoprefixer output already covers those vendor prefixes.

Performance impact

Performance-wise this block is intentionally light. The HTML payload for a typical Bootstrap faq is under 4 KB gzipped, and it shares the same Bootstrap CSS/JS bundle you are already loading — meaning the marginal cost of adding it to a page is effectively zero KB on repeat visits. There is no JavaScript framework runtime, no hydration cost, and no client-side data fetching. The only images referenced are placeholders you will replace with your own assets; when you do, serve them as WebP or AVIF, add explicit width and height attributes to prevent layout shift (CLS), and lazy-load anything below the fold with loading="lazy". These small changes typically move Lighthouse Performance scores from the mid-80s into the 95+ range on both mobile and desktop.

Utility classes used

The faq leans on Bootstrap's utility-first classes to stay declarative: spacing utilities (p-*, m-*, gap-*), the flex helpers (d-flex, align-items-*, justify-content-*), the grid system (container, row, col-lg-*), typography helpers (display-*, lead, text-*), and colour utilities that resolve to Bootstrap CSS variables such as --bs-primary, --bs-body-bg, and --bs-border-color. Because everything is expressed as utilities you can re-theme the entire faq by overriding a handful of CSS variables at the :root level — no Sass recompile required.

Exact customisation steps

  1. Copy the source HTML from the tab above and paste it inside your <body>. The outer <div class="container"> wrapper is already included so the faq sits on the Bootstrap grid.
  2. Replace the placeholder headings and paragraphs with your own copy. Keep heading levels in order (h1h2h3) so screen readers and search engines can parse the document outline.
  3. Swap any <img> tags for your brand assets. Match the original aspect ratio to avoid layout shift, and always fill in a meaningful alt attribute.
  4. Retune the palette by overriding CSS variables::root { --bs-primary: #4f46e5; --bs-body-bg: #ffffff; }. All utility colour classes update automatically.
  5. Test at each Bootstrap breakpoint — sm (576 px), md (768 px),lg (992 px), xl (1200 px), xxl (1400 px) — using your browser's device toolbar, and tweak column spans if long content wraps.
  6. Ship it with the standard Bootstrap 5 CDN in the <head> and the JS bundle before the closing </body>. No build step required.
Technical & Performance Integration Guide

Technical & Performance Integration Guide — Searchable FAQ Accordion (FAQ section)

When and why to use this FAQ section

An FAQ block answers real objections and is one of the few components that can win a rich result in Google Search. Bootstrap's accordion keeps a long list scannable while preserving keyboard operability, provided you leave its data attributes intact.

Accessibility & ARIA attributes

Each question must be a <button> inside a heading element (Bootstrap's .accordion-header h2 pattern), carrying aria-expanded and aria-controls. The answer panel gets role="region" and aria-labelledby pointing back at the button. This is what lets a screen-reader user jump question to question by heading. Do not replace the buttons with <div>s — you would lose Enter/Space activation and focus order.

Performance notes for this pattern

Keep all answers in the HTML rather than fetching them on expand: the text is tiny, it is crawlable, and it avoids a network round trip on interaction. Accordion animation is a height transition, which forces layout — if you have more than about 20 items, disable the collapse animation on low-end devices with prefers-reduced-motion.

Three customisation tricks

  • Add FAQPage JSON-LD mirroring the visible questions and answers to become eligible for rich results.
  • Leave the first item open (.show plus aria-expanded="true") so the section never looks empty.
  • Use data-bs-parent to keep only one panel open at a time, or omit it to allow multiple.

Mistakes to avoid

  • Marking up questions that are not visible on the page in JSON-LD, which is a structured-data violation.
  • Answers of one sentence — an FAQ should genuinely answer the question.

More designs in this section