# SW FAQs Basic — AI Agent Reference

**Module name:** SW FAQs Basic  
**Use this document when:** The user asks about SW FAQs Basic, page FAQs with Inline Repeater or Google Sheet, FAQ accordion, empty FAQ behavior, or FAQPage schema on a page section (not the FAQ hub).

**Master version number (check `module.html`):** 2026.08.06.18.17

---

## 1. Overview

**SW FAQs Basic** is the current page-level FAQ module. It shows a visible FAQ section with optional **FAQPage** JSON-LD.

**FAQ Source (default Inline Repeater):**

- **Inline Repeater** — add Question / Answer rows in the module (best for a few page-specific FAQs).
- **Google Sheet** — load from a shared spreadsheet (marketers update without HubDB). Columns: `question, answer, tags, active, sort_order`.

**Do not use Basic for the crawlable FAQ hub** — use **SW FAQs Advanced HubDB**.  
**Deprecated:** **SW FAQs Simple** (HubDB + repeater). Prefer Basic for new page FAQs; do not overwrite Simple with Basic.

---

## 2. Content Tab

- **Enable Module** — On/off.
- **Headings** (`heading_items`) — Standard heading repeater (size, display size, color, align, overrides, padding).
- **Output FAQPage Schema** — Inline: in page HTML. Sheet: after rows load (filtered visible FAQs only).
- **Content Area** — Intro above FAQ rows.
- **FAQ Source** — Inline Repeater or Google Sheet.
- **FAQ Items** — Repeater when source = Inline Repeater.
- **Google Sheet Settings** — Share link, tag filter mode, tags (when source = Google Sheet).
- **When no FAQs** — Show empty message (default) or hide module completely. Empty message only replaces the FAQ list area (not headings/intro). Editor shows a findability note when Hide + empty.
- **Module Inner Background Video** — When Style Inner background = Video.

---

## 3. Style Tab

### Module Settings

- **Module Outer Spacing** — Default padding **0 / 25 / 0 / 25** (top/right/bottom/left).
- **Max Module Outer Width**, **Module Inner Spacing**, **Max Module Inner Width**, **Module Height** groups.

**CLS tip (Google Sheet):** If the list jumps when rows load, set **Module Height → Minimum Height** after measuring a published instance. No separate FAQ-list height field.

### Module Background Settings

Standard **Module Outer / Module Inner** pattern (same family as other SW section modules).

### Content Colors

Text and link contrast for FAQ content (not headings — headings use heading repeater colors).

### FAQ Layout Settings

- **Accordion FAQs** — Off = questions and answers visible. On = questions only; click to expand answers (Repeater and Sheet).
- **Only one open at a time** — When accordion is on.
- Spacing: FAQ content spacing, item spacing, question-to-answer gap.

---

## 4. Google Sheet

1. Make a copy of the starter Sheet (or import `sw-faqs-basic-google-sheet-sample.csv`).
2. Share: Anyone with the link → Viewer.
3. Paste Share/edit URL into **Google Sheet link**.
4. Headers: `question, answer, tags, active, sort_order`.
5. Tags in Sheet: space-separated; multi-word tags hyphenated. Module Tags field: commas or newlines.
6. Delete instructional sample rows before go-live.

---

## 5. Common Tasks

- **Page FAQs in HubSpot only:** FAQ Source = Inline Repeater; replace sample FAQ Items.
- **Spreadsheet-managed FAQs:** FAQ Source = Google Sheet; copy starter; paste Share link.
- **Accordion:** Style → FAQ Layout Settings → Accordion FAQs On.
- **Hide when empty:** When no FAQs → Hide module completely.
- **Schema:** Output FAQPage Schema On only when visible FAQs match schema content.

---

## 6. Related Modules

| Need | Module |
|------|--------|
| Page FAQ block (current) | **SW FAQs Basic** |
| Legacy page FAQ (HubDB/repeater) | **SW FAQs Simple (deprecated)** |
| FAQ hub /categories /pagination | **SW FAQs Advanced HubDB** |

---

**Doc last updated:** 2026-08-06. **Master version:** 2026.08.06.18.17.