> ## Documentation Index
> Fetch the complete documentation index at: https://anvil.servicetitan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Typography

> Clear and consistent typography plays a key role in making data easy to scan, compare, and understand. This section outlines the font styles, sizes, and spacing rules used across different layouts, ensuring visual hierarchy, legibility, and alignment with the overall design system. All text should use be Anvil Typography tokens and reflect the hierarchy of the overall page.

<Card title="Anvil Typography guidelines" icon="link" href="/docs/web/foundations/typography" arrow="true" cta="Click here">
  Read Anvil's in-depth typography guidance
</Card>

## 1. Headline Guidelines

**Keep it concise:** Titles should summarize the main insight or takeaway from
the visualization.

General text recommendation:

* Headline - Medium or Small depending on page hierarchy
* Foreground/default

## 2. Subtitle

Subtitles should be visually secondary to the headline.

General text recommendation:

* Body text - default
* Foreground/subdued

### 3. Axis Label Text

Axis label is the descriptive text next to a chart’s x- or y-axis that explains
what the axis represents, such as units, categories, or metrics. It helps users
interpret the data accurately and should be clear, concise, and consistently
styled.

General text recommendation:

* Eyebrow text - small or medium depending on page hierarchy
* Foreground/subdued

### 4. Legend Label Text

Legend label is the text used within a chart’s legend to identify what each
color, shape, or line represents. It maps visual elements to data categories,
helping users quickly understand and differentiate between series or groups in
the visualization.

General text recommendation:

* Eyebrow text - small
* Foreground/subdued

### 5. Direct Labeling

There are three primary approaches for applying direct labeling in charts, each
offering varying levels of visibility and user interaction depending on the
complexity of the data.

1. Direct labeling - Background/default at 80% with 4px padding all around
2. Above labeling - Recommend Eyebrow/small text
3. Hover-based labeling - Utilize Anvil’s popover or tooltip component

<Columns cols={3}>
  <img src="https://mintcdn.com/servicetitan/X7UCc5xRXSxfS9Y-/images/docs/web/data-visualization/accessibility/accessibility-direct-labeling.png?fit=max&auto=format&n=X7UCc5xRXSxfS9Y-&q=85&s=5d7d19cd98e9a892e1e90b530b1c0d35" alt="A bar chart with direct labeling (#1)" width="424" height="756" data-path="images/docs/web/data-visualization/accessibility/accessibility-direct-labeling.png" />

  <img src="https://mintcdn.com/servicetitan/X7UCc5xRXSxfS9Y-/images/docs/web/data-visualization/accessibility/accessibility-above-labeling.png?fit=max&auto=format&n=X7UCc5xRXSxfS9Y-&q=85&s=6cd3f3a0188c315b96a20eaa3b5a2542" alt="A bar chart with above labeling (#2)" width="424" height="756" data-path="images/docs/web/data-visualization/accessibility/accessibility-above-labeling.png" />
</Columns>

<Card title="Questions? Challenges?" icon="link" href="https://servicetitan.enterprise.slack.com/archives/C0881LFTGDR" arrow="true" cta="Click here">
  Contact the Visual Design team on the #ask-vizd channel
</Card>
