SW Breadcrumbs — AI Agent Reference

Module name: SW Breadcrumbs
Module path: smithworks-2025/sw-modules/SW Breadcrumbs.module (smithworks portal); master sw-master (SW-Dev)
Reference: MODULE-SETTINGS-BACKGROUND-STANDARD.md, MODULE-CONTENT-COLORS-STANDARD.md, MODULE-FIELD-LABELING-STANDARD.md
Last updated: 2026.05.20

Use this document when: The user asks about breadcrumb navigation on blog posts or site pages, BreadcrumbList schema, trail modes (Auto, Blog automatic, Manual, Website menu), global breadcrumb settings, Home/Blog labels, or placing breadcrumbs above the blog hero.

================================================================================
1. OVERVIEW
================================================================================

SW Breadcrumbs is a **standard (non-global) module** — drag it into any DnD area on site pages, landing pages, or blog templates. Configure **per page** (or per template instance). It outputs an accessible ordered list (`<nav aria-label="Breadcrumb">`) and, on the **blog automatic** path, optional **BreadcrumbList** JSON-LD that matches the visible trail.

**Blog post (automatic):** Home → Blog name (from blog settings or **Blog label override**) → Current post title (not linked).

**Blog listing (automatic):** Home → Blog name (current page).

**Website pages:** When **Trail mode** is **Auto** or **Website (navigation menu)** and **Navigation menu** is set, the trail follows HubSpot `menu(id, "breadcrumb")` (plus optional Home prefix from **Home label** / **Home link**).

**Manual:** Home + repeater rows (**Label**, **Link**); on blog singles the post title is appended as the current page.

================================================================================
2. CONTENT TAB
================================================================================

- **Enable Module** — master toggle (replaces removed “Hide” trail mode).
- **Custom ID**, **Custom Classes**
- **Home label** (default Home)
- **Home link** (default site root / company domain)
- **Blog label override** — optional; when empty uses blog public title
- **Trail mode** — Auto (blog + website) | URL path (website) | Blog (automatic) | Manual | Website (navigation menu)
- **URL path settings** (when URL path) — **Path root** (e.g. `/faqs`); **Root segment label** (e.g. `FAQs`). Builds Home → root → middle URL segments (linked) → current **page name**. Blog content still uses blog automatic.
- **Navigation menu** — HubSpot menu for website breadcrumb trail (required for website mode; used in Auto when not on blog)
- **Manual trail items** (repeater) — **Label** (`trail_label`), **Link**; visible when Manual
- **Emit BreadcrumbList schema** — JSON-LD on blog automatic path (default on)

================================================================================
3. STYLE TAB
================================================================================

1. **Module Settings** — Module Outer Spacing (wrapper), Module Inner Spacing (`__inner`), Max Module Width, Module Outer background width
2. **Module Background Settings** — Module Outer / Module Inner backgrounds and borders (inner border override off by default)
3. **Content Colors** — Text color, Link context (theme link styling)
4. **Breadcrumb design** — Separator (chevron, slash, etc.), Link style (default / underline / no underline), Text size

**Defaults (new instances):** Outer padding top 0, right 25, bottom 10, left 25; inner background white at 0% opacity; inner border override off.

**Per-page instances:** Each dragged module has its own settings. Changing theme field defaults does **not** update existing page modules — use **Reset to default** on the module instance if needed.

================================================================================
4. TEMPLATES
================================================================================

**SW Blog Single Post** includes `{% module "sw_breadcrumbs" %}` above **SW Blog Post Hero** (template default). On other pages, drag **SW Breadcrumbs** from Add modules into the desired section, or add `{% module %}` in a template.

Do **not** nest inside `sw-site_header.html` global partial.

================================================================================
5. COMMON TASKS
================================================================================

- **Show breadcrumbs on blog posts** — **SW Blog Single Post** includes the module by default; set **Trail mode** to Auto or Blog (automatic) on that template instance (or per post if overridden).
- **Change “Blog” segment label** — **Blog label override** or edit blog name in HubSpot blog settings.
- **Site page trail from main nav** — **Trail mode** Auto or Website; pick **Navigation menu** that matches site hierarchy.
- **Custom intermediate pages** — **Trail mode** Manual; add repeater rows between Home and (on posts) auto-appended title.
- **Turn off schema only** — Disable **Emit BreadcrumbList schema** (visible trail can remain).
- **No trail on a page type** — **Enable Module** off on that template’s instance, or omit module from template.

================================================================================
6. RELATED
================================================================================

- **SW Header Simple** — site header (separate from breadcrumbs).
- **SW SEO Schema** partial — Organization / WebSite JSON-LD (do not duplicate BlogPosting).
- BlogPosting JSON-LD — HubSpot native on blog posts; do not add a second BlogPosting block from this module.

================================================================================
Document version: 2026.05.27.15.16 (module Master version number)