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

# Heading Widget

> Organize dashboards with simple section headers

<Frame>
  <img src="https://mintcdn.com/scalegp/3SJ3nurBJCdCWISt/images/v5/evaluation-dashboards/widget-types/heading/heading-widget-result.png?fit=max&auto=format&n=3SJ3nurBJCdCWISt&q=85&s=52e17b4dbd8da2638158460bc7a72867" alt="Heading Widget Example" width="2484" height="1294" data-path="images/v5/evaluation-dashboards/widget-types/heading/heading-widget-result.png" />
</Frame>

## When to Use

Use heading widgets to:

* Divide dashboard into logical sections
* Label groups of related widgets

## Configuration

### Required Fields

<ParamField body="title" type="string" required>
  The heading text to display
</ParamField>

<ParamField body="type" type="string" required>
  Must be set to "heading"
</ParamField>

**No Query or Config Required**: Heading widgets simply display the title as a styled header.

## Creating in the UI

<Steps>
  <Step title="Open Widget Creator">
    From your dashboard, click "Add Widget" and select "Heading"
  </Step>

  <Step title="Enter Heading Text">
    <Frame>
      <img src="https://mintcdn.com/scalegp/3SJ3nurBJCdCWISt/images/v5/evaluation-dashboards/widget-types/heading/heading-widget-form.png?fit=max&auto=format&n=3SJ3nurBJCdCWISt&q=85&s=867c6a081f35170d9a128b2fd8417cb5" alt="Heading Widget Creator" width="2484" height="1578" data-path="images/v5/evaluation-dashboards/widget-types/heading/heading-widget-form.png" />
    </Frame>

    Type the heading text in the title field (e.g., "Overview Metrics")
  </Step>

  <Step title="Create Widget">
    Click "Add" to add the heading to your dashboard

    <Frame>
      <img src="https://mintcdn.com/scalegp/3SJ3nurBJCdCWISt/images/v5/evaluation-dashboards/widget-types/heading/heading-widget-result.png?fit=max&auto=format&n=3SJ3nurBJCdCWISt&q=85&s=52e17b4dbd8da2638158460bc7a72867" alt="Created Heading Widget" width="2484" height="1294" data-path="images/v5/evaluation-dashboards/widget-types/heading/heading-widget-result.png" />
    </Frame>
  </Step>
</Steps>

## Heading vs Markdown

### Use Heading When:

* You only need a simple text header
* You want consistent dashboard styling
* You're organizing multiple short sections
* Simplicity is preferred

### Use Markdown When:

* You need formatted text beyond a header
* You want to include links, lists, or tables
* You're providing detailed context or instructions
* You need multiple paragraphs of content

## Related Documentation

* [Markdown Widget](./markdown) - For rich text content
* [All Widget Types](./overview) - Compare widget types
* [Getting Started](../getting-started) - Dashboard organization tips
* [API Reference](/reference/v5/evaluation-dashboards) - Programmatic heading creation
