# SW Privacy Notice — AI Agent Reference

**Module name:** SW Privacy Notice  
**Use this document when:** The user asks about the SW Privacy Notice HubSpot module—cookie/privacy bar setup, global footer placement, dismiss behavior, or how it differs from SW Popup Panel.

---

## Instructions for the AI Agent

- You do **not** have HubSpot access unless explicitly given. Answer only from this document (and other docs supplied by the user).
- When the user wants to change something, direct them to the exact **tab → group → field** names listed in the Configuration Reference.
- **Site-wide bar:** Do **not** tell typical users to open Design Manager first. Use **Edit global content** → **SW Global Site Footer** (try **Hidden modules** if needed) → add **SW Privacy Notice** in the footer drag-and-drop area **below** SW Footer Simple (and below any popup modules) → **Publish** global content. See **Section 1b**.
- **Not a marketing popup:** This module is for cookie/privacy compliance messaging with a dismiss-only **Close Button**. Do **not** recommend it for promotional CTAs—use **SW CTA Popup** or **SW Popup Panel** instead.
- Support / bug issues: point to **https://smithworks.marketing/contact**.

---

## 1. Purpose and When to Use

**SW Privacy Notice** is a **full-width bar fixed to the bottom of the viewport** that slides up after a configurable delay. Use it when:

- You need a **cookie or privacy notice** with rich text (including a link to your privacy policy)
- Visitors should **dismiss** the bar with a **Close Button** (“Got It”) without leaving the page
- The notice should appear **site-wide** from the global footer
- You want **session / suppression** behavior (once per session, optional days before showing again)

**When to choose SW Popup Panel or SW CTA Popup instead:** Promotional offers, multiple variants per page, scroll/exit triggers, thumbnails, or modal-style overlays.

**When to choose SW CTA Simple Bar instead:** An in-page CTA strip (not fixed to the viewport bottom for compliance).

---

## 1b. Site-wide — global footer (content editor)

Standard Smithworks themes use a **global footer** with a **drag-and-drop area** (often **SW Footer Modules – Add footer modules here**) containing **SW Footer Simple**. Add **SW Privacy Notice** as **another module in that same area**, typically **below** SW Footer Simple and below **SW Popup Panel** / **SW CTA Popup** if those are present.

1. Open any **live page** using the Smithworks theme.
2. Click the **footer** in the preview.
3. Choose **Edit global content** or **Open in global content editor**.
4. In the left sidebar, open **SW Global Site Footer** (check **Hidden modules** if needed).
5. In the footer layout, use **Add** / **Add row** and choose **SW Privacy Notice**. Place it **below** the main footer module and popup modules when possible.
6. Configure the module, then **Publish** global content.

**Developer note (theme authors only):** Implemented as `sw-partials/sw-site_footer.html` with a `dnd_area`.

---

## 2. Choosing Between SW Privacy Notice and Popup Modules

| Use Case | Choose |
|----------|--------|
| Cookie/privacy message; dismiss only; full-width bottom bar | **SW Privacy Notice** |
| Simple promotional popup; one variant; corner placement | **SW CTA Popup** |
| Multiple popup variants; body class matching; many positions; announcements | **SW Popup Panel** |

**Isolation from SW Popup Panel:** SW Privacy Notice uses separate CSS classes (`sw-privacy-notice`), storage keys, and a lower z-index (**9980** vs Popup Panel **9999**). It does **not** use `cta-popup-hide` or Popup Panel body-class logic—both modules can coexist in the global footer.

---

## 3. Module Structure

1. **Notice Text** — Rich text (default includes a `/privacy-policy` link).
2. **Close Button** — Dismisses the bar only (does not navigate).
3. **Timing** — Animation speed, time-delay trigger, session behavior (once per session + optional suppression days).
4. **Style** — Module Settings spacing, Module Background (theme/custom/gradient—no image/video), Content Colors.

---

## 4. Configuration Reference

### 4.1 Content Tab

**Enabled** — Toggle. When OFF, the bar never appears.

**Module ID** / **Module Class** — Optional custom HTML id and CSS classes.

**Notice Text** — Rich text for the cookie/privacy message. Default copy links to `/privacy-policy`.

**Close Button** (group)
- **Button Text** — Default “Got It”.
- **Button Style** — Theme button style (default primary).
- **Button Size** — Default small.

**Animation Speed** — Instant, Fast, Medium, Slow (controls slide-up duration).

**Timing & Triggers** (group)
- **Time Delay (seconds)** — Wait before the bar slides up (default 0).

**Session Behavior** (group)
- **Show Once Per Session** — When ON, dismissed bar stays hidden until the browser session ends.
- **Suppression Days** — After dismiss, hide for N days (localStorage); 0 = session-only when combined with session toggle.

**Accessibility** (group)
- **ARIA Label** — Accessible name for the notice region (default describes cookie/privacy notice).

### 4.2 Style Tab

**Module Settings → Spacing** — Padding around the bar content (default ~16px vertical, 24px horizontal).

**Module Background Settings**
- **Background Option** — Theme Color, Custom Color, or Gradient only (**no** image/video).
- **Border** — Optional top border (style, weight, color).

**Content Colors**
- **Text Color** — Auto (theme) or custom.
- **Link Context** — Theme link colors for rich-text links.

---

## 5. Common Tasks

- **Add site-wide privacy bar:** Follow **Section 1b**; set **Notice Text** and confirm privacy policy URL.
- **Change when the bar appears:** **Content → Timing & Triggers → Time Delay (seconds)**.
- **Hide until next visit:** **Session Behavior → Show Once Per Session** ON; set **Suppression Days** as needed.
- **Turn off temporarily:** **Content → Enabled** OFF (or remove from global footer).
- **Style the bar:** **Style → Module Background Settings** and **Content Colors**.

---

## 6. Document Version

**Module:** SW Privacy Notice. **Doc last updated:** 2026-07-06. **Finish Up:** **2026.07.06.19.07** — initial release documentation synced with master module headers.