Public Pages

Public Guild Pages

🌐 English · Deutsch

/public/<guildId> is a public showcase page for a server — reachable without login. It lets a community present itself (rules, links, leaderboards, whatever the owner writes) on a clean page under the bot's dashboard domain.

How it works — opt-in by convention

The gateway exposes no anonymous per-guild data, so the page only ever renders content the bot owner explicitly published through Custom Pages with public visibility. A guild opts in purely by slug convention:

Slug	Role
guild-<guildId>	The showcase page itself — its title and Markdown body become the page content.
guild-<guildId>-*	Additional public pages (e.g. guild-123-leaderboard) — listed as sub-pages below the showcase.

Example: to enable a public page for guild 123456789, create a public custom page with the slug guild-123456789 in /pages. Done — /public/123456789 is live immediately.

If no such page exists, visitors get a friendly empty state; logged-in users additionally see the exact opt-in slug to create (anonymous visitors are not shown internals).

Security model

• Public reads only. Anonymous requests fetch nothing auth-gated — only the public page list and public page bodies. Visibility is re-checked on the full page record before rendering (defence in depth).
• Safe Markdown. Content goes through the same XSS-safe Markdown renderer as all custom pages — raw HTML is escaped.
• Member enrichment. If the visitor is logged in and a member of the guild, the page adds the live server name, icon and member count (via core.guild_detail, membership enforced by the gateway). Anonymous visitors simply don't get that block.

Related pages

• Custom Pages — creating the pages that power this
• Authentication — public vs. member-gated data
• API & Gateway — the pages.* methods