---
name: branding
description: Customize how Anchorify share pages look — your logo, primary color, and a footer line.
---

# Branding

Every Anchorify share page can be branded with your org's logo, a primary accent color, and a short footer line. Branding is org-scoped — set it once and every share owned by your org picks it up automatically.

The "Built with Anchorify" attribution always renders, even on branded pages.

## Where to set it

Visit `/dashboard/settings/branding` (or click **Branding** from the dashboard sidebar). Only org admins see this page; project-only viewers get a 404.

The page has three sections:

- **Logo** — upload a PNG, JPG, or SVG. ≤ 256 KB.
- **Primary color** — a hex value like `#0969da`. Used as the accent color in the share-page chrome.
- **Footer line** — up to 200 characters of plain text shown above the Anchorify attribution.

Each field is independent. Save the color/footer with the **Save** button; the logo uploads on its own form.

## Logo requirements

| Field | Limit |
|---|---|
| Format | PNG, JPG, or SVG |
| Max size | 256 KB |
| Recommended height | 32–80 px (the chrome scales it down) |

The server **sniffs the file's bytes** to confirm the format — a `.png` extension on a PDF won't pass.

SVGs are scanned for hostile content before they're stored. We reject anything that contains `<script>`, on-event handlers (`onload=`, `onerror=`, …), `javascript:` URLs, embedded `<iframe>` / `<embed>` / `<object>`, `<style>` blocks, external stylesheet `<link>` tags, `<use href>` / `<image href>` pointing at remote URLs, and any `data:` URIs. If your SVG was exported from a real design tool (Figma, Illustrator, Sketch) it'll pass. Hand-crafted ones with embedded scripts won't.

To remove an existing logo, click **Remove logo** on the same page.

## Primary color

The color must be a 6-digit hex value with a leading `#` — exactly `^#[0-9a-fA-F]{6}$`. The 3-digit shorthand (`#fff`) isn't accepted; use `#ffffff` instead.

Leaving the field blank clears the override, falling back to Anchorify's default blue (`#0969da`).

The color is rendered into a CSS custom property (`--jf-primary`) on every share page owned by your org. Anywhere the chrome uses an accent color, you'll see it picked up.

## Footer line

A single line of plain text up to 200 characters, shown directly above the "Built with Anchorify" attribution.

Use it for things like:

- `Acme Co · Confidential — do not redistribute`
- `Q2 2026 client deliverable · acme.com`
- `Internal — board only`

The footer is **plain text** — markdown won't render, HTML is escaped, and links won't be clickable. This is intentional: the footer is a constraint marker, not a CTA.

## API + CLI

There is no public API for branding writes in V3 — use the dashboard. The logo upload endpoint (`POST /api/v1/orgs/:slug/branding/logo`) exists and accepts a multipart `logo` field, but it requires an admin-scoped token.

## Removing all branding

To return to default chrome:

1. Click **Remove logo** if a logo is uploaded.
2. Clear the **Primary color** input and click **Save**.
3. Clear the **Footer line** input and click **Save**.

Once all three fields are empty, share pages render with the stock Anchorify look.
