# 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.

## HubSpot video and file uploads (plans and limits)

This module offers **video** options that may use **HubSpot Video**, **Video from files** (File Manager), and/or **external embed** (YouTube, Vimeo, etc.), depending on the field.

- **HubSpot Video** (the built-in videoplayer / Marketing video library): Typically requires **HubSpot subscription features** for hosted video. If the option is missing or blocked, confirm your **hub type and tier** in HubSpot's product and pricing documentation.
- **Video from files**: Uploads use the **File Manager**. On **Content Hub Free** and similar tiers, HubSpot commonly applies a **per-file upload size limit (often 20 MB)** and account storage limits. **Compress** the file, reduce resolution, or use **External embed** if upload fails or the file exceeds the limit.
- **External embed**: Paste a supported **URL** (for example YouTube or Vimeo). This path usually does not require HubSpot's hosted video product.

HubSpot's limits and SKUs change over time—**verify current rules for your portal** in HubSpot's help center.

---

## 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
- Resubmit cooldown (optional) — Enable (default off), Cooldown (minutes) 1–1440, Message while waiting (richtext), Content style (same typography choices as SW Image & Text; default Large balanced), Separate cooldown per module instance (default on for new instances). **Requires** the selected form’s HubSpot **On submission** action to be **Show thank you message** (inline confirmation in the page). If the form **redirects** after submit, the visitor leaves before that inline state appears in the DOM — **redirect flows are not supported** for this feature; use inline thank you if you need cooldown. Uses browser **localStorage**.
- 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-04-02 (Master **2026.04.02.10.29** — Resubmit cooldown + redirect limitation). SW Form Section deprecated; migrate to SW Form (standalone) or SW Pillar Section (Form column).