Title

Title is the heading and display primitive on the theme typescale. Use it for heroes, section titles, and any line that belongs in the document outline.

size controls appearance (display, 1–6); render chooses the actual element. Default root is span, so outline-bearing headings need an explicit render={<h2 />} (or the level the page structure requires). Visual size and semantic level stay independent on purpose: a quiet h1 with a smaller size is valid when SEO needs one page title but the layout calls for a quieter look.

Layout controls (lineHeight, align, maxWidth, wrap, whiteSpace, trim) mirror Text at heading densities. Default wrap is pretty; use wrap="balance" on short multi-line heads that need even line lengths, and whiteSpace="nowrap" for single-line metrics. Fluid viewport clamp is on by default for ordinary heading steps — see Typography for the foundation gate.

When to useCopy Anchor Link

• Page heroes and section or subsection headings
• Display lines that still need a semantic heading tag
• Short marketing titles that need even line lengths (wrap="balance")

When not to useCopy Anchor Link

• Body, helper, or caption copy → Text
• A line that must grow or shrink to fill a band → FitText
• Truncating a title inside a fixed card chrome → wrap with ClampText
• Long-form heading and block rhythm → Prose

RelatedCopy Anchor Link

• Text — body-scale running copy
• FitText — fit-to-width display
• ClampText — row-limited truncation
• Prose — heading-aware article rhythm
• Typography — scale, fluid gate, and tokens

Common examplesCopy Anchor Link

Semantic page titleCopy Anchor Link

A page hero with a visual size preset and render={<h1 />} plus wrap="balance" for even rag. Keep supporting sentences on Text underneath.

Visual size vs semantic levelCopy Anchor Link

The document outline and the visual preset do not have to match. A quieter size on h1 still marks the page title when the layout should not shout.

Ask your agentCopy Anchor Link

Audit every heading on this screen — hero as the main page title, sections as h2, subsections as h3, without skipping levels. Supporting sentences stay as body copy underneath.