# SW Footer Simple — AI Agent Documentation

**Module path:** `smithworks-2025/sw-modules/SW Footer Simple.module` (smithworks portal); also in master `sw-master` (SW-Dev)  
**Reference:** MODULE-FIELD-LABELING-STANDARD.md, MODULE-SETTINGS-BACKGROUND-STANDARD.md, MODULE-CONTENT-COLORS-STANDARD.md  
**Last updated:** 2026.04.22

---

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

## 1. Overview

SW Footer Simple is a global footer module with logo, navigation menu, optional CTA buttons, rich text, social icons, copyright (year + company name), simple links (e.g. Privacy, Legal, Contact), and an optional **Back to Top** button. It uses standard **Module Settings** (Style tab) for wrapper spacing (default 50px top/bottom, 25px left/right) and max width, **Module Background Settings** for background (theme color, custom, gradient, image, video; **new instances** default to **Theme Color** with the **White** swatch), **Content Colors** for **Text Color** and a single **Link Colors** control (**Theme Defaults (auto)**, **On Dark Background**, **On Light Background**) that applies to rich text links, menu links, footer links repeater, and the Smithworks attribution link, and **Module Background Video** (Content tab) when Background Option = Video.

**Other modules in the global footer:** On standard Smithworks themes, this module usually sits in the same **global footer** drag-and-drop area as optional modules such as **SW Popup Panel** or **SW CTA Popup**. Editors add those via **Edit global content** → **SW Global Site Footer**, not inside SW Footer Simple's Content tab. See **SW-Popup-Panel.txt** Section 1b or SW AI Documentation → SW Popup Panel → Site-wide: global footer.

**Copyright line (Content → Copyright Information):** **Add Copyright Line** (toggle, default on) controls whether ©, year, optional company segment, and the middle **·** before “Powered by Smithworks” show. **Show “Powered by Smithworks”** (toggle, default **on**) controls whether the Smithworks attribution link appears at all; when off, no powered-by line is output (copyright line can still show if **Add Copyright Line** is on). **Add Company Name** (toggle, default on; shown when copyright line is on) hides the name after the year when off. **Company Name** (text, optional): blank = HubSpot `site_settings.company_name` (from **Marketing → Email → Configuration → Footer addresses**—not Account defaults → Company information). Non-blank overrides the token. If Add Company Name is on but the override is blank and no email-footer name exists, nothing appears after the year.

**Where to set the fallback name:** Settings (gear) → **Marketing** → **Email** → **Configuration** → **Footer addresses** → create or edit email footer. Do this during first-time theme setup **after Brand Kit** (SW AI Documentation → First-Time Checklist → **1b. Marketing: Email footer (copyright name)**).

---

## 2. Content tab (order)

1. Custom ID, Custom Classes  
2. **Logo** — Logo Link, Logo Image (override), Alt Text. Uses brand kit logo by default.  
3. **Navigation** — Menu (HubSpot menu)  
4. **Buttons** (repeater) — Button Text, Button Link, Button Style, Button Size, Add Icon, Icon. Default: 1 item "Learn More". 10px margin left/right per button.  
5. **Rich Text Box** — group with **Content Area** (rich text) and **Content style** (Default, Large balanced, Large full-width, Small, Blockquote)  
6. **Social Icons** (repeater) — URL, Preset (Facebook, LinkedIn, X, Instagram, YouTube, TikTok, Custom), Icon Type (when Custom), Override Colors, Icon Color, Icon Hover Color.  
7. **Copyright Information** — Add Copyright Line; Add Company Name; Company Name (override text); **Show “Powered by Smithworks”** (default on). See Overview.  
8. **Footer Links** (repeater) — Link Text, Link, Add Icon, Icon (position: Left/Right/Icon Only; purpose). Default: Privacy, Legal.  
9. **Back to Top** — Enable (default ON); Override Colors; Background Color, Icon Color, Icon Hover Color. Appears after 600px scroll; centered with 10px bottom clearance.  
10. **Module Background Video** — When Style → Background Option = Video.

**Rendered order note:** In the live footer, the copyright row typically appears **between** Social Icons and Footer Links even though **Copyright Information** is listed after Social Icons in the Content tab (editor order ≈ DOM order with this intentional placement for the copyright row).

---

## 3. Style tab (order)

1. **Module Settings** — Spacing (default 50/25/50/25), Max Module Width, Module height.  
2. **Module Background Settings** — Background Option **Theme Color** with **White** as the default theme swatch (new instances).  
3. **Content Colors** — **Text Color** (footer body text); **Link Colors** (Theme Defaults (auto), On Dark Background, On Light Background) for all footer links that use Content Colors link styling.  
4. **Footer Alignment** — Alignment (left/center/right) for XL; Override Desktop/Tablet/Mobile with per-breakpoint alignment.

---

## 4. Content Colors (detail)

**Text Color:** Footer content text. Theme defaults, Primary, Secondary, Tertiary, White, Black, Dark, Light, Custom (with Custom Text Color hex). Default: Theme defaults.

