Skip to content
UnitTallyUnitTally Docs

Custom Pages & Pages CMS

UnitTally includes a built-in Pages CMS that lets organizations create and manage custom rich-text web pages directly on their storefront. You can publish general organization pages (such as /about, /faq, or /sponsors) or attach dedicated custom pages to specific campaigns (/c/{campaignSlug}/{pageSlug}).

Scope: Org-Wide vs. Campaign-Scoped Pages

Section titled “Scope: Org-Wide vs. Campaign-Scoped Pages”

Pages can be created at two different levels:

  • Org-Wide Pages (e.g., {slug}.unittally.app/sponsors): Visible across your entire storefront. Use org-wide pages for recurring information like board members, general FAQs, annual sponsorship tiers, or your unit’s mission.
  • Campaign-Scoped Pages (e.g., {slug}.unittally.app/c/{campaignSlug}/rules): Tied to a single active campaign. Use campaign-scoped pages for specific campaign rules, order instructions, or event details.

The Console Rich-Text Editor

Section titled “The Console Rich-Text Editor”

Custom pages are written in the UnitTally Console using a WYSIWYG rich-text editor. The editor outputs structured JSON renderable safely on the server side:

  • Formatting: Headings (H1–H3), bold, italic, bulleted lists, numbered lists, blockquotes, and links.
  • Security: UnitTally enforces strict HTML allow-listing and link validation (only http, https, and mailto protocols). Inline scripts or unapproved tags are stripped at write time to ensure XSS safety under your storefront’s Content Security Policy (CSP).
  • Navigation: Any page can be toggled to appear automatically in your storefront header navigation bar (Show in Navigation) with custom display ordering.

Media Library

Section titled “Media Library”

UnitTally includes a dedicated Media Library for each organization:

  • Image Asset Uploads: Upload image assets (PNG, JPEG, WebP) directly through the Console. Images are delivered via Cloudflare Images for high performance and automatic responsiveness.
  • Inline Image Nodes: Insert uploaded media assets directly into custom pages with custom alt text for accessibility.
  • Asset Management: Reuse images across multiple pages or delete outdated graphics without re-uploading.

Drafts & Storefront Previews

Section titled “Drafts & Storefront Previews”

Pages maintain a strict status lifecycle:

  • Draft Mode (draft): Newly created or edited pages remain in draft mode until published.
  • Admin Preview: Administrators can view draft pages directly on the live storefront using a secure, short-lived signed preview token generated from the Console. Anonymous public visitors cannot access draft pages.
  • Publishing (published): Publishing a page makes it instantly accessible on your public storefront and adds it to your storefront navigation if enabled.

Where to go next

Section titled “Where to go next”