Revision #269

## Branding & Appearance

`/admin/branding` is where you control how your community looks, what search engines see, and what analytics you collect. It's organized into 5 tabs.

For general tenant settings (members, suite, features, commerce, system), see [Site Configuration](/know/site-configuration).

---

## The 5 tabs

| Tab | What it controls |
|---|---|
| Name & Logo | Site name, logos (dark + light), favicon |
| Appearance | Default theme, theme labels, role labels, custom CSS |
| SEO | Meta defaults, GSC, Bing, robots.txt, llms.txt, AI bot allowlist, sitemap refresh |
| Analytics | GA4, GTM, Plausible, Fathom, PostHog, AdSense |
| White Label | Footer attribution toggle |

Each tab saves independently. Switching tabs keeps your changes in memory but does not commit them until you click Save in that tab.

---

## Name & Logo

- **Site name.** Shown in the navbar, page titles, and transactional emails.
- **Logo (dark).** Used on dark themes. Transparent PNG recommended, 300x80 px.
- **Logo (light).** Used on light themes. Transparent PNG.
- **Favicon.** Source PNG, 512x512 px. Multiple sizes (16, 32, 96, 192, 512) generated automatically.

---

## Appearance

- **Default theme.** The theme new visitors see on first load. Pick any of the 6 built-in themes: Dark, Green, Amber, Blue, Light, or High Contrast. Members can still switch to any of the 6 for themselves.
- **Theme labels.** Rename themes to match your brand. Example: rename "Dark" to "Night Mode".
- **Role labels.** Rename role display names. Example: rename "Moderator" to "Community Leader".
- **Custom CSS.** Inject CSS into every page. Use semantic CSS variables for theme parity. See [CSS Reference](/know/css-reference) for the variable list.

---

## SEO

The SEO tab handles every search engine and AI crawler concern. See [SEO Tab](/know/admin-branding-seo) for the deep dive.

Quick summary:

- Google Search Console and Bing Webmaster verification
- robots.txt editor (per tenant)
- llms.txt editor with auto-generation from your wiki and forums
- AI bot allowlist toggle (allow or block GPTBot, ClaudeBot, Google-Extended, and others)
- Sitemap force-refresh button
- Verification meta tags textarea (for tools that require an HTML meta tag)
- Meta title suffix and meta description defaults
- Open Graph image default

---

## Analytics

Drop in your provider IDs and the platform injects the right script tags server-side. No HTML pasting required. See [Analytics Tab](/know/admin-branding-analytics) for the deep dive.

Supported providers:

| Provider | ID format |
|---|---|
| GA4 | `G-XXXXXXXXXX` |
| GTM | `GTM-XXXXXXX` (plus noscript body fallback) |
| Plausible | Your domain |
| Fathom | 8-character site ID |
| PostHog | Project API key plus optional self-hosted host URL |
| AdSense | `ca-pub-XXXXXXXXXXXXXXXX` |

Each provider is independently togglable. Leave a field blank to disable that provider. The platform's Content Security Policy already allows all 6 analytics endpoints, so scripts load without manual CSP edits.

---

## White Label

Remove the footer attribution from your footer and outbound emails, available as a paid add-on.

Even with White Label off, your tenant's branding is your own. White Label only removes the platform attribution.

---

## Access

Requires the Tenant Super Admin role.