--- title: "Custom pages on ComStack" description: "Vibe-coded Astro/HTML pages with total layout freedom — what custom pages are, what they can do, and where the hard boundaries sit." url: "https://comstack.ai/docs/custom-pages/" --- ## What this is A **custom page** is a ComStack page whose entire body is your own code — a complete Astro component or HTML document, uploaded as one opaque `body_source` with the `upload-custom-page` tool. The platform never rewrites it: what you author is what ships (Astro's standard build applies; plain-HTML bodies are round-tripped through a standards-compliant parser). Layout, styling, animation, and interactivity are entirely yours. Custom pages exist for everything a structured markdown template can't express: landing pages, product launches, interactive demos, calculators, animated showpieces, brand-heavy marketing pages. The rest of the site — docs, blogs, FAQs — belongs to `knowledge` pages and their templates; see [Knowledge vs custom pages](/docs/mcp/page-types.md). ## What is possible Treat a custom page as a blank canvas with a fast CDN behind it: - **Total layout freedom** — your own grids, sections, hero treatments, typography. No template structure is imposed on the body. - **Animation** — CSS keyframes, scroll-driven effects, transitions, SVG animation. Inline ` ``` Upload it, publish, and `/es/` (plus every other configured locale) renders the same layout with translated strings substituted into the marker positions. Two fully annotated walkthroughs — minimal and advanced — are in [Recipes](/docs/custom-pages/recipes.md). ## Common errors - **Marker mistakes** — unmarked strings stay untranslated; malformed markers reject the upload with character offsets. See [Translation](/docs/custom-pages/translation.md). - **`wrong_tool_knowledge_page`** — the slug already belongs to a markdown page. Pick another slug or edit that page with `update-page`. - **Lighthouse failures** — heavy images, render-blocking scripts, missing alt text. The fixes are mechanical; see [Quality gates](/docs/custom-pages/quality.md). The full catalogue with exact messages and fixes: [Troubleshooting](/docs/custom-pages/troubleshooting.md). ## Related - [Author a custom page](/docs/custom-pages/authoring.md) — the contract and the loop, end to end - [Translation](/docs/custom-pages/translation.md) — markers, `translatable_strings`, `canonical_slug` - [Quality gates](/docs/custom-pages/quality.md) — Lighthouse, performance and AEO expectations - [Troubleshooting](/docs/custom-pages/troubleshooting.md) — every rejection and its fix - [Recipes](/docs/custom-pages/recipes.md) — annotated minimal and advanced examples - [Example gallery](/docs/custom-pages/examples.md) — live pages built the way these docs teach