**Link Colors:** Theme Defaults (auto), On Dark Background, On Light Background. Applies to rich text links, navigation menu links, Footer Links repeater items, and the "Powered by Smithworks" link. Field: `styles.content_colors.link_context`.

---

## 5. Back to Top

**Content → Back to Top:**
- **Enable Back to Top** (default ON): Floating button appears after scrolling 600px; hidden when at top. Centered with 10px from bottom. Spacer prevents covering footer content. Smooth scroll on click.
- **Override Colors:** When ON, set Background Color, Icon Color, Icon Hover Color. Default: dark background, white icon.

---

## 6. Social Icons

Presets: Facebook, LinkedIn, X, Instagram, YouTube, TikTok, Custom. **Override Colors:** When ON, custom Icon Color and Icon Hover Color. When OFF, icons follow **Style → Content Colors → Link Colors** (same token row as Privacy / Legal links). HubSpot **icon** output (Custom preset) is sized so SVG glyphs are visible; **`fill: currentColor`** keeps icon color in sync with the anchor. Social links use `text-decoration: none`.

---

## 7. Copyright Information (`copyright_information`)

- **Add Copyright Line:** Off = no ©, year, company segment, or **·** before “Powered by Smithworks.”  
- **Show “Powered by Smithworks”:** Off = no Smithworks attribution line (copyright line can still show when **Add Copyright Line** is on). Default **on**.  
- **Add Company Name:** Off = year only (no name segment) when copyright line is on.  
- **Company Name:** Optional override. Blank uses `site_settings.company_name` (email footer / Footer addresses). Non-blank overrides.

---

## 8. Footer Links (simple_link_items)

Link Text, Link, Add Icon, Icon (when Add Icon ON). Icon position: Left, Right, Icon Only. Icon Only shows only the icon; link text becomes aria-label for accessibility.
Default URLs use standard placeholder; replace with actual paths.

---

## 9. Common Tasks

- **Enable/disable Back to Top:** Content → Back to Top → Enable Back to Top  
- **Override Back to Top colors:** Content → Back to Top → Override Colors = ON  
- **Add social icons:** Content → Social Icons (repeater). Preset or Custom; Override Colors for custom icon colors.  
- **Change footer alignment:** Style → Footer Alignment  
- **Change content area text color:** Style → Content Colors → Text Color  
- **Change footer link contrast:** Style → Content Colors → Link Colors (Theme Defaults (auto), On Dark Background, On Light Background)  
- **Turn off entire copyright prefix (© year name ·):** Content → Copyright Information → Add Copyright Line = OFF.  
- **Hide “Powered by Smithworks”:** Content → Copyright Information → Show “Powered by Smithworks” = OFF.  
- **Hide company name but keep © and year:** Content → Copyright Information → Add Company Name = OFF.  
- **Override company name in module:** Content → Copyright Information → Company Name (non-blank). Blank = email footer / `site_settings.company_name`.  
- **Set fallback when override is blank:** Settings → **Marketing** → **Email** → **Configuration** → **Footer addresses** (see checklist **1b**). Not Account defaults → Company information.

---

## 10. Field paths (canonical)

- **Module Settings:** `module.styles.module_settings`  
- **Module Background Settings:** `module.styles.module_background_settings`  
- **Content Colors:** `module.styles.content_colors` — text_color, text_color_custom, link_context  
- **Footer Alignment:** `module.styles.footer_alignment`  
- **Back to Top:** `module.back_to_top_group` — enabled, override_colors, background_color, icon_color, icon_hover_color  
- **Social Icons:** `module.social_icon_items`  
- **Copyright Information:** `module.copyright_information` — add_copyright_line, add_company_name, company_name_text, show_powered_by_smithworks  
- **Simple Links (Footer Links):** `module.simple_link_items` — link_text, link, add_icon, icon (icon, position, purpose)  
- **Rich Text Box:** `module.rich_text_group` — rich_text (Content Area), content_style  
- **Copyright company name (rendered when override blank):** `site_settings.company_name` (Marketing → Email → Configuration → Footer addresses)

---

## 11. CSS classes (key selectors)

- `.sw-footer-simple` — module wrapper  
- `.sw-footer-simple__back-to-top` — fixed button (`.is-visible` when scrolled)  
- `.sw-footer-simple__back-to-top-spacer` — clearance when Back to Top enabled  
- `.sw-footer-simple__social-link` — social icon links  
- `.sw-footer-simple__social-link--overridden` — social link when **Override Colors** is on (inline icon / hover colors)  
- `.sw-footer-simple__copyright` — copyright block  
- `.sw-footer-simple__copyright-link` — "Powered by Smithworks" link (uses Content Colors link tokens)  
- `.sw-footer-simple__links` — footer links container  
- `.sw-footer-simple__link` — footer links (simple_link_items) and social anchors (for link-context styling)  
- `.sw-footer-simple__menu-link` — navigation menu links