<img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id=1375001637486124&amp;ev=PageView&amp;noscript=1">
  • Internacional:+1 (716) 869-4410
  • Cel y WhatsApp:+1 (809) 498-3195
  • milca@weareavanzia.com

FAQ | Frequently Asked Questions Accordion

Setup and customization guide. Last updated: November 15, 2026

A HubSpot CMS module by Avanzia Consulting SRL. This guide explains how to install the module, add your questions, choose a layout and customize the design.

Overview

The module adds a frequently-asked-questions section to a HubSpot page. It has an optional eyebrow label, a heading with highlighted words, an introduction text, an optional image and an accordion of questions and answers. The introduction can sit beside the questions (Side layout) or above them (Top layout), and in the Side layout it can stay in view while visitors scroll.

Requirements and compatibility

  • A HubSpot account that lets you edit website pages, landing pages or blog templates. The module can be added to website pages, landing pages, blog posts and blog listing templates.
  • No third-party account, no external library and no external script. The module runs entirely inside your page.
  • It uses standard HTML, CSS and JavaScript. It was tested in current Google Chrome on desktop and with Chrome's mobile and tablet emulation. Other browsers are expected to behave the same, but they were not part of the tests.
  • The default font (Poppins) is loaded by HubSpot through the module's font fields and can be changed. If your theme defines a primary color and fonts, the module can follow them.

Availability and installation

Availability: this module is not available in the HubSpot Template Marketplace yet. Installation from the Marketplace will be available once the listing is published. Until then, this page describes how the module will work.

Once the listing is published:

  1. Install the module from the HubSpot Template Marketplace into your account.
  2. Open a page in the editor, choose Add module and search for FAQ.
  3. Drag the module where you want the section. You can add it more than once on the same page; each copy is independent.

The default content is sample text. Replace it with your own before publishing.

Add and edit questions

Select the module and open the Content tab, then the Questions list.

  • Add: use the add button. A section holds from 1 to 40 questions.
  • Edit: click a question to change its question text and its answer. Answers accept rich text (bold, links, lists and so on).
  • Reorder: drag the handle next to a question.
  • Remove: delete a question from its edit panel.
  • Icon (optional): each question can show an icon or an image. Choose the icon type per question and turn on Show question icons in the Styles tab.

Heading and introduction

  • Eyebrow label: a short label above the heading. It can be switched off.
  • Heading and highlighted text: to color part of the heading, type those exact words in Highlighted text. They must match the heading exactly, including capital letters and spaces.
  • Introduction text: rich text below the heading. It can be switched off.
  • Image (optional): shown below the introduction. Add alternative text for accessibility.

Layouts: Side and Top

Choose the layout in Layout › Introduction layout.

Side layout

The introduction is in one column and the questions in the other. By default the introduction is on the left; Text column position moves it to the right. Vertical alignment (top or center) applies when the sticky introduction is off.

Top layout

The introduction is centered above the accordion. You can set the introduction's maximum width, the accordion's width and the gap between them.

Some options appear only for the layout they apply to. On tablet and mobile screens (up to 980 px wide) both layouts become a single column, with the introduction first and the questions below.

Sticky introduction

In the Side layout, Sticky introduction keeps the introduction in view while visitors scroll through the questions. It stops at the end of the section.

  • Sticky introduction: turn it on or off.
  • Sticky top offset: the distance in pixels from the top of the screen (0 to 400). If your site has a fixed header, set the offset to at least the height of that header so the introduction is not hidden under it.

Sticky positioning applies only to the Side layout and only on screens wider than 980 px. It is not used in the Top layout or on tablet and mobile.

Behavior

  • Questions open on load: how many questions start open (0 to 30).
  • Open one question at a time: when on, opening a question closes the others.
  • Show question numbers: shows 1., 2., 3. before each question.

Customize the design (Styles tab)

All styling is done in the editor, without editing code. The groups are:

  • Text: fonts for the eyebrow, heading, introduction, questions and answers; heading size on mobile; the color of the highlighted text; the eyebrow label background.
  • Section and layout: section background, section spacing, container width, gap between text and accordion, text column width and image corner radius.
  • Question items: gap between questions, backgrounds (closed and open), border width and color, corner radius, shadow, inner spacing, and the colors of the numbers and the plus/minus symbol.
  • Question icons: icon color, size, box size, box color and corner radius.
  • Keyboard focus: the color of the focus outline.

Each instance of the module keeps its own styles, so two FAQ sections on one page can look different.

Accessibility

  • Every question is a real button. Its open or closed state is exposed to assistive technology.
  • Closed answers are hidden from keyboard focus and from screen readers.
  • Keyboard: Tab moves to a question; Enter or Space opens or closes it; Arrow Up and Arrow Down move between questions; Home and End go to the first and last question.
  • A visible focus outline is shown, and you can change its color.
  • Animations are switched off for visitors who have set their system to reduce motion.
  • If JavaScript is not available, all answers are shown.
  • The default colors meet WCAG AA contrast. If you change colors, check the contrast of your own choices.

Troubleshooting

The introduction is not sticky

  • Check that the layout is Side and that Sticky introduction is on.
  • Sticky works only on screens wider than 980 px.
  • If your theme or page wraps the section in an element that hides overflow, the browser cannot keep the introduction in place. Check with your theme's settings or developer.
  • If the introduction hides under your header, increase Sticky top offset.

The highlighted words are not colored

The text in Highlighted text must appear exactly in the heading, with the same capitals and spaces.

An option I need is not visible

Some Layout options belong to one layout only. Switch Introduction layout to see the options for the other one.

All answers are open, or nothing animates

Answers are all shown when JavaScript is unavailable, and animations are off when the visitor's system requests reduced motion. Both are intended.

The font is not the one I expected

Fonts are set per text element in Styles › Text. Choose the font you want for each element.

I cannot add more questions

A section holds up to 40 questions. Use a second instance of the module for more.

Support

Avanzia Consulting SRL handles reports of errors in this module, that is, cases where it does not work as described in this guide, in line with the obligations that apply to Marketplace listings. Write to hola@weareavanzia.com and include the page address, your browser, the steps to reproduce the problem and, if possible, a screenshot.

Support does not include custom changes or personalization of the module, setup work on your site, or general support. No response times are guaranteed.

Related