Ballad
Feature

Landing pages

Permanent answers to the questions buyers keep asking (for a segment, a use case, a comparison, an integration), plus pages for ads and launches, rewritten as a diff when your positioning moves.

~6 min7 sections/for · /use · /vs · /integrations

Articles are written once and age. A landing page is different: it's a permanent answer to a question buyers keep asking (is this for someone like me?, how does it compare to X?, does it work with the tool I already use?), and it should change whenever your positioning does.

Ballad writes those pages, keeps them in step with what you now say, and proposes a rewrite as a diff when something moves.

The six types

The type lives on the collection, and the collection's slug is the route prefix, so pages land at readable URLs on your own domain:

TypeWhere it livesWhat the page covers
Segment/for/technical-foundersThe situation in the reader's words, what the product does for it by job, proof, one ask
Use case/use/launch-weekThe moment, how the product handles it step by step, what it produces, proof, one ask
Comparison/vs/acmeWho each is for, what each does well, where they differ as a table, when to pick which. The alternative can be a competitor or another way of doing it, like hiring an agency
Integration/integrations/slackWhat connects, what flows each way, setup in three steps
Ad landing/go/free-first-postWhere a paid click lands: the ad's promise in its own words, what you get, proof, one ask. Never indexed
Launch/launch/slack-appOne page for a launch week: what launched, what it does, how to try it, proof, one ask

The shape of each is fixed in code rather than left to a prompt, so a comparison page always has the comparison table and never wanders.

Where a page comes from

Four doors, and every one produces a proposal rather than a published page:

  • The site audit. A coverage finding ("the positioning promises a page for agencies and the site doesn't have one") turns into a page of the right type when you press Write it.
  • The plan. Adding a segment or a competitor can carry a follow-on proposal for the matching page; removing one proposes unpublishing it.
  • You. Start one from the collection in Content.
  • An agent. propose_page with a type and a subject.

How a page is written

A page is written only from what Ballad already holds about you: your positioning, your product and its real feature names, battlecards for a comparison, customer proof that carries consent, and your site map for what to link to. There's no research pass and no invented specifics.

The drift check runs at write time, as a gate: a page that contradicts your current positioning is never offered for review in the first place.

Pages speak in the brand voice by default, with your own voice appearing only inside quoted proof. A segment page that reads better in the first person can be switched.

They stay current

This is the part that makes a page different from a post. When a segment is added or dropped, an offer changes, the one-liner is reworded, or a competitor's weekly drift check finds they've moved, the affected pages are proposed for a rewrite as a diff: what would change, and why.

A page never auto-applies, whatever your trust setting. There will be dozens of posts and a handful of pages, and a handful earns a look.

Rendering them on your site

Pages need one catch-all route added once. After that, a new page collection Ballad creates later needs nothing from you:

// lib/ballad.ts
import { createSitePages } from '@balladlabs/next/pages';
export const pages = createSitePages(ballad, { publisher });

// app/[...slug]/page.tsx
export const generateStaticParams = pages.generateStaticParams;
export const generateMetadata = pages.generateMetadata;
export default pages.Page;

The full wiring, including the combined revalidate route and the capability check Ballad uses to know your site can render pages, is in Set up your Next.js blog. If your site reads the content API but doesn't have the catch-all yet, Ballad shows the install step instead of proposing pages.

On your own CMS, pages work too: Write it drafts the page as usual, and once you approve it Ballad gives you the finished page with a suggested address to paste in. You tell it the live address, and that's the one used for the sitemap, citations and the page's numbers.

Pages have no index and no feed, carry WebPage structured data (FAQPage where a section is questions), and a page built as an ad destination is marked noindex and kept out of your sitemap.

How they're judged

Two numbers, not traffic:

  • Conversion from the page itself, per page, through the beacon.
  • Whether AI answers cite it. A comparison page is working when the weekly check sees you named for a question where a competitor used to be.

Next

Next guideCustomer interviews and case studies