# SW Form — AI Agent Reference

**Primary purpose: Standalone form module.** Use when you need only a form (with optional headings above). If the form needs to sit beside an image, video, or content block (two-column layout), use SW Pillar Section with Secondary Column = Form instead.

**Capability summary (AI):** "SW Form is a standalone form module. Use it when only a form needs to be placed. If the form needs more design elements (image beside it, content beside it, bullets, CTAs), use SW Pillar Section with Form as the secondary column."

---

**Module name:** SW Form
**Use this document when:** The user asks about the SW Form HubSpot module—what it does, when to use it vs Pillar Section, or how to configure it.

---

## SW Form vs SW Pillar Section (Form column) — When to Use Which

| Scenario | Use This Module | Why |
|----------|-----------------|-----|
| Form only; no image or content beside it | SW Form | Standalone form. Headings above form; full form styling (Form Box Settings). |
| Form beside image, video, or content (two columns) | SW Pillar Section | Set Secondary Column = Form. Form sits in one column; image/video/content in the other. |
| Form with more design elements (bullets, rich text, CTAs beside it) | SW Pillar Section | Pillar Section supports headings, bullets, Content Area, CTAs in the primary column with Form in the secondary column. |

**Rule of thumb:**
- SW Form = Form is the main focus; nothing beside it.
- SW Pillar Section (Form column) = Form needs to share the layout with image, video, or content (side-by-side).

---

## Content Tab

- Custom ID, Custom Classes
- Headings (above form) (repeater) — Heading, Size, Display Size, Color, Custom Color, Align; Override Text Alignment (Tablet/Mobile); Override Display Size (Tablet/Mobile); Override Padding
- Form — HubSpot form picker
- Module Background Video (last group) — visible when Style → Module Background Settings → Background Option = Video

---

## Style Tab

- Module Settings — Spacing, Max Module Width, XL/LG/MD/SM Module Height cascade
- Module Background Settings — Background Option (Theme Color, Custom Color, Gradient, Image, Video)
- Form Box Settings — Background Color, Override Border Radius, Border, Override Shadow, Hide Field Labels, Field Styling, Button Styling, Form Box Padding

---

## Related Modules

- SW Pillar Section — Use when form needs to sit beside image, video, or content (two-column layout). Set Secondary Column = Form.
- SW Button — CTA buttons; different purpose.

---

## Common Tasks

- Change headings above form → Content → Headings (above form)
- Change form → Content → Form (HubSpot form picker)
- Change form box background → Style → Form Box Settings → Form Box Background Color
- Change form field/button styling → Style → Form Box Settings → Field Styling, Button Styling
- Change module background → Style → Module Background Settings → Background Option
- Change spacing → Style → Module Settings → Spacing

---

## Document Version

Module: SW Form (smithworks-2025). Doc last updated: 2026-02-18. SW Form Section deprecated; migrate to SW Form (standalone) or SW Pillar Section (Form column).